Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Back off safely when the API asks your client to slow down.
429, honor the server’s retry guidance when present, use exponential backoff with jitter, and reuse the original idempotency key for a create request. For a 5xx or network timeout, retrieve by ID before creating another payment, session, refund, or subscription.
async function requestWithBackoff(request, idempotencyKey) {
for (let attempt = 0; attempt < 4; attempt += 1) {
const response = await fetch(request, { headers: { "Idempotency-Key": idempotencyKey } });
if (response.status !== 429 && response.status < 500) return response;
await new Promise((resolve) => setTimeout(resolve, 250 * 2 ** attempt));
}
throw new Error("request requires reconciliation");
}