Plaidly Docs

Sandbox Onboarding

Provision a test session without spending funds

Sandbox Onboarding

1) Confirm available testnet entry points

curl https://api.plaidly.io/v1/sandbox/faucets

Response is a chain/network map (for chains that expose testnet faucets).

2) Create a demo payment session

Use demo session creation when you do not need a merchant-scoped key:

curl -X POST https://api.plaidly.io/v1/payment_sessions/demo \
  -H "Content-Type: application/json" \
  -d '{
    "chain": "solana",
    "network": "testnet",
    "token": "USDC",
    "amount": 0.0015
  }'

This returns a session in pending status and an session_id.

3) Read the session details

curl https://api.plaidly.io/v1/payment_sessions/<SESSION_ID>

You get deterministic fields for test assertions:

  • session_id
  • address
  • expected_amount
  • currency
  • paymentMethod
  • status

Optional: retrieve a funded dev wallet for the session

For some chains, tests may want the private key:

curl -X POST https://api.plaidly.io/v1/payment_sessions/<SESSION_ID>/provide_wallet

Response:

{
  "wallet": {
    "publicKey": "...",
    "privateKey": "...",
    "explorerURL": "..."
  }
}

Fields:

  • publicKey
  • privateKey
  • explorerURL

Next

Discoverability Smoke Test

Start from llms.txt, register a sandbox merchant, and prove a payment path works

Create Stablecoin Payment Session

Build a stablecoin session with explicit chain/network/token values

On this page

Sandbox Onboarding1) Confirm available testnet entry points2) Create a demo payment session3) Read the session detailsOptional: retrieve a funded dev wallet for the sessionNext