Skip to content
Help Center
Magyar

Stripe

Take international card payments with 3D Secure, Apple Pay, Google Pay and Link on Stripe's hosted checkout page.

Where
  1. App Store
  2. Stripe
On this page

The Stripe app sends shoppers to Stripe's hosted payment page, where they pay by card, Apple Pay, Google Pay or Link. Stripe handles 3D Secure on that page. It is the usual choice for stores that sell internationally, and it works on every plan and in every country Stripe supports.

Before you start

  • You need a Stripe account.
  • You need the secret key from the Stripe Dashboard. A key starting with sk_test_ works in test mode, one starting with sk_live_ takes real payments. There is no separate sandbox setting.
  • You need to add a webhook endpoint in the Stripe Dashboard, as described below. It gives you a signing secret starting with whsec_.
  • If you want Stripe to calculate tax, Stripe Tax has to be activated in your Stripe account with a registration for every country or state you sell into. See https://docs.stripe.com/tax/set-up.

Set up Stripe

  1. Open Apps → App Store and open Stripe. New stores have it installed already. If yours does not, select Install. Installing works the same for every app, see App Store.

    The Stripe page in the App Store, installed and switched on, with the Needs setup badge and the first steps of its setup guide
    Stripe shows Needs setup until you fill in its settings.

  2. On the app page, open System endpoints and copy the Webhook URL.

  3. In the Stripe Dashboard, add a webhook endpoint with this address and subscribe it to the checkout.session.* and payment_intent.* events. Copy the signing secret of the endpoint.

  4. Back in Poltura, in the Settings section, enter the Secret key (the test key to begin with) and the Webhook signing secret.

  5. Select Save in the save bar.

  6. Select Check the credentials. The message The credentials work. confirms that Stripe accepted the key.

  7. Select Turn on. The status of the app changes to Active.

  8. Open Settings → Payments. Stripe is listed under Payment methods with the status Ready.

  9. Shoppers now see Stripe at checkout in every currency it can charge, on every domain. See Payments.

  10. Place a test order and pay with the test card 4242 4242 4242 4242.

  11. To go live, add the webhook endpoint in live mode too, then replace the secret key and the signing secret with the live values and save.

Settings

  • Secret key (required): your Stripe secret API key. The prefix decides between test and live mode. It is stored encrypted and is never shown again after you save it.
  • Webhook signing secret (required): the signing secret of the webhook endpoint you added in the Stripe Dashboard. Your store uses it to check that payment events really come from Stripe.
  • Publishable key: your Stripe publishable key. The hosted checkout does not need it, so you can leave it empty.
  • Capture method: manual holds the amount at checkout and charges it when you capture the payment. automatic charges at once, which most payment methods other than cards require. New installs use manual.
  • Collect tax automatically (Stripe Tax): lets Stripe Tax calculate tax from the shopper's address on the hosted page. It needs Stripe Tax activated with your registrations.
  • Tax behavior: only used when automatic tax is on. inclusive keeps your prices as the final amount and carves the tax out of them. exclusive adds tax on top of your prices.
  • Create a Stripe invoice for each payment: Stripe creates an invoice with a hosted page and a PDF after each completed payment. With manual capture the invoice appears after the capture.

What shoppers see at checkout

The payment step lists Card payment (Stripe). After placing the order the shopper is taken to Stripe's secure page and pays there by card, Apple Pay, Google Pay or Link. Which card and wallet methods are offered is controlled in your Stripe Dashboard.

Day to day

  • The order page has a Stripe payment panel with the payment intent and an Open in Stripe link. A Test badge marks payments made in test mode.
  • With the manual capture method, open the order and select Capture payment when you ship. The admin captures the full amount. See Payments and refunds.
  • You can refund a payment in full or in part with Create Refund. See Refund an order.
  • Canceling an order that was not captured releases the held amount.

If something goes wrong

  • The shopper paid at Stripe, but the order does not complete. Stripe's events do not reach your store or fail the signature check. In the Stripe Dashboard, check that the endpoint uses the Webhook URL from the app page and listens to the checkout.session.* and payment_intent.* events, and that the Webhook signing secret belongs to that endpoint and that mode.
  • Real cards are refused. The Secret key is still a test key.
  • Apple Pay, Google Pay or another method is missing on Stripe's page. Switch the method on in your Stripe Dashboard. Methods other than cards usually need the Capture method automatic.
  • Tax is not calculated on Stripe's page. Stripe Tax is not activated, or you have no registration for the shopper's country or state.
  • Stripe does not appear at checkout. Open Settings → Payments and check the status. Setup incomplete means a required field is missing, Off means the app is switched off.