Guides / API tokens
How to create a Stripe (test mode) API token with the narrowest permissions
Shipyard uses a Stripe (test mode) token for payments. The token is stored in your computer's keychain and is not sent to shipyardmcp.com. These are the exact steps, and the smallest set of permissions that works.
Create the token
Start here: https://dashboard.stripe.com/test/apikeys
- Open the link. Check that Stripe is in test mode: the page says "Test mode" or "Sandbox", and the address contains /test/.
- Find the key named "Secret key" in the list. It is shown shortened, starting with sk_test_. Stripe translates the page, so in your language it may read differently, for example "Geheime sleutel" in Dutch.
- Press the small copy icon right next to it (on older pages the button reads "Reveal test key"). Stripe may ask you to confirm it is you.
- Do not take the Publishable key (pk_test_): that is the public one.
- Every Stripe account comes with a test secret key, so you normally create nothing. If the list is empty because it was deleted, press the button to create a secret key. When Stripe asks how you will use it, choose "Build your own integration"; name it Shipyard; for permissions pick "Full access, except sensitive operations", not the one marked High risk; and copy it.
- Paste it into Shipyard.
- For experts only: a restricted key (rk_test_) also works if it has Write on Products, Prices, Coupons, Webhook Endpoints, Customers, Checkout Sessions and Subscriptions, and Read on Events.
Permissions, and why each one is needed
Nothing to tick. The standard secret key already allows all of this; this is what Shipyard uses it for.
- Products, prices and coupons: Create your pricing.
- Webhook endpoints: Point Stripe at your live domain and read the signing secret once.
- Customers and events: The health check creates and deletes one test customer to prove the webhook arrives.
- Checkout sessions and subscriptions: Your app uses this same key to take payments.
Set up once in Stripe (test mode) before your first launch
- Nothing for test mode. To take real payments later, finish Stripe's business verification; it can take a day or more, so start it now. (https://dashboard.stripe.com/account/onboarding)
What stays manual
These are things only a person can do at this provider. Shipyard cannot and will not do them for you.
- Creating the Stripe account.
- Stripe business verification before live payments.
What you paste into Shipyard
- Test secret key (starts with sk_test_)
Have this set up for you
Shipyard connects your accounts once and then does all of this for every new product, in about an hour.
See how it works