Required For Integration

Required Payment Fields for Stripe

  • Gateway CustomerId
  • Gateway PaymentId
  • Billing Address
  • Payment Method Description (optional, but strongly suggested because it is used to display the payment method to your customer)

Setting up Stripe Payments

Navigate to QPilot Merchant Center > Dashboard > Payment Integrations. Once there, select the "Add" button (blue circle with the "+" sign in it) to add a new payment integration.

Make sure that "Test Mode" is enabled (unless you are ready to begin using the gateway in Live mode), click the "Payment Method Type" dropdown and select "Stripe", enter the required API credentials.

When you're done, click "CREATE". You should now see a new Stripe payment integration in your Payment Integrations list.

🚧

Ready to go live with a Stripe?

In order to enable live payments (and disable 'Test Mode') please ensure you have activated your QPilot account with a subscription plan.

Then make sure a "Production" environment is selected for your site in QPilot Merchant Center > Edit (site) > General Settings

Loading a Stripe Payment Method

  1. Select "Stripe- Load Manually"
  2. Enter in the Gateway CustomerId and select "Load Profile"
  3. Select the payment method to apply.
  4. Select "Update"
Loading Stripe Payment MethodLoading Stripe Payment Method

Loading Stripe Payment Method

Learn more about loading Payment Methods here.

Stripe Strong Customer Authentication

Strong Customer Authentication (SCA) may be required when a customer's bank decides not to accept a previously authenticated payment method or an exemption. Payments declined for this reason then have to be resubmitted to the customer with a request for Strong Customer Authentication.

SCA is enabled automatically in regions that require it and requires additional configuration in QPilot to ensure that customers are able to respond when their Scheduled Order fails to process due to their bank requiring them to re-authenticate their payment method.

Helpful Resources about Stripe SCA

Enabling the Customer Email Notification for Strong Customer Authentication

  1. Enable the Customer Email Notification for Your QPilot Site
    • In your QPilot Merchant Center, navigate to Sites > Dashboard > Email Notifications >> Other Scheduled Order Notifications and enable the "Scheduled Order Email Payment" notification.
  2. Select "UPDATE" to confirm your changes.

What Happens When a Scheduled Order Fails to Process Due to SCA?

  1. The Scheduled Order's status will be "Failed" because the payment was declined.
  2. A message will be sent to the customer's email address for the Scheduled Order requesting them to "click here to authenticate your payment".
  3. The customer selects the link and is directed to a page that enables them to re-authenticate their payment method.
  4. If the re-authentication is successful, the Scheduled Order will become active & continue processing, and the customer is redirected to their customer portal (to view their Scheduled Orders).
  5. If the re-authentication fails, the Scheduled Order's status will remain "Failed".
An email is sent to the Customer requesting them to authenticate their payment method.An email is sent to the Customer requesting them to authenticate their payment method.

An email is sent to the Customer requesting them to authenticate their payment method.

A merchant's view of a Scheduled Order that failed to process due to the payment method needing authentication.A merchant's view of a Scheduled Order that failed to process due to the payment method needing authentication.

A merchant's view of a Scheduled Order that failed to process due to the payment method needing authentication.


Did this page help you?