Add a bank account

POST

send

bank_accounts

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": "157380111111",
  "bank_code": "MBBEMYKL",
  "name": "Ahmad Pintu"
}'

{
  "id": 84,
  "status": "verified",
  "account_number": "157380111111",
  "bank_code": "MBBEMYKL",
  "group_id": null,
  "name": "Ahmad Pintu",
  "reference": null,
  "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
}

Authorizations

Authorization

string

header

required

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

Headers

epoch

integer

required

Unix epoch timestamp

Example:

1619740800

checksum

string

required

Refer to checksum calculation

Body

application/json

This is bank account schema

account_number

string

required

The length depends on recipient bank

Example:

157380112222

bank_code

enum<string>

required

ACDBMYK2: AEON Bank (M) Berhad
PHBMMYKL: Affin Bank Berhad
AGOBMYKL: Agrobank
RJHIMYKL: Al-Rajhi
MFBBMYKL: Alliance Bank Malaysia Berhad
ARBKMYKL: Ambank Malaysia Berhad
BIMBMYKL: Bank Islam Malaysia Berhad
BKRMMYKL: Bank Kerjasama Rakyat Malaysia Berhad
BMMBMYKL: Bank Muamalat Malaysia Bhd
BOFAMY2X: Bank of America (M) Berhad
BKCHMYKL: Bank of China (M) Berhad
BOTKMYKX: Bank of Tokyo-Mitsubishi UFJ (M) Berhad
BSNAMYK1: Bank Simpanan Nasional Berhad
BNPAMYKL: BNP Paribas Malaysia Berhad
PCBCMYKL: China Construction Bank (M) Berhad
CIBBMYKL: CIMB Bank Berhad
DEUTMYKL: Deutsche Bank (Malaysia) Berhad
FNXSMYNB: Finexus Cards Sdn. Bhd.
GXSPMYKL: GX Bank Berhad
HLBBMYKL: Hong Leong Bank Berhad
HBMBMYKL: HSBC Bank Malaysia Berhad
ICBKMYKL: Industrial and Commercial Bank of China (M) Berhad
CHASMYKX: JP Morgan Chase Bank Berhad
KFHOMYKL: Kuwait Finance House
MBBEMYKL: Maybank Berhad
AFBQMYKL: MBSB BANK BERHAD
MHCBMYKA: Mizuho Bank (Malaysia) Berhad
OCBCMYKL: OCBC Bank Berhad
PBBEMYKL: Public Bank Berhad
RHBBMYKL: RHB Bank Berhad
SCBLMYKX: Standard Chartered Bank Malaysia Berhad
SMBCMYKL: Sumitomo Mitsui Banking Corporation (M) Berhad
TNGDMYNB: Touch `n Go eWallet
UOVBMYKL: United Overseas Bank Berhad (UOB)

Available options:

PHBMMYKL,

AIBBMYKL,

BPMBMYKL,

MFBBMYKL,

ALSRMYK1,

RJHIMYKL,

ARBKMYKL,

AISLMYKL,

BIMBMYKL,

BKRMMYKL,

BMMBMYKL,

BSNAMYK1,

CIBBMYKL,

CTBBMYKL,

HLBBMYKL,

HLIBMYKL,

HBMBMYKL,

HMABMYKL,

KFHOMYKL,

MBBEMYKL,

MBISMYKL,

OCBCMYKL,

OABBMYKL,

PBBEMYKL,

PIBEMYK1,

RHBBMYKL,

RHBAMYKL,

SCBLMYKX,

UOVBMYKL,

AFBQMYKL,

CHASMYKX

Example:

"MBBEMYKL"

name

string

required

Required string length: 1 - 65535

Example:

"Ahmad"

reference

string

Unique value to prevent multiple submission

Required string length: 1 - 65535

Example:

"abc"

Response

200

application/json

Successful response

This is bank account schema

account_number

string

required

The length depends on recipient bank

Example:

157380112222

bank_code

enum<string>

required

ACDBMYK2: AEON Bank (M) Berhad
PHBMMYKL: Affin Bank Berhad
AGOBMYKL: Agrobank
RJHIMYKL: Al-Rajhi
MFBBMYKL: Alliance Bank Malaysia Berhad
ARBKMYKL: Ambank Malaysia Berhad
BIMBMYKL: Bank Islam Malaysia Berhad
BKRMMYKL: Bank Kerjasama Rakyat Malaysia Berhad
BMMBMYKL: Bank Muamalat Malaysia Bhd
BOFAMY2X: Bank of America (M) Berhad
BKCHMYKL: Bank of China (M) Berhad
BOTKMYKX: Bank of Tokyo-Mitsubishi UFJ (M) Berhad
BSNAMYK1: Bank Simpanan Nasional Berhad
BNPAMYKL: BNP Paribas Malaysia Berhad
PCBCMYKL: China Construction Bank (M) Berhad
CIBBMYKL: CIMB Bank Berhad
DEUTMYKL: Deutsche Bank (Malaysia) Berhad
FNXSMYNB: Finexus Cards Sdn. Bhd.
GXSPMYKL: GX Bank Berhad
HLBBMYKL: Hong Leong Bank Berhad
HBMBMYKL: HSBC Bank Malaysia Berhad
ICBKMYKL: Industrial and Commercial Bank of China (M) Berhad
CHASMYKX: JP Morgan Chase Bank Berhad
KFHOMYKL: Kuwait Finance House
MBBEMYKL: Maybank Berhad
AFBQMYKL: MBSB BANK BERHAD
MHCBMYKA: Mizuho Bank (Malaysia) Berhad
OCBCMYKL: OCBC Bank Berhad
PBBEMYKL: Public Bank Berhad
RHBBMYKL: RHB Bank Berhad
SCBLMYKX: Standard Chartered Bank Malaysia Berhad
SMBCMYKL: Sumitomo Mitsui Banking Corporation (M) Berhad
TNGDMYNB: Touch `n Go eWallet
UOVBMYKL: United Overseas Bank Berhad (UOB)

Available options:

PHBMMYKL,

AIBBMYKL,

BPMBMYKL,

MFBBMYKL,

ALSRMYK1,

RJHIMYKL,

ARBKMYKL,

AISLMYKL,

BIMBMYKL,

BKRMMYKL,

BMMBMYKL,

BSNAMYK1,

CIBBMYKL,

CTBBMYKL,

HLBBMYKL,

HLIBMYKL,

HBMBMYKL,

HMABMYKL,

KFHOMYKL,

MBBEMYKL,

MBISMYKL,

OCBCMYKL,

OABBMYKL,

PBBEMYKL,

PIBEMYK1,

RHBBMYKL,

RHBAMYKL,

SCBLMYKX,

UOVBMYKL,

AFBQMYKL,

CHASMYKX

Example:

"MBBEMYKL"

name

string

required

Required string length: 1 - 65535

Example:

"Ahmad"

integer

The ID given in the respone must be stored as it will be used for later process.

Example:

1

status

enum<string>

pending: The bank account is yet to be verified
verified: Valid bank account
rejected: Invalid bank account

Available options:

pending,

verified,

rejected

Example:

"verified"

group_id

integer | null

Example:

null

reference

string

Unique value to prevent multiple submission

Required string length: 1 - 65535

Example:

"abc"

created_at

string

Object creation time in UTC

is_debiting_account

boolean

Example:

false

is_crediting_account

boolean

Example:

false

updated_at

string

Object creation time in UTC

deleted_at

string

Object creation time in UTC

rejection_reason

string | null

Maximum length: 65535

Example:

null

Resend approval request Retrieve a bank account

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": "157380111111",
  "bank_code": "MBBEMYKL",
  "name": "Ahmad Pintu"
}'

{
  "id": 84,
  "status": "verified",
  "account_number": "157380111111",
  "bank_code": "MBBEMYKL",
  "group_id": null,
  "name": "Ahmad Pintu",
  "reference": null,
  "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
}

API Reference

Accounts

Send Limits

Bank Accounts

Send Instructions

Groups

Webhooks

Add a bank account

Authorizations

Headers

Body

Response