Error Handling

curl -X POST https://api-sandbox.sohopay.xyz/v1/payments \
  -H "Authorization: Bearer $SOHOPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pay-ord-9f8e7d6c" \
  -d '{"order_id": "ord_9f8e7d6c", "agent_id": "agt_3f9a1c8e", "signature": "sandbox_auto"}'

const payment = await sohopay.payments.submit(
  { orderId: "ord_9f8e7d6c", agentId: "agt_3f9a1c8e", signature: "sandbox_auto" },
  { idempotencyKey: `pay-${"ord_9f8e7d6c"}` },
);

payment = sohopay.payments.submit(
    order_id="ord_9f8e7d6c",
    agent_id="agt_3f9a1c8e",
    signature="sandbox_auto",
    idempotency_key="pay-ord_9f8e7d6c",
)

async function withRetry<T>(fn: () => Promise<T>, maxAttempts = 5): Promise<T> {
  for (let attempt = 1; ; attempt++) {
    try {
      return await fn();
    } catch (err: any) {
      const status = err.status;
      const retryable = status === 429 || status === 500;
      if (!retryable || attempt === maxAttempts) throw err;

      const retryAfter = Number(err.headers?.["retry-after"]);
      const base = retryAfter ? retryAfter * 1000 : Math.min(1000 * 2 ** attempt, 30_000);
      const delay = base + Math.random() * 1000; // full jitter on top
      console.warn(`Attempt ${attempt} failed (${status}), retrying in ${delay}ms`, err.requestId);
      await new Promise((r) => setTimeout(r, delay));
    }
  }
}

const payment = await withRetry(() =>
  sohopay.payments.submit(
    { orderId: order.orderId, agentId: agent.agentId, signature: "sandbox_auto" },
    { idempotencyKey: `pay-${order.orderId}` },
  ),
);

import random
import time

from sohopay import SohoPay, SohoPayError

RETRYABLE = {429, 500}

def with_retry(fn, max_attempts=5):
    for attempt in range(1, max_attempts + 1):
        try:
            return fn()
        except SohoPayError as err:
            if err.status not in RETRYABLE or attempt == max_attempts:
                raise
            retry_after = err.headers.get("Retry-After")
            base = float(retry_after) if retry_after else min(2 ** attempt, 30)
            delay = base + random.uniform(0, 1)  # full jitter on top
            print(f"Attempt {attempt} failed ({err.status}), retrying in {delay:.1f}s", err.request_id)
            time.sleep(delay)

payment = with_retry(lambda: sohopay.payments.submit(
    order_id=order.order_id,
    agent_id=agent.agent_id,
    signature="sandbox_auto",
    idempotency_key=f"pay-{order.order_id}",
))