Volumedocs

Create a checkout session

POST
/v1/checkout_sessions

A hosted checkout for an open invoice. Send the payer to its url (paywithvolume.com/{id}); it is open for 24 hours, and once the payer picks a coin they have 30 minutes to pay. Return URLs must be https in live mode.

Authorization

ApiKey
AuthorizationBearer <token>

A merchant API key, sent as Authorization: Bearer vk_live_…. The prefix selects the mode: vk_test_ for testnets, vk_live_ for real money.

In: header

Header Parameters

Idempotency-Key*string

Makes the request safe to retry: the same key replays the first response instead of repeating the effect. At most 255 characters.

Length1 <= length <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/checkout_sessions" \  -H "Idempotency-Key: string" \  -H "Content-Type: application/json" \  -d '{    "invoice_id": "string",    "success_url": "http://example.com",    "cancel_url": "http://example.com"  }'
{  "object": "checkout_session",  "id": "string",  "livemode": true,  "url": "http://example.com",  "status": "open",  "invoice": "string",  "customer": "string",  "customer_email": "string",  "amount": "string",  "currency": "usd",  "description": "string",  "payment": {    "source": "string",    "asset": "USDT",    "network": "tron",    "amount_due": "string",    "withdraw_amount": "string",    "rate": "string",    "expires_at": "2019-08-24T14:15:22Z"  },  "amount_received": "string",  "payments": [    {      "object": "payment",      "id": "string",      "checkout_session": "string",      "asset": "USDT",      "network": "tron",      "amount": "string",      "status": "detected",      "tx_hash": "string",      "detected_at": "2019-08-24T14:15:22Z",      "confirmed_at": "2019-08-24T14:15:22Z"    }  ],  "success_url": "string",  "cancel_url": "string",  "expires_at": "2019-08-24T14:15:22Z",  "paid_at": "2019-08-24T14:15:22Z",  "created_at": "2019-08-24T14:15:22Z"}