Beneficiary Registration Request Parameters

merchantID

AN 25

M

Merchant ID provided by 2C2P to merchant

requestID

AN 40

M

Unique number used to validate requests

• Duplicate request IDs will be rejected (idempotency ID)
• Must be in UUID format
• Only requires either the “requestID”or “UTR” parameters

idCard

C 50

C

Beneficiary ID Card

accountName

C 10

M

Beneficiary account name

bankCode

AN 20

C

Beneficiary bank code

• Requires if transfer to bank account.

emailAddress

A 50

O

Beneficiary email address

mobileNo

A 50

C

This is personal info and not beneficiary type value

companyId

A 50

O

This is personal info and not beneficiary type value

beneficiaryType

C 50

C

Type of beneficiary account which is used with beneficiaryTypeValue

• 'DEFAULT' - Default
• 'BANKACC' - Bank Account Number
• 'CBANKACC' - Company Bank Account
• 'MOBILE' - Mobile Number
• 'IDN' - ID Number
• 'CIDN' - Company ID Number
• 'PPN' - Passport Number
• 'APN' - Army/Police Number

beneficiaryTypeValue

C 50

C

Value for beneficiaryType based on the type chosen. To be used with beneficiaryType

• 'DEFAULT' - Default
• 'BANKACC' - Bank Account Number
• 'CBANKACC' - Company Bank Account Number
• 'MOBILE' - Mobile Number
• 'IDN' - ID Number
• 'CIDN' - Company ID Number
• 'PPN' - Passport Number
• 'APN' - Army/Police Number

notificationUrl

A 200

O

If merchant does not provide this endpoint. Merchant can use query API to check registration status

preferredProvider

C 50

C

Indicate Preferred Provider if Mobile Number is used for multiple wallets

• Applicable for -
• Malaysia and Thailand only
• Merchant with multiple provider only

dateOfBirth

C 10

C

Mandatory when Beneficiary Type is not 'CBANKACC' or 'CIDN'. Format is 'DD/MM/YYYY'

nationality

A 2

C

Mandatory when Benficiary Type is not 'CBANKACC' or 'CIDN'. Format is ISO Country Code A2

dateOfIncorporation

C 10

C

Mandatory when Beneficiary Type is 'CBANKACC' or 'CIDN'. Format is 'DD/MM/YYYY'

countryOfIncorporation

A 2

C

Mandatory when Beneficiary Type is 'CBANKACC' or 'CIDN'. Format is ISO Country Code A2