Create Stablecoin Payment Session

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

Create a Stablecoin Payment Session

Use this when you are integrating on behalf of a real merchant account.

Request

curl -X POST https://api.plaidly.io/v1/payment_sessions \
  -H "X-API-Key: your_plaidly_sk_live_or_test_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 25.00,
    "expires_in": "45m",
    "paymentMethod": {
      "methodID": 0,
      "chain": "solana",
      "token": "USDC",
      "network": "testnet"
    }
  }'

Expected response fields:

session_id
address (wallet to receive payment)
expected_amount
currency
paymentMethod.chain
paymentMethod.token
paymentMethod.network
expires_at

Some older clients still send payment_method with snake_case keys. The server accepts the canonical schema shown above.

Notes

methodID: 0 means on-chain crypto transfer.
Use short expiries for testing (15m, 45m, 1h).
expected_amount is what you should collect before fulfillment.

Sandbox Onboarding

Provision a test session without spending funds

Simulate Payment

Trigger sandbox payment confirmation without chain broadcast

On this page

Create a Stablecoin Payment Session Request Notes