Payout Request 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

merchantID

AN 15

M

Merchant ID provided by 2C2P to merchant.

requestID

AN 30

M

Unique number used to validate requests

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

UTR

AN 22

O

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

amount

D 16,2

M

Amount to be transferred

  • In 2-decimal format

payoutDate

C 10

O

Scheduled payout date

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

beneficiaryName

A 150

M

Beneficiary name

beneficiaryAccountNo

N 30

C

Beneficiary bank account number

  • Required when parameter “beneficiaryMobileNo” is empty

beneficiaryBankName

C 100

O

Beneficiary bank name

beneficiaryBankCode

AN 10

M

Beneficiary bank code

beneficiaryMobileNo

N 30

C

Beneficiary mobile number

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

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

notificationUrl

C 255

O

Merchant’s notification URL to receive payout notification callback

idCard

C 50

O

Beneficiary ID Card

preferredSof

AN 10

O

SoF Code as preferred