Registration - API Payout (Disbursement)

8 min

About Registration - API Payout (Disbursement)
﻿
Registration - API Payout (Disbursement) ﻿ is ﻿ initial ﻿ on ﻿ing ﻿ fund transfer into ﻿ destination account. This ﻿ aims to register ﻿ ﻿ ﻿ request from You to ﻿.
﻿﻿ urges You to ensure that your ﻿ ﻿ is sufficient before ﻿ing with this ﻿ registration ﻿ by using Check Balance - API Payout (Disbursement)﻿ ﻿ so ﻿ ﻿ ﻿ able to going smoothly.
If your ﻿ ﻿ is insufficient, please ﻿ with a fund deposit firsthand on your ﻿ ﻿. ﻿ check ﻿ Balance Deposits﻿ ﻿ to view further related ﻿.
﻿
Registration - API Payout (Disbursement)
﻿
API Endpoint
/nicepay/api/direct/v2/requestPayout
Request Method
﻿POST﻿
Header
Content-Type: application/json
Merchant Token
SHA256(timestamp + iMid + amt + AccountNo + merchantKey)
﻿
Request Parameter for Payout Registration
﻿
Parameter
Type
Size
Description
Example / Notes
timeStamp
﻿Required﻿
N
14
﻿﻿ Request Date
20221219085959
iMid
﻿Required﻿
AN
10
﻿﻿ ID
IONPAYTEST
msId
AN
30
﻿﻿ Seller ID
SELLER0001
amt
﻿Required﻿
N
12
﻿﻿ Amount
1000
merchantToken
﻿Required﻿
AN
64
﻿﻿ Token
b252d9f89a448d94e163e913a47b4d5c4c0af82a39b951e18eccdb3d28f59bbf
accountNo
﻿Required﻿
N
20
Beneficiary Account Number
5345000060
referenceNo
﻿Required﻿
AN
40
Reference Number
ORD12345
bankCd
﻿Required﻿
N
4
﻿Bank Code﻿ 
BDIN
benefNm
﻿Required﻿
AN
40
Beneficiary Name
PT IONPAY NETWORKS
benefPhone
﻿Required﻿
N
12
Beneficiary Phone
082111111111
benefStatus
﻿Required﻿
N
2
Beneficiary Status: 
﻿
1: WNI
2: WNA
1
benefType
﻿Required﻿
N
2
Beneficiary Type
1: Personal
2: Company
3: Government
1
reservedDt
N
8
Schedule Date (YYYYMMDD)
﻿
reservedTm
N
6
Schedule Time (HH24MISS)
﻿
description
AN
100
﻿﻿ Notification
This is Test 
payoutMethod
﻿Required﻿
N
2
﻿Payment Method﻿﻿
0: Overbooking
1: Online
2: SKN
3: RTGS 
4: Cashout
﻿
﻿
Response Parameter for Payout Registration
﻿
Parameter
Type
Size
Description
Example / Notes
resultCd
N
4
﻿Result Code﻿ 
0000
benefNm
AN
40
Beneficiary Name
PT IONPAY NETWORKS
resultMsg
AN
255
Result Message: Error Code﻿ 
SUCCESS
tXid
AN
30
﻿﻿ Transaction ID (Key from ﻿)
IONPAYTEST07202212191238107952
referenceNo
AN
40
Reference Number (Key from ﻿)
ORD1234
payoutMethod
N
2
﻿Payment Method﻿﻿
0: Overbooking
1: Online
2: SKN
3: RTGS 
4: Cashout
0
amt
N
12
﻿﻿ Amount
10000
accountNo
N
20
Beneficiary Account Number
123456789
payoutToken
AN
100
﻿﻿ Token
null
bankCd
AN
4
﻿Bank Code﻿ 
IDMC
﻿
Sample JSON for Payout Registration
﻿
JSON Request
JSON Response
Java Request
// API URL
https://www.nicepay.co.id/nicepay/direct/v2/requestPayout

// Request Body
{
    "timeStamp": "20221219085959",
    "iMid": "IONPAYTEST",
    "msId":"",
    "merchantToken": "b252d9f89a448d94e163e913a47b4d5c4c0af82a39b951e18eccdb3d28f59bbf",
    "accountNo": "5345000060",
    "benefNm": "PT IONPAY NETWORKS",
    "benefStatus": "1",
    "benefType": "1",
    "bankCd": "BDIN",
    "amt": "10000",
    "referenceNo": "ORD12345",
    "reservedDt": "",
    "reservedTm": "",
    "benefPhone": "082111111111",
    "description": "This is test request",
    "payoutMethod": "4"
}
// API URL
https://www.nicepay.co.id/nicepay/direct/v2/requestPayout

// Request Body
{
    "timeStamp": "20221219085959",
    "iMid": "IONPAYTEST",
    "msId":"",
    "merchantToken": "b252d9f89a448d94e163e913a47b4d5c4c0af82a39b951e18eccdb3d28f59bbf",
    "accountNo": "5345000060",
    "benefNm": "PT IONPAY NETWORKS",
    "benefStatus": "1",
    "benefType": "1",
    "bankCd": "BDIN",
    "amt": "10000",
    "referenceNo": "ORD12345",
    "reservedDt": "",
    "reservedTm": "",
    "benefPhone": "082111111111",
    "description": "This is test request",
    "payoutMethod": "4"
}
﻿
﻿

API Endpoint	/nicepay/api/direct/v2/requestPayout
Request Method	POST
Header	Content-Type: application/json
Merchant Token	SHA256(timestamp + iMid + amt + AccountNo + merchantKey)

Parameter	Type	Size	Description	Example / Notes
timeStamp Required	N	14	Request Date	20221219085959
iMid Required	AN	10	ID	IONPAYTEST
msId	AN	30	Seller ID	SELLER0001
amt Required	N	12	Amount	1000
merchantToken Required	AN	64	Token	b252d9f89a448d94e163e913a47b4d5c4c0af82a39b951e18eccdb3d28f59bbf
accountNo Required	N	20	Beneficiary Account Number	5345000060
referenceNo Required	AN	40	Reference Number	ORD12345
bankCd Required	N	4	Bank Code	BDIN
benefNm Required	AN	40	Beneficiary Name	PT IONPAY NETWORKS
benefPhone Required	N	12	Beneficiary Phone	082111111111
benefStatus Required	N	2	Beneficiary Status: 1: WNI 2: WNA	1
benefType Required	N	2	Beneficiary Type 1: Personal 2: Company 3: Government	1
reservedDt	N	8	Schedule Date (YYYYMMDD)
reservedTm	N	6	Schedule Time (HH24MISS)
description	AN	100	Notification	This is Test
payoutMethod Required	N	2	Payment Method 0: Overbooking 1: Online 2: SKN 3: RTGS 4: Cashout

Parameter	Type	Size	Description	Example / Notes
resultCd	N	4	Result Code	0000
benefNm	AN	40	Beneficiary Name	PT IONPAY NETWORKS
resultMsg	AN	255	Result Message: Error Code	SUCCESS
tXid	AN	30	Transaction ID (Key from )	IONPAYTEST07202212191238107952
referenceNo	AN	40	Reference Number (Key from )	ORD1234
payoutMethod	N	2	Payment Method 0: Overbooking 1: Online 2: SKN 3: RTGS 4: Cashout	0
amt	N	12	Amount	10000
accountNo	N	20	Beneficiary Account Number	123456789
payoutToken	AN	100	Token	null
bankCd	AN	4	Bank Code	IDMC

Payout (Disbursement) API

Check Balance - API Payout (Disbursement)

Registration - API Payout (Disbursement)

About Registration - API Payout (Disbursement)

Registration - API Payout (Disbursement)

Request Parameter for Payout Registration

Response Parameter for Payout Registration

Sample JSON for Payout Registration

Welcome to NICEPAY DOCS