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 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
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
beneficiaryBankName	C 100	O	Beneficiary bank name Refer to Payout Bank Name
beneficiaryBankCode	AN 10	M	Beneficiary bank code Refer to Payout Bank Code
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
preferredSofProfile	AN 10	O	SoF Code as preferred
beneficiaryId	AN 50	C	Registered beneficiary ID
beneficiaryType	C 50	C	'DEFAULT' - Default 'BANKACC' - Bank Account Number '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.
preferredProvider	C 50	C	Indicate Preferred Provider if Mobile Number is used for multiple wallets