Skip to main content

Stripe

Connecting Stripe​

Create a payment account of the Stripe type​

Creating a payment account is described here (opens in a new tab).

Connect Stripe to the payment account​

Open the payment account you created and click Connect Stripe.

Edit form of the stripe payment account; an arrow points to the "Connect Stripe" button below the "Test mode" checkbox

You'll be redirected to the Stripe connection page. Enter your company details, select your business type and location, confirm the account representative, and provide bank details for payouts. When registration is complete, you return to the CMS, and the payment account shows the Stripe connected status.

Then go to Developers → Webhooks in the Stripe Dashboard and click Add destination.

Complete the event destination wizard: select the events to listen to, choose the destination type (webhook endpoint), and at the configuration step enter our webhook address in the Endpoint URL field. Replace test-project.oneentry.cloud with your project's address:

https://test-project.oneentry.cloud/api/content/payments/webhook/stripe

Name the destination and finish creating it. The new endpoint appears in the Event destinations list with the Active status.

For OneEntry to verify that events come from Stripe, copy the endpoint's Signing secret in the Stripe Dashboard. You'll need it in the payment account settings.

After adding the webhook, go to Payments → Statuses in the CMS, select the order storage, and open its settings.

"Statuses" tab of the "Payments" section: the table lists "Order Storage 1" with the storage1 marker and a settings icon

Set up automatic payment status updates for orders. Payment statuses are on the left, and the order statuses you added earlier in the orders section are on the right. For each payment status, choose the status the order gets.

"Payment Status Settings" screen: the "Waiting", "Completed", "Canceled", and "Payment has expired" payment statuses mapped to order statuses, and the "Save" button

Fill in the account settings​

Open the payment account for editing. In the Details block, specify:

  • Success URL: the address the buyer returns to after a successful payment. Required.
  • Cancel URL: the address the buyer returns to if the payment is canceled.
  • Session timeout: the lifetime of the payment session. The value must be an integer greater than 0.
  • Use Stripe webhook data validation: enables verification of the data Stripe sends to the webhook.
  • Key for validating Stripe webhook: the endpoint's signing secret from the Stripe Dashboard. The field is available only when the Use Stripe webhook data validation checkbox is selected, and in that case it is required.

Changes are saved automatically.

"Details" block of the stripe payment account: an arrow points to the "Success URL" and "Cancel URL" fields

The payment account supports test mode, which lets you test the Stripe connection with test connection parameters.

stripe payment account: an arrow points to the unchecked "Testing mode" checkbox above the "Connect Stripe" button

To turn off test mode, clear the checkbox.

Last updated on