List of payment methods

curl --request GET \
  --url https://gate.chip-in.asia/api/v1/payment_methods/ \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://gate.chip-in.asia/api/v1/payment_methods/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gate.chip-in.asia/api/v1/payment_methods/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://gate.chip-in.asia/api/v1/payment_methods/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://gate.chip-in.asia/api/v1/payment_methods/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "available_payment_methods": [
    "visa",
    "mastercard",
    "maestro"
  ],
  "by_country": {
    "any": [
      "card"
    ],
    "GB": [
      "maestro"
    ]
  },
  "country_names": {
    "any": "Other",
    "GB": "United Kingdom"
  },
  "names": {
    "visa": "Visa",
    "mastercard": "Mastercard",
    "maestro": "Maestro"
  },
  "logos": {
    "maestro": "/static/images/icon-maestro.svg",
    "visa": "/static/images/icon-visa.svg",
    "mastercard": "/static/images/icon-mastercard.svg"
  },
  "card_methods": [
    "visa",
    "mastercard",
    "maestro"
  ]
}

"{\n  \"__all__\": {\n    \"message\": \"descriptive error message\",\n    \"code\": \"error_code\"\n  }\n}\n"

Payment methods

List of payment methods

Always send the amount query parameter, e.g. &amount=1000 for RM 10. Without it, only card methods (visa, mastercard, maestro) and a few others are returned — most methods (FPX, DuitNow QR, Shopee Pay, etc.) have a minimum amount and are hidden from the response.

RM 10 (1000) is a safe value that covers every method’s minimum.

Send this request providing the brand_id and currency query parameters, with 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&currency=MYR&amount=1000

GET

payment_methods

List of payment methods

curl --request GET \
  --url https://gate.chip-in.asia/api/v1/payment_methods/ \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://gate.chip-in.asia/api/v1/payment_methods/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gate.chip-in.asia/api/v1/payment_methods/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://gate.chip-in.asia/api/v1/payment_methods/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://gate.chip-in.asia/api/v1/payment_methods/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "available_payment_methods": [
    "visa",
    "mastercard",
    "maestro"
  ],
  "by_country": {
    "any": [
      "card"
    ],
    "GB": [
      "maestro"
    ]
  },
  "country_names": {
    "any": "Other",
    "GB": "United Kingdom"
  },
  "names": {
    "visa": "Visa",
    "mastercard": "Mastercard",
    "maestro": "Maestro"
  },
  "logos": {
    "maestro": "/static/images/icon-maestro.svg",
    "visa": "/static/images/icon-visa.svg",
    "mastercard": "/static/images/icon-mastercard.svg"
  },
  "card_methods": [
    "visa",
    "mastercard",
    "maestro"
  ]
}

"{\n  \"__all__\": {\n    \"message\": \"descriptive error message\",\n    \"code\": \"error_code\"\n  }\n}\n"

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

brand_id

string

required

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

enum<string>

required

Currency you'd use in your Purchase in ISO 4217 format, e.g. MYR.

Available options:

MYR

country

string

Country code in the ISO 3166-1 alpha-2 format (e.g. GB). Optional.

recurring

boolean

If provided in the format of recurring=true, will filter out the methods that don't support recurring charges (see POST /purchases/{id}/charge/).

skip_capture

boolean

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).

preauthorization

boolean

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

string

Language code in the ISO 639-1 format (e.g. 'en'). Optional.

amount

integer

Amount of money as the smallest indivisible units of the currency (e.g. 1000 for RM 10). Strongly recommended in practice even though it's marked optional in the schema — most payment methods (FPX, DuitNow QR, Shopee Pay, etc.) have a minimum amount, and omitting this parameter hides them from the response. Use a value at or above the highest minimum among the methods you want to expose; RM 10 (1000) is a safe default.

Response

available_payment_methods

string[]

Name of the payment method, e.g. visa.

by_country

object

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.

Show child attributes

country_names

object

Human-readable names corresponding to country codes as returned by by_country property. any code is also decoded to Other.

Show child attributes

names

object

Human-readable names of payment methods as returned by available_payment_methods property.

Show child attributes

logos

object

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.

Show child attributes

card_methods

string[]

Names of the card methods listed in available_payment_methods property. All of these are grouped under card in other properties like by_country.

Overview

Integrate with AI agents

API Reference

List of payment methods

Authorizations

Query Parameters

Response