cardsGet Payment Options

Payment options will differ from the ones offered directly on Malum, direct local options are not available due to timed processing.

Retrieve available payment options for a given fiat amount and currency. The API converts the amount to USD internally and returns payment options based on the USD value.

Method: GET Endpoint: https://malum.co/api/v3/reseller/payment_options Response format: JSON


Required query parameters

Parameter
Type
Example
Notes

fiat_amount

number

49.99

Must be > 0 and <= 10000

fiat_currency

string

EUR

Must be exactly 3 letters, uppercased internally


Validation rules

  • Only GET parameters are processed.

  • fiat_currency must be exactly 3 letters (for example EUR, USD).

  • fiat_amount must be greater than 0 and not greater than 10000.

  • Fiat currency must be supported by the reseller system.

  • If fiat_currency is not USD, an exchange rate is fetched and the amount is converted to USD.

  • Payment options are calculated using the USD base amount.


Example request

GET https://malum.co/api/v3/reseller/payment_options?fiat_amount=49.99&fiat_currency=EUR

Success response

Field notes

  • base_in_usd is the computed USD amount used for option selection.

  • payment_options is returned as an array (the backend converts internal objects into arrays before responding).


Error responses

Errors return JSON with:

  • status: failed

  • message: a human-readable error message

  • data: usually an empty object/array

Common messages include:

  • Invalid fiat currency.

  • Invalid fiat amount.

  • The requested fiat currency is not supported.

  • Could not retrieve exchange rate for the requested fiat currency.

  • An error occurred, please try again later.

Last updated