List of payment methods
Send this request providing, at the very least, the brand_id
and currency
query parameters having the same values you’d use to create your Purchase. Be sure to use the same API key you’ll create your Purchase with; it will define the test_mode setting used in the lookup.
In the response body you’ll receive an object with available_payment_methods
property containing the list of payment method names available to use with your Purchase (e.g. those codes can be used in payment_method_whitelist
field or with ?preferred={payment_method}
option of checkout_url
).
Please note that all lookup arguments must be provided via query parameters after the endpoint, e.g. the minimal call would be similar to: GET /api/v1/payment_methods/?brand_id=75a76529-91c7-4d98-90a9-8a641d70ee52¤cy=MYR
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
Which brand would you like to lookup the available payment methods for. Use the same value (UUID) you'd set the Purchase.brand_id
to.
Currency you'd use in your Purchase in ISO 4217 format, e.g. EUR
.
MYR
Country code in the ISO 3166-1 alpha-2 format (e.g. GB
). Optional.
If provided in the format of recurring=true
, will filter out the methods that don't support recurring charges (see POST /purchases/{id}/charge/
).
If provided in the format of skip_capture=true
, will filter out the methods that don't support skip_capture
functionality (see the description for Purchase.skip_capture field
).
If provided in the format of preauthorization=true
, will filter out the methods that don't support preauthorization functionality (see the description for Purchase.skip_capture field
).
Language code in the ISO 639-1 format (e.g. 'en'). Optional.
Amount of money as the smallest indivisible units of the currency. Some payment method like FPX are not available when purchase is below than RM 1. Optional.
Response
Payment method names (as returned by available_payment_methods
) grouped by country codes they are available in. any
key returns names of payment method available in all countries.
Human-readable names corresponding to country codes as returned by by_country
property. any
code is also decoded to Other
.
Human-readable names of payment methods as returned by available_payment_methods
property.
Mapping of payment method names to respective logo file paths (relative to the hostname of API host). Some methods can be displayed as an array of logos.