Test your Sapiom Pay integration in the sandbox

Get access

Sapiom Pay is still in early access (EA), so the sandbox is only enabled per organization. After you sign up at app.sapiom.ai/signup, reach out to your Sapiom contact, and we’ll enable it for your org.

Enter Sandbox 🤘

From app.sapiom.ai, open the account menu at the bottom of the sidebar and click Open sandbox. This will take you to the sandbox state. Note: Since we’re still in early access, there’s no direct indication, but if you click the account menu again, the open sandbox icon will be gone.

The Sapiom account menu with Settings, Dark mode, Help and Open sandbox, with Open sandbox circled — Open sandbox in the account menu

Get a Key

From the sandbox, open Developers → API keys and then click Create key. Give it a name, and click Create. Copy the key (it only appears once) and then save it securely. Below, we call it SAPIOM_SANDBOX_PLATFORM_KEY. You can create as many of these as you would like.

Create a sandbox buyer

The sandbox and production platforms have the same entry point, so the base URLs are all the same. Simply use the SK test key instead of your production key. Any Sapiom links returned in responses will be for sandbox pages as well.

REST API
MCP
Browser Pay SDK

curl https://api.sapiom.ai/v1/tenants \
  -H "x-api-key: $SAPIOM_SANDBOX_PLATFORM_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Test user","externalId":"test-user-1"}'

Connect your agent with a sandbox buyer key:

claude mcp add --transport http sapiom https://api.sapiom.ai/v1/mcp/pay \
  --header "x-api-key: $SAPIOM_SANDBOX_BUYER_KEY"

Pass the sandbox buyer key as apiKey. Keep baseUrl as https://api.sapiom.ai.

import { httpPaymentRelay } from "@sapiom/browser-pay";

const relay = httpPaymentRelay({
  baseUrl: "https://api.sapiom.ai",
  apiKey: process.env.SAPIOM_SANDBOX_BUYER_KEY!, // sk_test_...
  transactionId,
});

The response is the new sandbox buyer. To get its scoped buyer key, see Manage buyers.

Save a test card

Create a setup link with a sandbox buyer key, open it, and save this test card:

Field	Value
Card number	`4242 4242 4242 4242`
Expiry	Any future date
Security code	`123`

On any security code approval page, also use 123 as the security code.

Make a test purchase

Buy from Sapiom’s test store, https://sapiom-test-store.myshopify.com. It supports UCP checkout, so checking it with a sandbox buyer key returns supported:

curl -G https://api.sapiom.ai/v1/transaction-compatibility \
  -H "x-api-key: $SAPIOM_SANDBOX_BUYER_KEY" \
  -d domain=sapiom-test-store.myshopify.com

Then follow Authorize a transaction with a ucp_checkout purchase and "merchant": { "origin": "https://sapiom-test-store.myshopify.com" }. The order is placed with the store’s test payments, so no money moves.

Get started

Buyers

Cards

Transactions

Governance

Security

Early access

Test your Sapiom Pay integration in the sandbox

Get access

Enter Sandbox 🤘

Get a Key

Create a sandbox buyer

Save a test card

Make a test purchase

​Get access

​Enter Sandbox 🤘

​Get a Key

​Create a sandbox buyer

​Save a test card

​Make a test purchase

Get access

Enter Sandbox 🤘

Get a Key

Create a sandbox buyer

Save a test card

Make a test purchase