These docs are for v4.0.2. Click to read the latest docs for v4.3.0.

Payout Response / Notification Parameter

📘

Data Attribute Reference

Data Type

  • A: Alphabet
  • AN: Alphanumeric
  • C: Characters
  • B: Boolean
  • D: Decimal
  • N: Numeric

Mandatory attributes

  • M: Mandatory
  • C: Conditional
  • O: Optional

Parameter

Data Type/ Length

Mandatory

Description

version

C 5

M

Request version

Current version 1.1

merchantID

AN 15

M

Merchant ID provided by 2C2P to merchant

requestID

AN 50

M

Unique number used to validate requests

  • Duplicate request IDs will be rejected (idempotency ID)
  • Must be in UUID format

UTR

AN 25

M

Unique transaction reference (UTR) number

  • Will be sent to the Bank (if supported)
  • Default UTR generated (if parameter is blank)
  • Format of generated UTR:
    {PayoutDate:YYMMDD}{SequenceNumber:N16}
  • Sample generated UTR: 2105211234567890123456

payoutDate

C 10

M

Scheduled payout date

  • In dd/MM/yyyy format
  • If parameter is blank, system will set payoutDate = current date + 2 (T+2)

amount

D 16,2

M

Amount to be transferred

  • In 2-decimal format

currency

A 3

M

Currency code

  • Refer to currency code list

beneficiaryName

A 150

M

Beneficiary name

beneficiaryAccountNo

N 30

C

Beneficiary bank account number

  • Account number will be masked (only the last 4 digits will be shown)

beneficiaryMobileNo

N 30

C

Beneficiary mobile number

  • In international mobile number format
  • Example: +6581234567 (Singapore mobile number)

beneficiaryBankName

C 100

C

Beneficiary bank name

beneficiaryBankCode

AN 10

C

Beneficiary bank code

idCard

C 50

O

Beneficiary ID Card

bankReferenceNo

C 100

O

Additional reference numbers returned from bank

userDefined1

C 150

O

Merchant’s defined information

userDefined2

C 150

O

Merchant’s defined information

userDefined3

C 150

O

Merchant’s defined information

userDefined4

C 150

O

Merchant’s defined information

userDefined5

C 150

O

Merchant’s defined information

respCode

N 4

M

Response Code

respDesc

C 150

M

Response description

beneficiaryTypeC 50C
  • 'DEFAULT' - Default
  • 'BANKACC' - Bank Account Number
  • 'MOBILE' - Mobile Number
  • 'IDN' - ID Number
  • 'CIDN' - Company ID Number
  • 'PPN' - Passport Number
  • 'APN' - Army/Police Number
beneficiaryTypeValueC 50CValue for beneficiaryType based on the type chosen.
preferredProviderC 50CIndicate Preferred Provider if Mobile Number is used for multiple wallets