Market specifications

Do you want to know more information about Malaysia's market? Go to the Accelerate Growth in Asia's Leading eCommerce Hubs article.

Country reference

`country` code	`currency` code	`amount` decimals	`beneficiary.document.type` name	`beneficiary.document.id` format
`MY`	`MYR`	2	NRIC	12 digits

Mandatory parameters

Bank transfers

Bank transfer parameters	B2C	B2B	P2P
`external_id`	Yes	Yes	Yes
`payment_method_id`	Yes	Yes	Yes
`flow_type`	Yes	Yes	Yes
`purpose`	Yes	Yes	Yes
`amount`	Yes	Yes	Yes
`currency`	Yes	Yes	Yes
`country`	Yes	Yes	Yes
`beneficiary.first_name`	Yes	-	Yes
`beneficiary.last_name`	Yes	-	Yes
`beneficiary.business_name`	-	Yes	-
`beneficiary.bank_account.account`	Yes	Yes	Yes
`beneficiary.bank_account.code`	Yes	Yes	Yes
`remitter.first_name`	-	-	Yes
`remitter.last_name`	-	-	Yes
`remitter.document.id`	-	-	Yes
`remitter.document.type`	-	-	Yes
`remitter.address.street`	-	-	Yes
`remitter.address.city`	-	-	Yes
`remitter.address.country`	-	-	Yes

Wallet transfers

Wallet transfer parameters	B2C	B2B	P2P
`external_id`	Yes	Yes	Yes
`payment_method_id`	Yes	Yes	Yes
`flow_type`	Yes	Yes	Yes
`purpose`	Yes	Yes	Yes
`amount`	Yes	Yes	Yes
`currency`	Yes	Yes	Yes
`country`	Yes	Yes	Yes
`beneficiary.first_name`	Yes	-	Yes
`beneficiary.last_name`	Yes	-	Yes
`beneficiary.business_name`	-	Yes	-
`instant_payment.id`	Yes	Yes	Yes
`instant_payment.type`	Yes	Yes	Yes
`remitter.first_name`	-	-	Yes
`remitter.last_name`	-	-	Yes
`remitter.document.id`	-	-	Yes
`remitter.document.type`	-	-	Yes
`remitter.address.street`	-	-	Yes
`remitter.address.city`	-	-	Yes
`remitter.address.country`	-	-	Yes

Payment methods

Malaysia supports payouts via Bank transfers and Wallet transfers. Each method requires specific parameters and follows validation rules aligned with local compliance and banking standards.

Use Wallet transfers for instant payments to mobile wallets. Use Bank transfers when sending funds directly to a bank account.

Bank transfers

Bank transfers in Malaysia require detailed account information, including bank account number and bank code. The format of these fields depends on the receiving bank, and strict validation rules apply.

Refer to the bank codes section for format specifications.

Mandatory parameters

All fields listed below are required for bank transfer payouts. For successful processing, ensure correct formatting and value types.

Mandatory parameter	Description
`external_id`	Payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id`	Payment method. For bank transfers, use `BANK_TRANSFER`.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer), `B2B` (Business to Business), or `P2P` (Person to Person).
`purpose`	Payout purpose code. See purpose codes reference.
`country`	Country code. For Malaysia, use `MY`.
`amount`	Payout amount (in the currency set in the `currency` field). Use up to 2 decimal places.
`currency`	Payout currency. For Malaysia, use `MYR` or `USD`.
`beneficiary.first_name`	Beneficiary's first name. Maximum 50 characters.
`beneficiary.last_name`	Beneficiary's last name. Only applies when the beneficiary is an individual. Maximum 50 characters.
`beneficiary.bank_account.account`	Beneficiary's bank account number. Minimum length 10 and maximum length 22.
`beneficiary.bank_account.code`	Beneficiary's bank account code. See available bank codes below.
`remitter.first_name`	Remitter's first name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.last_name`	Remitter's last name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.document.id`	Remitter's document. Maximum 45 characters. Mandatory only for remittance (P2P).
`remitter.document.type`	Remitter's document type: `NI` for national identification number, `PASS` for passport. Mandatory only for remittance (P2P).
`remitter.address.street`	Remitter's address street. Maximum 200 characters. Mandatory only for remittance (P2P).
`remitter.address.city`	Remitter's address city. Maximum 40 characters. Mandatory only for remittance (P2P).
`remitter.address.country`	Remitter's address country. ISO 3166-1 alpha-2 code.. Mandatory only for remittance (P2P).

Example request

{
  "external_id": "1234567812345678",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "country": "MY",
  "beneficiary": {
    "first_name": "JUAN",
    "last_name": "NASCIMENTO",
    "bank_account": {
      "account": "0077870019888776",
      "code": "007"
    }
  },
  "notification_url": "https://thisisawebsite.net",
  "amount": "1100.00",
  "currency": "MYR"
}

Wallet transfers

Wallet transfers enable real-time transfers using a Wallet ID linked to a Touch 'n Go wallet.

The instant_payment.type field must indicate the type of wallet being used (e.g., Touch 'n Go). The instant_payment.id field must be present and correctly formatted as the Wallet ID.

Mandatory parameters

The table below outlines the required parameters for Wallet transfers.

Mandatory parameter	Description
`external_id`	Payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id`	Payment method. For wallet transfers, use `INSTANT_PAYMENT`.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer), `B2B` (Business to Business), or `P2P` (Person to Person).
`purpose`	Payout purpose code. See the purpose codes reference.
`amount`	Payout amount (in the currency set in the `currency` field). Use up to 2 decimal numbers.
`currency`	Payout currency. For Malaysia, use `MYR` or `USD`.
`country`	Country code. For Malaysia, use `MY`.
`beneficiary.first_name`	Beneficiary's first name. Maximum 50 characters.
`beneficiary.last_name`	Beneficiary's last name. Only applies when the beneficiary is an individual. Maximum 50 characters.
`beneficiary.instant_payment.id`	Beneficiary's wallet ID. Maximum 45 characters.
`beneficiary.instant_payment.type`	Beneficiary's instant payment account type. Type of wallet being used: `TOUCHNGO`.
`remitter.first_name`	Remitter's first name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.last_name`	Remitter's last name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.document.id`	Remitter's document. Maximum 45 characters. Mandatory only for remittance (P2P).
`remitter.document.type`	Remitter's document type: `NI` for national identification number, `PASS` for passport. Mandatory only for remittance (P2P).
`remitter.address.street`	Remitter's address street. Maximum 200 characters. Mandatory only for remittance (P2P).
`remitter.address.city`	Remitter's address city. Maximum 40 characters. Mandatory only for remittance (P2P).
`remitter.address.country`	Remitter's address country. ISO 3166-1 alpha-2 code.. Mandatory only for remittance (P2P).

Example request

{
  "external_id": "1234567812345678",
  "payment_method_id": "INSTANT_PAYMENT",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "country": "MY",
  "beneficiary": {
    "first_name": "JUAN",
    "last_name": "NASCIMENTO",
    "instant_payment": {
      "type": "TOUCHNGO",
      "id": "123456789012"
    }
  },
  "notification_url": "https://thisisawebsite.net",
  "amount": "1100.00",
  "currency": "MYR"
}

Bank information

Access the reference formats and accepted values required for processing bank payouts in Malaysia.

Bank codes

Bank Name	Bank code
Affin Bank Berhad	6
Affin Islamic Bank Berhad	32
Agrobank (Islamic)	43
Al Rajhi	7
Alliance Bank Berhad	8
Alliance Islamic Bank Berhad	33
AmBank Berhad	1
AmBank Islamic	34
Bank Islam Malaysia Berhad	9
Bank Kerjasama Rakyat Berhad	10
Bank Muamalat Malaysia Berhad	11
Bank of America	20
Bank of China (Malaysia) Berhad	21
Bank of Tokyo - Mitsubishi UFJ (M) Berhad	22
Bank Pertanian Malaysia Berhad (Agrobank)	23
Bank Simpanan Nasional	12
Bank Simpanan Nasional (Islamic)	44
BNP Paribas (M) Bhd	24
BNP Paribas (M) Bhd (Islamic)	35
CIMB Bank Berhad	4
CIMB Islamic Bank	36
Commerce Terjari Bank Berhad	25
Deutsche Bank Malaysia Berhad	14
Eon Bank Berhad	26
Hong Leong Bank Berhad	2
Hong Leong Islamic Bank Bhd	37
HSBC Bank Berhad	15
Industrial & Commercial Bank of China	27
J.P Morgan Chase Bank Berhad	28
Kuwait Finance House (Malaysia) Bhd	29
Malayan Banking Berhad (Maybank)	5
MayBank Islamic Berhad	38
Mizuho Corporate Bank Malaysia	30
OCBC Al-Amin Bank Berhad	39
OCBC Bank	16
Public Bank Berhad	3
Public Islamic Bank Bhd	40
RHB Bank Berhad	17
RHB Islamic Bank Berhad	41
Standard Chartered Bank Berhad	18
Standard Chartered Saadiq Bhd	42
Sumitomo Mitsui Banking Corporation Malaysia Bhd	31
UOB	19