Errors

const res = await fetch("https://api.antonpayments.dev/v1/payouts", {
  method: "POST",
  headers: {
    Authorization: `DPoP ${accessToken}`,
    DPoP: dpopProof("POST", "https://api.antonpayments.dev/v1/payouts", accessToken),
    "Content-Type": "application/json",
    "Idempotency-Key": idempotencyKey,
  },
  body: JSON.stringify(payout),
});

if (!res.ok) {
const { error } = await res.json();
const requestId = res.headers.get("X-Request-ID");

switch (error.code) {
case "validation_error":
// error.details is an array of { field, message }
break;
case "insufficient_balance":
// prompt user to top up
break;
case "velocity_blocked":
// inspect /velocity-results
break;
case "rate_limit_exceeded": {
const retryAfter = Number(res.headers.get("Retry-After") ?? 1);
await new Promise((r) => setTimeout(r, retryAfter \* 1000));
break;
}
case "idempotency_conflict":
// generate a new key; do not reuse the old one
break;
default:
if (res.status >= 500) {
// retry with backoff; include requestId in logs
}
}
}

import time, requests

res = requests.post(
    "https://api.antonpayments.dev/v1/payouts",
    headers={
        # dpop_proof is signed per request and binds this method + URL.
        # See /authentication for how to generate it.
        "Authorization": f"DPoP {access_token}",
        "DPoP": dpop_proof,
        "Idempotency-Key": idempotency_key,
    },
    json=payout,
)

if not res.ok:
    err = res.json()["error"]
    request_id = res.headers.get("X-Request-ID")

    code = err.get("code")
    if code == "validation_error":
        for d in err["details"]:
            print(f"{d['field']}: {d['message']}")
    elif code == "rate_limit_exceeded":
        time.sleep(int(res.headers.get("Retry-After", "1")))
    elif code == "idempotency_conflict":
        # generate a new key before retrying
        pass
    elif res.status_code >= 500:
        # exponential backoff; log request_id
        pass