Cancel an open Checkout
const url = 'https://api.voltpay.space/v1/checkouts/chk_01J9%E2%80%A6/cancel';const options = { method: 'POST', headers: { 'Idempotency-Key': '6c1f4a8e-2d3b-4f7e-9a11-0c5e8b7d2f10', Authorization: 'Bearer <token>' }};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.voltpay.space/v1/checkouts/chk_01J9%E2%80%A6/cancel \ --header 'Authorization: Bearer <token>' \ --header 'Idempotency-Key: 6c1f4a8e-2d3b-4f7e-9a11-0c5e8b7d2f10'Releases the Checkout’s Hold and Reservation.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Example
chk_01J9…Header Parameters
Section titled “Header Parameters”Makes a retry safe. Stored for 24 hours with a fingerprint of the method, path and body. A repeat with the same fingerprint returns the first answer.
Example
6c1f4a8e-2d3b-4f7e-9a11-0c5e8b7d2f10Responses
Section titled “Responses”The Checkout, now cancelled.
object
The Merchant’s own identifier for a Checkout, unique per Merchant and Mode.
The Checkout Link. It carries only an opaque token.
open can become paid, expired or cancelled. expired can still become paid within the Late Window.
An amount in USD. Each Coin counts as 1 USD.
The Pairs on offer, fixed at creation.
One Network with one Coin.
object
One blockchain. Test mode uses the test Network codes.
The coin, identified on-chain by its contract and never by this symbol.
object
Derived from the Transfer, so one Transfer can never become two Payments.
seen may still be reversed. confirmed is Final or accepted early. reversed disappeared after being confirmed.
The Merchant’s own identifier for a Checkout, unique per Merchant and Mode.
An amount in USD. Each Coin counts as 1 USD.
What actually arrived, kept exactly. The Merchant credits this.
An on-chain amount in integer base units, as a string because it can exceed any JSON number.
The Coin’s decimals on this Network. BSC uses 18, most others 6.
How the amount that arrived compares with the Checkout.
The evidence that matched the Transfer to the Checkout. A sender or transaction hash a Payer posted is never evidence.
One blockchain. Test mode uses the test Network codes.
The coin, identified on-chain by its contract and never by this symbol.
The Coin’s contract on this Network.
The Receive Address the money went to.
The on-chain sender.
Example
{ "id": "chk_01J9…", "reference": "DEP20261106123456", "url": "https://pay.voltpay.space/c/8sJk2Qm4Tz", "status": "open", "amount": "50.00", "pairs": [ { "network": "tron", "coin": "usdt" } ], "expires_at": "2026-11-06T13:34:56Z", "created_at": "2026-11-06T13:04:56Z"}INVALID_API_KEY: the key is missing, wrong or revoked.
object
object
The stable identifier a client branches on.
For people. May be reworded, so never branch on it.
More about the failure. For VALIDATION_ERROR, a map of field name to reason.
object
Only with CHECKOUT_LIMIT_EXCEEDED. The largest Checkout the Merchant may create now, in micro-USD.
Examples
{ "error": { "code": "INVALID_API_KEY", "message": "The API key is missing, wrong or revoked.", "request_id": "req_01J9…" }}MERCHANT_SUSPENDED: Staff have suspended the Merchant.
object
object
The stable identifier a client branches on.
For people. May be reworded, so never branch on it.
More about the failure. For VALIDATION_ERROR, a map of field name to reason.
object
Only with CHECKOUT_LIMIT_EXCEEDED. The largest Checkout the Merchant may create now, in micro-USD.
Examples
{ "error": { "code": "MERCHANT_SUSPENDED", "message": "This account is suspended. Contact support.", "request_id": "req_01J9…" }}CHECKOUT_NOT_FOUND: no such Checkout.
object
object
The stable identifier a client branches on.
For people. May be reworded, so never branch on it.
More about the failure. For VALIDATION_ERROR, a map of field name to reason.
object
Only with CHECKOUT_LIMIT_EXCEEDED. The largest Checkout the Merchant may create now, in micro-USD.
Examples
{ "error": { "code": "CHECKOUT_NOT_FOUND", "message": "No Checkout has that id.", "request_id": "req_01J9…" }}CHECKOUT_NOT_OPEN: the Checkout can no longer be cancelled.
IDEMPOTENCY_KEY_REUSED: the same key was used with a different body.
REQUEST_IN_PROGRESS: the first request with this key is still running.
object
object
The stable identifier a client branches on.
For people. May be reworded, so never branch on it.
More about the failure. For VALIDATION_ERROR, a map of field name to reason.
object
Only with CHECKOUT_LIMIT_EXCEEDED. The largest Checkout the Merchant may create now, in micro-USD.
Examples
{ "error": { "code": "CHECKOUT_NOT_OPEN", "message": "This Checkout is no longer open and cannot be cancelled.", "request_id": "req_01J9…" }}{ "error": { "code": "IDEMPOTENCY_KEY_REUSED", "message": "This Idempotency-Key was used with a different request body.", "request_id": "req_01J9…" }}{ "error": { "code": "REQUEST_IN_PROGRESS", "message": "The first request with this Idempotency-Key is still running.", "request_id": "req_01J9…" }}RATE_LIMITED: back off, per Retry-After.
object
object
The stable identifier a client branches on.
For people. May be reworded, so never branch on it.
More about the failure. For VALIDATION_ERROR, a map of field name to reason.
object
Only with CHECKOUT_LIMIT_EXCEEDED. The largest Checkout the Merchant may create now, in micro-USD.
Examples
{ "error": { "code": "RATE_LIMITED", "message": "Too many requests. Wait for the time in Retry-After, then try again.", "request_id": "req_01J9…" }}Headers
Section titled “Headers”Seconds to wait before trying again.
INTERNAL: an unexpected failure. Quote request_id when reporting it.
object
object
The stable identifier a client branches on.
For people. May be reworded, so never branch on it.
More about the failure. For VALIDATION_ERROR, a map of field name to reason.
object
Only with CHECKOUT_LIMIT_EXCEEDED. The largest Checkout the Merchant may create now, in micro-USD.
Examples
{ "error": { "code": "INTERNAL", "message": "Something went wrong on our side. Quote the request id if this continues.", "request_id": "req_01J9…" }}TRY_AGAIN: a time limit cut the request short and nothing was committed.
object
object
The stable identifier a client branches on.
For people. May be reworded, so never branch on it.
More about the failure. For VALIDATION_ERROR, a map of field name to reason.
object
Only with CHECKOUT_LIMIT_EXCEEDED. The largest Checkout the Merchant may create now, in micro-USD.
Examples
{ "error": { "code": "TRY_AGAIN", "message": "Nothing was committed. Try the request again.", "request_id": "req_01J9…" }}Headers
Section titled “Headers”Seconds to wait before trying again.