Configuring Stripe as a Payment Provider

To enable the service to collect payments and manage Stripe subscriptions, use the Merchant Portal to connect a Stripe account in TEST and LIVE modes.

In the Merchant Portal, go to Settings > Manage Stripe Account(under Payment Gateways) and press the Connect to Stripe button. The Stripe Connect mechanism will then guide you through the connection process.

❗️

Warning

Once the Stripe account is connected in LIVE mode, it might not be possible to change it without assistance from the Vertex support team. Ensure that you choose a correct account for LIVE mode. TEST mode accounts can be reconnected anytime through the Dashboard.

After the configuration is complete, Stripe is integrated into your webstore. The typical process flow for a Stripe integration is as follows:

  1. Customer visits the checkout page on the Merchant's store. The checkout is launched.
  2. The customer enters some details. The service calculates the tax.
  3. The customer proceeds with the payment. The transaction is stored by Vertex.
  4. The payment is charged in Stripe.
  5. The transaction is confirmed by Vertex.

The following graphic illustrates these steps:

Stripe Integration.Stripe Integration.

Stripe Integration.

Custom Fields for Stripe

When Stripe is the payment provider, the service records the following custom fields with the transaction so you easily find the associated Stripe objects.

Key

Value

stripe-charge-id

The Stripe Charge ID that is associated with the transaction.

stripe-customer-id

The Stripe Customer ID that is associated with the transaction.

stripe-payment-intent-id

The Stripe PaymentIntent ID that is associated with the transaction. This is only present when SCA is enabled in the Stripe settings page.

stripe-token

The Stripe Token that is associated with the transaction. This is only present when SCA is NOT enabled in the Stripe settings page.


Did this page help you?