Skip to content

config_unsupported_payment_method

Property Value
Specific code (in type) config_unsupported_payment_method
errorCode field validation_failed
HTTP Status 400 Bad Request
Title Validation failed

Description

The specified payment method is not configured or not available for your merchant account.

Example Response

{
  "type": "https://docs.payalo.com/errors/config_unsupported_payment_method",
  "title": "Validation failed",
  "status": 400,
  "detail": "Payment method not valid.",
  "errorCode": "validation_failed"
}

Programmatic detection: branch on the final segment of the type URL — errorCode is the generic "validation_failed" for every 400 validation cause. See How to read these errors.

Common Causes

  • The {method} route parameter contains a payment method key that is not enabled for your brand.
  • The payment method exists but is not available for the specified country.
  • The payment method key is misspelled or incorrect.

Resolution

  • Verify the payment method key in the URL path (e.g., mpesa-ke, airtel-ke, card-eu).
  • Contact your account manager to confirm which payment methods are enabled for your brand and in which countries.

Note: This error is not retryable with the same payment method.