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

  1. Open the link. Check that Stripe is in test mode: the page says "Test mode" or "Sandbox", and the address contains /test/.
  2. 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.
  3. 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.
  4. Do not take the Publishable key (pk_test_): that is the public one.
  5. 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.
  6. Paste it into Shipyard.
  7. 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.

Set up once in Stripe (test mode) before your first launch

What stays manual

These are things only a person can do at this provider. Shipyard cannot and will not do them for you.

What you paste into Shipyard

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

Related guides

How to create a Stripe (test mode) API token with the narrowest permissions – Shipyard