curl --request POST \
--url https://staging-api.chip-in.asia/api/send/bank_accounts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'checksum: <checksum>' \
--header 'epoch: <epoch>' \
--data '
{
"account_number": "157380112229",
"bank_code": "MBBEMYKL",
"name": "Ahmad Razali",
"reference": "VENDOR-EMP-001"
}
'import requests
url = "https://staging-api.chip-in.asia/api/send/bank_accounts"
payload = {
"account_number": "157380112229",
"bank_code": "MBBEMYKL",
"name": "Ahmad Razali",
"reference": "VENDOR-EMP-001"
}
headers = {
"epoch": "<epoch>",
"checksum": "<checksum>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
epoch: '<epoch>',
checksum: '<checksum>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
account_number: '157380112229',
bank_code: 'MBBEMYKL',
name: 'Ahmad Razali',
reference: 'VENDOR-EMP-001'
})
};
fetch('https://staging-api.chip-in.asia/api/send/bank_accounts', 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://staging-api.chip-in.asia/api/send/bank_accounts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'account_number' => '157380112229',
'bank_code' => 'MBBEMYKL',
'name' => 'Ahmad Razali',
'reference' => 'VENDOR-EMP-001'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"checksum: <checksum>",
"epoch: <epoch>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://staging-api.chip-in.asia/api/send/bank_accounts"
payload := strings.NewReader("{\n \"account_number\": \"157380112229\",\n \"bank_code\": \"MBBEMYKL\",\n \"name\": \"Ahmad Razali\",\n \"reference\": \"VENDOR-EMP-001\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("epoch", "<epoch>")
req.Header.Add("checksum", "<checksum>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://staging-api.chip-in.asia/api/send/bank_accounts")
.header("epoch", "<epoch>")
.header("checksum", "<checksum>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"account_number\": \"157380112229\",\n \"bank_code\": \"MBBEMYKL\",\n \"name\": \"Ahmad Razali\",\n \"reference\": \"VENDOR-EMP-001\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://staging-api.chip-in.asia/api/send/bank_accounts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["epoch"] = '<epoch>'
request["checksum"] = '<checksum>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_number\": \"157380112229\",\n \"bank_code\": \"MBBEMYKL\",\n \"name\": \"Ahmad Razali\",\n \"reference\": \"VENDOR-EMP-001\"\n}"
response = http.request(request)
puts response.read_body{
"id": 84,
"status": "verified",
"account_number": "157380112229",
"bank_code": "MBBEMYKL",
"group_id": null,
"name": "Ahmad Razali",
"reference": "VENDOR-EMP-001",
"created_at": "2023-07-20T08:59:10.766Z",
"is_debiting_account": false,
"is_crediting_account": false,
"updated_at": "2023-07-20T08:59:10.766Z",
"deleted_at": null,
"rejection_reason": null
}{
"message": "Bad request",
"code": 400,
"data": {}
}{
"message": "Unauthorized",
"code": 401,
"data": {}
}{
"message": "You are not authorized to perform this action",
"code": 403,
"data": {}
}{
"message": "Record not found",
"code": 404,
"data": {}
}{
"message": "Too many requests. Please try again later.",
"code": 429,
"data": {
"retry_after": 300
}
}Add a bank account
Adds a bank account using the values provided in the request body. Store the ID returned in the response, as it will be required for subsequent operations.
curl --request POST \
--url https://staging-api.chip-in.asia/api/send/bank_accounts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'checksum: <checksum>' \
--header 'epoch: <epoch>' \
--data '
{
"account_number": "157380112229",
"bank_code": "MBBEMYKL",
"name": "Ahmad Razali",
"reference": "VENDOR-EMP-001"
}
'import requests
url = "https://staging-api.chip-in.asia/api/send/bank_accounts"
payload = {
"account_number": "157380112229",
"bank_code": "MBBEMYKL",
"name": "Ahmad Razali",
"reference": "VENDOR-EMP-001"
}
headers = {
"epoch": "<epoch>",
"checksum": "<checksum>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
epoch: '<epoch>',
checksum: '<checksum>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
account_number: '157380112229',
bank_code: 'MBBEMYKL',
name: 'Ahmad Razali',
reference: 'VENDOR-EMP-001'
})
};
fetch('https://staging-api.chip-in.asia/api/send/bank_accounts', 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://staging-api.chip-in.asia/api/send/bank_accounts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'account_number' => '157380112229',
'bank_code' => 'MBBEMYKL',
'name' => 'Ahmad Razali',
'reference' => 'VENDOR-EMP-001'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"checksum: <checksum>",
"epoch: <epoch>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://staging-api.chip-in.asia/api/send/bank_accounts"
payload := strings.NewReader("{\n \"account_number\": \"157380112229\",\n \"bank_code\": \"MBBEMYKL\",\n \"name\": \"Ahmad Razali\",\n \"reference\": \"VENDOR-EMP-001\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("epoch", "<epoch>")
req.Header.Add("checksum", "<checksum>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://staging-api.chip-in.asia/api/send/bank_accounts")
.header("epoch", "<epoch>")
.header("checksum", "<checksum>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"account_number\": \"157380112229\",\n \"bank_code\": \"MBBEMYKL\",\n \"name\": \"Ahmad Razali\",\n \"reference\": \"VENDOR-EMP-001\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://staging-api.chip-in.asia/api/send/bank_accounts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["epoch"] = '<epoch>'
request["checksum"] = '<checksum>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_number\": \"157380112229\",\n \"bank_code\": \"MBBEMYKL\",\n \"name\": \"Ahmad Razali\",\n \"reference\": \"VENDOR-EMP-001\"\n}"
response = http.request(request)
puts response.read_body{
"id": 84,
"status": "verified",
"account_number": "157380112229",
"bank_code": "MBBEMYKL",
"group_id": null,
"name": "Ahmad Razali",
"reference": "VENDOR-EMP-001",
"created_at": "2023-07-20T08:59:10.766Z",
"is_debiting_account": false,
"is_crediting_account": false,
"updated_at": "2023-07-20T08:59:10.766Z",
"deleted_at": null,
"rejection_reason": null
}{
"message": "Bad request",
"code": 400,
"data": {}
}{
"message": "Unauthorized",
"code": 401,
"data": {}
}{
"message": "You are not authorized to perform this action",
"code": 403,
"data": {}
}{
"message": "Record not found",
"code": 404,
"data": {}
}{
"message": "Too many requests. Please try again later.",
"code": 429,
"data": {
"retry_after": 300
}
}.json suffix counts toward the same limit. See Rate limits.bank_code must be one of the codes on Supported banks, which also lists the account-number length each bank expects.Verification
A successful registration does not mean the account can receive payouts yet. Every account is verified with the bank first, andstatus reports where that verification stands:
status | Meaning |
|---|---|
received | The account was created; verification has not started |
pending | Verification with the bank is in progress |
verified | The bank confirmed the account; it can be used for send instructions |
rejected | The bank refused to confirm the account |
reviewing | CHIP is reviewing the account manually, typically within 2 working days |
verified, rejected or reviewing, including the bank-verified name. While the account is still received or pending, wait for a bank_account_status webhook or poll Retrieve a bank account instead of treating it as ready. The event payload is the bank-account object itself — see Event Types and Payloads. For that reason the first webhook can report a status other than received.
Rejected accounts
Whenstatus is rejected, rejection_reason carries a plain-language reason (for example Invalid crediting account.) and the account cannot be used to create a send instruction. For every other status, rejection_reason is null.
Correct the account details before registering again. Registering the same account_number and bank_code within an hour returns the same rejected account; after that it can be registered again, but if nothing about the account has changed, expect the same result. When the account number or the bank was wrong, register the corrected details.
To exercise this path on staging, register an account number ending in 0000 — see Simulating a rejected bank account.
Reviewed manually
reviewing means CHIP is checking the account manually. It cannot be used for send instructions until it is verified. Reviews are typically completed within 2 working days; contact CHIP support if it takes longer.
Holder name after verification
Until the account isverified, name is the name you submitted (uppercased). Once status is verified, name is the account holder name the bank returned, which is not necessarily the name that was submitted — treat it as the bank-verified holder name and show it to your user for confirmation before paying.
Use reference for your own label or identifier: CHIP never replaces it with bank data, whereas name is replaced by the bank-verified value. You can change reference by registering the same account again. Re-registering an account that is already verified does not change the stored name.Authorizations
Headers
Body
Request body for registering a recipient bank account.
The number of digits depends on the recipient bank — some banks use a fixed length, others accept a range. See the per-bank list on Supported banks.
5 - 17"157380112222"
Malaysian bank identifier in BIC/SWIFT form. This is the complete set of codes
accepted by POST /send/bank_accounts.
This is not the FPX bank code used for CHIP Collect FPX checkouts
(MB2U0227, ABB0233, PBB0233, …). The two lists identify banks on
different networks and are not interchangeable.
ACDBMYK2: AEON Bank (M) BerhadPHBMMYKL: Affin Bank BerhadAGOBMYKL: AgrobankRJHIMYKL: Al Rajhi BankMFBBMYKL: Alliance Bank Malaysia BerhadARBKMYKL: AmBank Malaysia BerhadBIMBMYKL: Bank Islam Malaysia BerhadBKRMMYKL: Bank Kerjasama Rakyat Malaysia BerhadBMMBMYKL: Bank Muamalat Malaysia BerhadBOFAMY2X: Bank of America (M) BerhadBKCHMYKL: Bank of China (M) BerhadBOTKMYKX: MUFG Bank (Malaysia) BerhadBSNAMYK1: Bank Simpanan Nasional BerhadBNPAMYKL: BNP Paribas Malaysia BerhadBOBEMYK2: BOOST Bank BerhadPCBCMYKL: China Construction Bank (M) BerhadCIBBMYKL: CIMB Bank BerhadCITIMYKL: Citibank BerhadDEUTMYKL: Deutsche Bank (Malaysia) BerhadFNXSMYNB: Finexus Cards Sdn. Bhd.GXSPMYKL: GX Bank BerhadHLBBMYKL: Hong Leong Bank BerhadHBMBMYKL: HSBC Bank Malaysia BerhadICBKMYKL: Industrial and Commercial Bank of China (M) BerhadCHASMYKX: JP Morgan Chase Bank BerhadKFHOMYKL: Kuwait Finance HouseMBBEMYKL: Maybank BerhadAFBQMYKL: MBSB Bank BerhadMHCBMYKA: Mizuho Bank (Malaysia) BerhadOCBCMYKL: OCBC Bank BerhadPBBEMYKL: Public Bank BerhadRHBBMYKL: RHB Bank BerhadSCCHMYKL: RYT BankSCBLMYKX: Standard Chartered Bank Malaysia BerhadSMBCMYKL: Sumitomo Mitsui Banking Corporation (M) BerhadTNGDMYNB: TNG Digital (Touch 'n Go eWallet)UOVBMYKL: United Overseas Bank Berhad (UOB)
ACDBMYK2, PHBMMYKL, AGOBMYKL, RJHIMYKL, MFBBMYKL, ARBKMYKL, BIMBMYKL, BKRMMYKL, BMMBMYKL, BOFAMY2X, BKCHMYKL, BOTKMYKX, BSNAMYK1, BNPAMYKL, BOBEMYK2, PCBCMYKL, CIBBMYKL, CITIMYKL, DEUTMYKL, FNXSMYNB, GXSPMYKL, HLBBMYKL, HBMBMYKL, ICBKMYKL, CHASMYKX, KFHOMYKL, MBBEMYKL, AFBQMYKL, MHCBMYKA, OCBCMYKL, PBBEMYKL, RHBBMYKL, SCCHMYKL, SCBLMYKX, SMBCMYKL, TNGDMYNB, UOVBMYKL "MBBEMYKL"
Response
Successful response
A recipient bank account registered for payouts.
The number of digits depends on the recipient bank — some banks use a fixed length, others accept a range. See the per-bank list on Supported banks.
5 - 17"157380112222"
Malaysian bank identifier in BIC/SWIFT form. This is the complete set of codes
accepted by POST /send/bank_accounts.
This is not the FPX bank code used for CHIP Collect FPX checkouts
(MB2U0227, ABB0233, PBB0233, …). The two lists identify banks on
different networks and are not interchangeable.
ACDBMYK2: AEON Bank (M) BerhadPHBMMYKL: Affin Bank BerhadAGOBMYKL: AgrobankRJHIMYKL: Al Rajhi BankMFBBMYKL: Alliance Bank Malaysia BerhadARBKMYKL: AmBank Malaysia BerhadBIMBMYKL: Bank Islam Malaysia BerhadBKRMMYKL: Bank Kerjasama Rakyat Malaysia BerhadBMMBMYKL: Bank Muamalat Malaysia BerhadBOFAMY2X: Bank of America (M) BerhadBKCHMYKL: Bank of China (M) BerhadBOTKMYKX: MUFG Bank (Malaysia) BerhadBSNAMYK1: Bank Simpanan Nasional BerhadBNPAMYKL: BNP Paribas Malaysia BerhadBOBEMYK2: BOOST Bank BerhadPCBCMYKL: China Construction Bank (M) BerhadCIBBMYKL: CIMB Bank BerhadCITIMYKL: Citibank BerhadDEUTMYKL: Deutsche Bank (Malaysia) BerhadFNXSMYNB: Finexus Cards Sdn. Bhd.GXSPMYKL: GX Bank BerhadHLBBMYKL: Hong Leong Bank BerhadHBMBMYKL: HSBC Bank Malaysia BerhadICBKMYKL: Industrial and Commercial Bank of China (M) BerhadCHASMYKX: JP Morgan Chase Bank BerhadKFHOMYKL: Kuwait Finance HouseMBBEMYKL: Maybank BerhadAFBQMYKL: MBSB Bank BerhadMHCBMYKA: Mizuho Bank (Malaysia) BerhadOCBCMYKL: OCBC Bank BerhadPBBEMYKL: Public Bank BerhadRHBBMYKL: RHB Bank BerhadSCCHMYKL: RYT BankSCBLMYKX: Standard Chartered Bank Malaysia BerhadSMBCMYKL: Sumitomo Mitsui Banking Corporation (M) BerhadTNGDMYNB: TNG Digital (Touch 'n Go eWallet)UOVBMYKL: United Overseas Bank Berhad (UOB)
ACDBMYK2, PHBMMYKL, AGOBMYKL, RJHIMYKL, MFBBMYKL, ARBKMYKL, BIMBMYKL, BKRMMYKL, BMMBMYKL, BOFAMY2X, BKCHMYKL, BOTKMYKX, BSNAMYK1, BNPAMYKL, BOBEMYK2, PCBCMYKL, CIBBMYKL, CITIMYKL, DEUTMYKL, FNXSMYNB, GXSPMYKL, HLBBMYKL, HBMBMYKL, ICBKMYKL, CHASMYKX, KFHOMYKL, MBBEMYKL, AFBQMYKL, MHCBMYKA, OCBCMYKL, PBBEMYKL, RHBBMYKL, SCCHMYKL, SCBLMYKX, SMBCMYKL, TNGDMYNB, UOVBMYKL "MBBEMYKL"
The account holder name, in uppercase.
Until the account is verified this is the name submitted at registration. Once
status is verified it is the name the bank returned, which may differ from the name
that was sent. Show it to your user for confirmation before paying, and keep your own
label or identifier in reference.
Registering an account that is already verified again does not change this value.
1 - 65535"Ahmad Razali"
received: The bank account has been created and verification has not started yet.pending: Verification of the bank account with the bank is in progress.verified: The bank has confirmed the bank account, so it can be used for send instructions.rejected: The bank refused to confirm the bank account, so it cannot be used for send instructions;rejection_reasonexplains why.reviewing: CHIP is reviewing the bank account manually; it cannot be used for send instructions until it isverified.
received and pending are not final: wait for a bank_account_status webhook or retrieve the bank account again.
A reviewing account is typically reviewed within 2 working days; contact CHIP support if it takes longer.
A rejected account can be registered again once the rejection is more than one hour old. If nothing about the account has changed, expect the same result, so correct the account details first.
received, pending, verified, rejected, reviewing "verified"
Your own label or identifier for the bank account. CHIP never replaces it with bank data.
Use this instead of name when you need a value that survives verification: name is
replaced by the bank-verified holder name once verification succeeds. You can change
reference by registering the same account again.
1 - 65535"VENDOR-EMP-001"
A plain-language reason why the bank account was rejected.
Populated only when status is rejected; null for every other status. It describes
the problem the bank reported, so correct the account details (or the bank-side problem)
before registering the account again.
65535"Invalid crediting account."