Merchant API
Payment Methods

List payment method options

Return the payment methods enabled for the authenticating merchant in the API key's environment. Method codes are the public platform enum; provider-local codes stay internal.

GET
/payment_methods/options

Return the payment methods enabled for the authenticating merchant in the API key's environment. Method codes are the public platform enum; provider-local codes stay internal.

Authorization

apiKey
AuthorizationBasic <token>

Merchant API key pair. Send as Authorization: Basic base64(publicKey:secretKey) — username is the public key (pk_live_… / pk_test_…), password is the secret key (sk_live_… / sk_test_…). The public key prefix determines the environment of every order created by the request — there is no body, query, or header override.

In: header

Query Parameters

country*string

ISO 3166-1 alpha-2 country code, e.g. "MY".

currency*string

ISO 4217 currency code (e.g. "MYR", "USD") or a 3–6 letter token symbol. Uppercase.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/payment_methods/options?country=MY&currency=MYR"
{
  "country": "MY",
  "currency": "MYR",
  "environment": "test",
  "methods": [
    {
      "category": "bank_redirect",
      "code": "FPX",
      "label": "Online banking",
      "next_action_types": [
        "redirect_to_url"
      ],
      "options": {
        "fpx_banks": [
          {
            "code": "MB2U0227",
            "label": "Maybank2U",
            "segment": "b2c"
          }
        ]
      }
    }
  ]
}
{
  "error": {
    "code": "validation_failed",
    "message": "Currency XYZ is not enabled for this merchant."
  }
}
{
  "error": {
    "code": "validation_failed",
    "message": "Currency XYZ is not enabled for this merchant."
  }
}
{
  "error": {
    "code": "validation_failed",
    "message": "Currency XYZ is not enabled for this merchant."
  }
}
{
  "error": {
    "code": "validation_failed",
    "message": "Currency XYZ is not enabled for this merchant."
  }
}

Create a payment intent POST

Create a payment intent. Idempotent on the merchant reference: a repeat POST with the same `merchant_reference` returns the original intent rather than creating a duplicate. The key's environment stamps the intent; there is no body or query override.

List payout intents GET

List payout intents for the authenticating merchant in the key's environment, ordered most-recent-first. Walk pages via `next_cursor`. Filters narrow the set; cursor and filters are independent; apply the filters again on each page request.