This demo uses a simple Spark application as the server.
Application.javacontains the routes that interface with Stripe to create charges and receive webhook events.
You’ll new the following:
- Java 8
- Gradle
- Modern browser that supports ES6 (Chrome to see the Payment Request, and Safari to see Apple Pay).
- Stripe account to accept payments (sign up for free!)
Before getting started check that you have java installed
java -version
Set the enviroment variables for the web application. You can copy the environment variables from here
export STRIPE_PUBLISHABLE_KEY=
export STRIPE_SECRET_KEY=
export STRIPE_WEBHOOK_SECRET=
export STRIPE_ACCOUNT_COUNTRY=
export PAYMENT_METHODS="alipay, bancontact, card, eps, ideal, giropay, multibanco, sofort, wechat"
export NGROK_SUBDOMAIN=
export NGROK_AUTHTOKEN=
Use gradle to install the required dependencies by navigating to ./server/java and running:
gradle build
Use gradle to build a "fatjar" including all the apps dependencies.
gradle shadowJar
This will build a JAR in the ./build/libs directory. Running this JAR will start the Spark Web Application on port 4567.
java -jar build/libs/salesPaymentDemo-1.0-SNAPSHOT.jar
You should now see it running on http://localhost:4567/
Java is a strictly typed language. As such when deserializing objects using the Stripe Java SDK one should ensure that the API version of their account is compatible with the API version the Stripe Java SDK you are using. If you are using a new SDK and have an older API Version on your account you may see errors when trying to deserialize or use deserialized objects.
You can see which version of the Java SDK Matches which API Version here
If you want to test receiving webhooks, we recommend using ngrok to expose your local server.
First download ngrok and start your Spark application.
Run ngrok. Assuming your Spark application is running on the default port 4567, you can simply run ngrok in your Terminal in the directory where you downloaded ngrok:
ngrok http 4567
ngrok will display a UI in your terminal telling you the new forwarding address for your Spark app. Use this URL as the URL to be called in your developer webhooks panel.
Don't forget to append /webhook when you set up your Stripe webhook URL in the Dashboard. Example URL to be called: https://75795038.ngrok.io/webhook.
- Code: Mike Shaw