Stripe

Requirements:

• Stripe Account

Connecting the Platform

Go to Integrations > Stripe > Connect Platform (if not already connected). This will open a dialog with a form to fill out. Following are the fields you need to fill out to connect your Stripe account with Crosspay.

Production Secret Key

1. Make sure you’re in the “Live” mode in your Stripe dashboard, then go to Developers (at bottom left corner) > API Keys
2. In the Restricted Keys, click on “Create restricted key” if you don’t have one already
3. For How will you be using this key? select Providing this key to a third-party application
4. Provide the Name and URL for the key, like “Crosspay Access” and “https://app.crosspay.dev” respectively.
5. Select Customise permissions for this key and Create Key with the defaults.
6. After creating the key, copy the Secret Key and store it securely, as it contains sensitive information and won’t be shown again.
7. Now enter the Secret Key in the respective field in Crosspay form.

Production Webhook Secret

To allow Crosspay to receive real-time updates about purchases, subscription renewals, cancellations and other events, you need to set up a webhook in Stripe.

1. In your Stripe dashboard, go to Developers > Webhooks > Add destination
2. In the “Endpoint URL” field, enter the Webhook URL from the Crosspay Stripe form.
3. For “Events to send”, select “Select events” and choose the following events:
   • checkout.session.async_payment_failed
   • checkout.session.expired
   • customer.subscription.created
   • customer.subscription.deleted
   • customer.subscription.paused
   • customer.subscription.resumed
   • customer.subscription.resumed
   • customer.subscription.updated
   • customer.subscription.trial_will_end
4. Click on “Add endpoint” to create the webhook.
5. After creating the webhook, click on it to open its details, then copy the Signing secret and paste it in the respective field in Crosspay form.

Now Stripe will start sending real-time updates about purchases, subscription renewals, cancellations and other events to Crosspay.

Sandbox Secret Key and Webhook Secret

To setup sandbox testing, you need to repeat the same steps as above but in a Sandbox in Stripe dashboard, and use the respective Sandbox Webhook URL and Secret Key from Crosspay form. This will allow you to test the integration and make sure everything is working correctly before going live.