Repository navigation
Payment Providers
Archway takes payments through your Stripe account, so your customers' money goes straight to you. Your tenancy's Payment Providers section is where you connect it.
This is part of the Getting started guide - step 4, and the go-live part of step 6.
Everything you set up as an owner lives in Tenant Center, reachable from the menu once you are signed in at your tenancy's address.
-
In Tenant Center, open your tenancy and add a Payment Provider.
-
Choose the region it serves. You add the provider once per region - if you sell into two regions, that is two entries, each with its own keys. Adding the same provider twice for the same region is refused on purpose.
-
Enter your Stripe keys. There are two sets - test keys for trying things out and live keys for real payments - and each set has two values:
Field in Archway What to enter Where to find it in Stripe Sandbox Payment Provider Account Key Your Stripe account ID - starts with acct_Dashboard → Settings → Business → Account details Sandbox Payment Provider Private Api Key Your test secret key - starts with sk_test_Dashboard → Developers → API keys, with test mode on Live Payment Provider Account Key Your Stripe account ID - starts with acct_as above Live Payment Provider Private Api Key Your live secret key - starts with sk_live_Dashboard → Developers → API keys, with test mode off The keys are hidden on screen once entered, to keep them safe.
-
Leave Live Mode switched off for now. While it is off, Archway uses your test keys and no real money moves - see Go live below for when to switch it on.
This is what opens your store. Until a payment provider is linked and active for a region, your storefront will not open for visitors in it - there would be no way to take their money. If your store will not open for a signed-out visitor, come back here first.
Treat the secret keys like passwords. Never send them by email or paste them anywhere other than these fields. If you think one has been exposed, roll it in your Stripe dashboard and enter the new one here.
Once you have tried your store as a customer with Live Mode off:
- Sign in as the owner and open your Payment Provider in Tenant Center.
- Make sure the live keys are entered.
- Switch Live Mode on. From now on your store takes real payments, paid out to your Stripe account.
Tip: after switching Live Mode on, a single small real purchase - refunded afterwards from your Stripe dashboard - is a good final check that everything is connected.
See Getting help in the Getting started guide. Never include your Stripe secret keys in a message to us - we will never need them.