Errors

{
  "error": {
    "type": "card_error",
    "code": "card_declined",
    "decline_code": "insufficient_funds",
    "message": "The card was declined due to insufficient funds.",
    "param": "payment_method",
    "doc_url": "https://docs.vinr.com/docs/api-reference/errors#card_declined",
    "request_id": "req_8Fq2zX1m4Kd",
    "resource": "pay_3Nf0kLp9aQ"
  }
}

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

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

async function charge() {
  try {
    return await vinr.payments.create({
      amount: 1000,
      currency: 'EUR',
      returnUrl: 'https://shop.example.com/return',
    });
  } catch (err) {
    if (err instanceof VinrError) {
      switch (err.type) {
        case 'card_error':
          // Surface a generic message; log the precise reason.
          console.warn(`Declined (${err.decline_code}) req=${err.request_id}`);
          throw new Error('Your card was declined. Please try another method.');
        case 'rate_limit_error':
        case 'api_error':
          // Transient — caller should retry with backoff.
          throw err;
        default:
          // Programming or auth error — do not retry.
          console.error(`Unrecoverable: ${err.code} (${err.message})`);
          throw err;
      }
    }
    throw err;
  }
}

async function withRetry<T>(fn: () => Promise<T>, max = 4): Promise<T> {
  for (let attempt = 0; ; attempt++) {
    try {
      return await fn();
    } catch (err) {
      const retryable =
        err instanceof VinrError &&
        (err.type === 'rate_limit_error' || err.type === 'api_error');
      if (!retryable || attempt >= max) throw err;
      const delay = Math.min(2 ** attempt * 200, 4000) + Math.random() * 200;
      await new Promise((r) => setTimeout(r, delay));
    }
  }
}