Stripe
Use this guide when you want to accept card and wallet payments with Stripe in a Bootiga store. It focuses on the practical setup flow: create the gateway, connect Stripe, test checkout, configure webhooks, and switch to live mode safely.
Before you start
- Have access to the Stripe account that will receive payments.
- Keep your store currency, business details, taxes, and checkout flow reviewed before testing payments.
- Use Stripe test mode first. Do not enable live payments until you have completed a full test order.
Create the gateway
- Go to Commerce configuration and open Payment gateways.
- Click Add payment gateway and choose Stripe Payment Element when available.
- Set a clear display name such as Credit card or Stripe, then select Test mode while configuring.
Connect Stripe
- Use Stripe Connect when offered, because it avoids manually storing API keys in the site.
- If you use API keys, copy the publishable key and secret key from the correct Stripe mode: test keys for testing, live keys for production.
- Never paste live secret keys into test mode or share them by email or chat.
Webhooks
- Save the gateway once to obtain the webhook endpoint URL.
- Create a webhook endpoint in the Stripe dashboard and paste the signing secret back into the gateway settings.
- Webhooks help the store update orders even if the customer closes the browser or loses connection after payment.
Payment options
- Payment Element can show different payment methods depending on customer location, device, browser, cart, and enabled Stripe methods.
- Use Automatic Async capture unless your business needs manual capture before shipping.
- Enable only payment methods supported by your Drupal Commerce Stripe setup.
Before going live
- Place a complete test order and check that the order, payment state, customer email, and checkout confirmation are correct.
- Switch the gateway to Live mode only after replacing test credentials with live credentials.
- Run one low-value real transaction and refund it from the order payment screen to confirm the full flow.
Based on the official Drupal Commerce Stripe guide, the Commerce Stripe project page, and the Drupal Commerce payment administration guide.