Error code reference

{
  "error": {
    "code": "card_declined",
    "message": "The card was declined by the issuer.",
    "type": "payment_error",
    "param": "payment_method",
    "doc_url": "https://docs.vinr.com/docs/troubleshooting/error-codes#card_declined",
    "request_id": "req_8aQ2xL0fK"
  }
}

import { Vinr, VinrError } from '@vinr/sdk';

const vinr = new Vinr({ secretKey: process.env.VINR_SECRET_KEY });

try {
  await vinr.payments.create({ amount: 1000, currency: 'EUR', customer: 'cust_123' });
} catch (err) {
  if (err instanceof VinrError) {
    switch (err.code) {
      case 'card_declined':
        return showRetryWithDifferentCard();
      case 'rate_limited':
        return scheduleRetry(err.retryAfter);
      default:
        console.error(`[${err.requestId}] ${err.code}: ${err.message}`);
    }
  }
  throw err;
}

async function withRetry<T>(fn: () => Promise<T>, attempts = 5): Promise<T> {
  for (let i = 0; i < attempts; i++) {
    try {
      return await fn();
    } catch (err) {
      const retryable =
        err instanceof VinrError &&
        ['rate_limited', 'internal_error', 'service_unavailable', 'processing_error'].includes(err.code);
      if (!retryable || i === attempts - 1) throw err;
      const wait = err.retryAfter ?? Math.min(2 ** i * 200, 5000) + Math.random() * 200;
      await new Promise((r) => setTimeout(r, wait));
    }
  }
  throw new Error('unreachable');
}