Errors

{
  "status": "400",
  "message": "You don't have enough funds for this transfer. Your available balance is 1,250.00 USD.",
  "type": "error_transfer_insufficient_funds"
}

{
  "status": "422",
  "message": "Validation failed for one or more fields.",
  "type": "error_validation_error",
  "validations": [
    {
      "email": {
        "error_type": "error_validation_email_invalid",
        "message": "That email address doesn't look right. Please check it and try again."
      }
    },
    {
      "phone": {
        "error_type": "error_validation_phone_invalid",
        "message": "Please enter a valid phone number with country code (e.g., +1234567890)."
      }
    }
  ]
}

const response = await fetch('https://api.nuvion.dev/transfers', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${API_KEY}` },
  body: JSON.stringify(payload)
});

if (!response.ok) {
  const error = await response.json();

  switch (error.type) {
    case 'error_transfer_insufficient_funds':
      // Prompt the user to fund their account
      break;
    case 'error_auth_rate_limit_exceeded':
      // Back off and retry after a delay
      break;
    case 'error_validation_error':
      // Surface field-level errors from error.validations
      break;
    default:
      // Log the error and surface error.message to the user
  }
}