Error Codes

{
  "error": "Validation failed: amount: Required",
  "code": "VALIDATION_ERROR",
  "details": {
    "fieldErrors": { "amount": ["Required"] },
    "formErrors": []
  }
}

async function createPayment(amount, currency) {
  const response = await fetch('https://vexutopia.com/api/v1/payments', {
    method: 'POST',
    headers: {
      'X-API-Key': 'vex_test_your_api_key',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ amount, currency })
  });

  const data = await response.json();

  if (!response.ok) {
    // Handle the error based on the code
    switch (data.code) {
      case 'INVALID_API_KEY':
      case 'MISSING_API_KEY':
      case 'REVOKED_API_KEY':
      case 'EXPIRED_API_KEY':
        throw new Error('Check your API key configuration');
      case 'VALIDATION_ERROR':
        throw new Error(`Invalid request: ${data.error}`);
      case 'NO_PROVIDER_AVAILABLE':
        throw new Error('No provider available for this currency/country/method');
      case 'PAYMENT_METHOD_MAINTENANCE':
      case 'MASTERCARD_MAINTENANCE':
      case 'CARD_DIRECT_MAINTENANCE':
        // Temporary: retry later, or offer the customer another method.
        // data.methods lists what is down, e.g. ["gift_card"].
        throw new Error(data.error);
      case 'RATE_LIMITED': {
        // Honour Retry-After (in seconds) and retry once
        const retryAfter = Number(response.headers.get('Retry-After') ?? '1');
        await new Promise(r => setTimeout(r, retryAfter * 1000));
        return createPayment(amount, currency);
      }
      case 'PROVIDER_UPSTREAM_UNAVAILABLE':
        // Safe to retry with backoff
        throw new Error('Provider temporarily unavailable, retry shortly');
      default:
        throw new Error(data.error);
    }
  }

  return data;
}