Accepting Stripe payments

International card payments through Stripe, for USD stores.

Stripe lets customers pay by international card at checkout, with the payment confirmed and settled automatically into your own Stripe account. It is only available for stores priced in USD - Stripe does not support Nigerian-registered businesses, so this option is meant for stores selling to customers outside Nigeria, connected to a Stripe account from a country Stripe does support.

Switch your store currency to USD first

Stripe only shows up as an option in Settings → Payments once your store currency is set to USD (under Settings → Payments → Store Currency). Currency can only be changed before your store has its first order, so decide on this early if you plan to use Stripe.

Connecting your account

In Settings → Payments, select Stripe and paste in your Publishable Key and Secret Key. These come from your Stripe dashboard, under Developers → API keys. If you do not have a Stripe account yet, create one first at stripe.com - note that Stripe accounts can only be opened from countries Stripe supports, which does not currently include Nigeria.

The webhook endpoint

Once connected, Vezstora shows you a webhook URL specific to your store. In your Stripe dashboard, go to Developers → Webhooks, add an endpoint using that URL, and select the checkout.session.completed event. Stripe then shows you a signing secret starting with whsec_ - paste that into the Webhook Signing Secret field in Vezstora. Without a matching webhook endpoint and signing secret, payments may go through on Stripe's side without your order automatically updating to Paid.

Going live

Stripe gives you separate test and live API keys (pk_test_/sk_test_ vs pk_live_/sk_live_). Use test keys while you are setting things up, then switch to your live keys - and add a second, live-mode webhook endpoint with its own signing secret - before sharing your storefront publicly, so real customer payments actually reach your account.

Removing or replacing keys

You can remove your Stripe API keys at any time from the same settings page. Doing so disables Stripe checkout on your storefront until you reconnect.