Skip to main content

Stripe

Instructions for Connecting Stripe

Create a payment account of type Stripe​

Instructions on how to create a payment account can be found here.

Connect Stripe to the payment account​

To do this, go to the created payment account and click Connect Stripe.

IMG1

You will be redirected to the Stripe connection page. Fill in your company details, select the type and location of your business, confirm the account representative, and provide bank details for payouts. After completing the registration, you will return to the CMS, and the payment account will show the status Stripe connected.

After connecting, go to Developers → Webhooks in the Stripe Dashboard and click Add destination.

Follow the steps in the event destination creation wizard: select the events to listen for, choose the destination type (webhook endpoint), and in the setup step, enter the address of our webhook 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

Assign a name to the destination and complete the creation — the new endpoint will appear in the Event destinations list with the status Active.

To ensure OneEntry verifies the authenticity of events coming from Stripe, copy the signing secret of the created endpoint from the Stripe Dashboard. You will need it in the payment account settings.

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

IMG10

Add automatic payment status updates for the order. The order status is shown on the left, and the statuses of your orders, added earlier in the orders section, are shown on the right.

IMG7

Fill in the account settings​

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

  • Success URL — the address to which the buyer will return after a successful payment. This field is required.
  • Cancel URL — the address to which the buyer will return if the payment is canceled.
  • Session timeout — the lifespan of the payment session. The value must be a whole number greater than 0.
  • Use Stripe webhook data validation — enables verification of the authenticity of the data that Stripe sends to the webhook.
  • Key for validating Stripe webhook — the signing secret of the endpoint from the Stripe Dashboard. This field becomes available only when the Use Stripe webhook data validation checkbox is checked, and in this case, it is required.

Changes are saved automatically.

IMG11

The payment account supports test mode. This feature allows you to test the Stripe connection with test connection parameters.

IMG11

To disable test mode, uncheck the checkbox.