Get Payment Methods
Retrieve the payment methods available for a given currency and amount.
Overview
Before presenting payment options to your customer, you can query kadosei to find out which payment methods are available for your application, currency, and transaction amount. This is useful for showing or hiding payment options in your checkout UI dynamically.
This endpoint uses your application API key for authentication, not a JWT.
List available payment methods
GET /api/v1/payment-methods?currency=AUD&amount=140.76
Both currency and amount are required. currency must be an uppercase ISO 4217 code (e.g. AUD, EUR). amount is a decimal string.
{
"paymentMethods": [
"card",
"bnpl"
],
"warnings": [
"No active payment provider connections found"
]
}
warnings is optional and will only appear when there are non-blocking constraints affecting availability. For example, a provider that supports a method is configured but not currently active. A 200 response with an empty paymentMethods array and a populated warnings array means no methods are available but the request itself was valid.
Errors
| Status | Description |
|---|---|
| 400 | currency or amount is missing or invalid |
| 401 | Missing or invalid API key |
| 502 | A dependent service is currently unavailable |
| 504 | A dependent service did not respond in time |
What's next
With payment methods confirmed, see [Refunds] for handling post-payment refund requests.