Error Handling

curl -X POST https://staging.api.sohopay.xyz/api/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 isRetryable = status === 429 || status === 500;

      if (!isRetryable || attempt >= maxAttempts) {
        throw err;
      }

      const retryAfter = Number(err.headers?.["retry-after"]);
      const baseDelay = retryAfter
        ? retryAfter * 1000
        : Math.min(1000 * Math.pow(2, attempt), 30000);

      // Add full random jitter
      const jitteredDelay = baseDelay + Math.random() * 1000;
      await new Promise((resolve) => setTimeout(resolve, jitteredDelay));
    }
  }
}

import random
import time
from sohopay import SohoPay, SohoPayError

RETRYABLE_STATUSES = {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_STATUSES or attempt == max_attempts:
                raise
            retry_after = err.headers.get("Retry-After")
            base = float(retry_after) if retry_after else min(2 ** attempt, 30.0)
            jittered_delay = base + random.uniform(0.0, 1.0)
            time.sleep(jittered_delay)