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={
        "Authorization": f"Bearer {api_key}",
        "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