Stripe Connect
This is needed if you want to offer Stripe as an external payment

Requirement

Make sure, that your Stripe account is fully verified by Stripe.

Set Up

Connect Application

  1. 1.
    Open the Stripe Dashboard on https://dashboard.stripe.com
  2. 2.
    Navigate to "Settings > Connect > Settings"
  3. 3.
    Configure the Branding to match your CI/CD.
  4. 4.
    In the section "Integration" - Copy the "Live mode client ID" [1] and provide it to Payrexx - In the section "Redirects", click "Add URI" [2] and enter the URI https://dispatcher.YOUR-PLATFORM-DOMAIN/stripe/ [3] where YOUR-PLATFORM-DOMAIN is the URL of your platform account at Payrexx. - Make sure that OAuth flows are activated
  5. 5.
    Click on "View test data" [1] and provide the "Test mode client ID" [2] to Payrexx.
  6. 6.
    Make sure to activate OAuth flow in Test mode and to add the URI in the "Redirects" section as well.

API Keys

API keys are necessary in order for the application to communicate with Stripe on behalf of your Stripe account.
  1. 1.
    Navigate to "Developers > API keys" [1] and - Copy the "Publishable key" [2] and provide it to Payrexx - Click on "Reveal live key token" [3] and copy the revealed token and provide it to Payrexx (if there is no secret key, generate one by clicking the button "Create secret key".
  2. 2.
    Click on "View test data" [1] and provide the "Publishable key" [2] to Payrexx. Click on "Reveal test key token" [3] and provide it to Payrexx.

Webhooks

Webhooks are necessary for payments to become completed through asynchronous notifications.
  1. 1.
    Navigate to "Developers > Webhooks" [1] and click on "Add endpoint" [2]
  2. 2.
    Configure the new webhook endpoint - Enter the field "Endpoint URL" [1] with https://dispatcher.YOUR-PLATFORM-DOMAIN/stripe/webhook.php where YOUR-PLATFORM-DOMAIN is the URL of your platform account at Payrexx. - Add "Events to send" [2] by searching them in the dropdown "Select events".
    The following events need to be added: charge.refund.updated charge.succeeded charge.refunded charge.failed order.payment_failed invoice.payment_failed invoice.payment_succeeded invoice.created customer.subscription.deleted
  3. 3.
    Click on the newly created webhook and click on "Click to reveal" [1] in order to reveal the signing secret. Provide this signing secret to Payrexx.

Provide to Payrexx

Payrexx needs some keys to connect your platform with Stripe correctly.
Please provide the following information in order tofulfill the connection. This data can be sent to [email protected]
  • Live mode client ID
  • Test mode client ID
  • Live API Publishable Key
  • Live API Secret Key
  • Test API Publishable Key
  • Test API Secret Key
  • Webhook Signing Secret