Errors

{
  "error": {
    "code": "validation_failed",
    "message": "amount: amount must be a positive integer string",
    "issues": [{ "path": "amount", "message": "amount must be a positive integer string" }],
    "request_id": "dZCmlkmVS5ushD7DVOLIQQ"
  }
}

function explain(code: MerchantErrorCode): string {
  switch (code) {
    case "api_key_missing":
    case "api_key_malformed":
    case "api_key_invalid":
    case "api_key_revoked":
      return "Authentication problem. Check your key."
    case "ip_not_allowed":
      return "This network is not allowed for the merchant."
    case "rate_limited":
      return "Slow down. Retry after a backoff."
    case "validation_failed":
      return "Request shape is wrong. Fix it, then send with a new key."
    case "payment_method_invalid":
      return "The Provider declined the payment method. Ask the payer for another method."
    case "currency_not_enabled":
    case "country_not_enabled":
      return "This currency or country is not enabled for the Merchant."
    case "payment_surface_not_allowed":
      return "Team policy blocks this checkout constraint."
    case "payment_configuration_unavailable":
    case "payment_method_unavailable":
    case "payout_configuration_unavailable":
      return "No configured execution supports this method or option."
    case "invalid_state":
      return "The intent is not in a state that allows this action."
    case "amount_below_minimum":
    case "amount_above_maximum":
    case "insufficient_available_balance":
    case "quota_exceeded":
    case "outside_operating_hours":
      return "Business rule blocked the request."
    case "duplicate_merchant_reference":
      return "This merchant_reference exists. Reconcile with the existing intent."
    case "idempotency_conflict":
      return "The key was used with other fields, or the first request is in flight. Do not resend with this key."
    case "merchant_inactive":
      return "Merchant state blocks this operation."
    case "not_found":
      return "Not found in this environment."
    case "balance_unavailable":
    case "internal_error":
      return "Platform error. Wait for Retry-After on a 503, then retry with the same key."
    case "approval_required":
    case "approval_not_required":
      return "Reserved. Merchant API v1 does not send it."
  }
}