For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL.

Skip to content
Paddle Docs home

Payment method is unknown

Your request includes a payment method that Paddle doesn't recognize.

Example response
{
"error": {
"type": "request_error",
"code": "checkout_payment_method_unknown",
"detail": "Unknown payment method.",
"documentation_url": "https://developer.paddle.com/errors/checkout_payment_methods/checkout_payment_method_unknown"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
400
Error code
checkout_payment_method_unknown
Error message
Unknown payment method.

Common causes

  • The request includes a payment method key that Paddle doesn't recognize, like a misspelled key.

Troubleshooting

Was this page helpful?