Registration - API Payout (Disbursement)

8min

Tentang Registration - API Payout (Disbursement)
﻿
Proses Registration - API Payout (Disbursement) merupakan 
﻿ pertama dalam menjalani 
﻿ pengiriman dana ke rekening tujuan. 
﻿ ini bertujuan untuk mendaftarkan sebuah request untuk suatu 
﻿ 
﻿ dari 
﻿ ke 
﻿.
﻿
﻿ menghimbau 
﻿ untuk memastikan 
﻿ 
﻿ sudah cukup sebelum melakukan 
﻿ 
﻿ registration ini dengan menggunakan 
﻿.  Check Balance - API Payout (Disbursement)﻿﻿ agar 
﻿ 
﻿ berjalan dengan lancar.
Apabila 
﻿ 
﻿ tidak cukup, silakan lakukan deposit dana terlebih dahulu pada balance 
﻿ 
﻿. 
﻿ kunjungi 
﻿ Deposit Saldo﻿ untuk melihat rincian 
﻿ terkait.
﻿
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
Tipe
Ukuran
Deskripsi
Contoh / Catatan
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
﻿
benefPOE
ANS
50
Beneficiary Place of Establishment
Kota Administrasi Jakarta Selatan
﻿
Mandatory for 
﻿s above 100 million
Only for benefType 2 & 3
benefDOE
N
8
Beneficiary Date of Establishment
220101
﻿
YYYYMMDD Mandatory for 
﻿s above 100 million
Only for benefType 2 & 3
benefCoNo
ANS
30
Beneficiary Business License Number (NIB/TDB)
12345JP
﻿
Mandatory for 
﻿s above 100 million
Only for benefType 2 & 3
benefAddr
ANS
255
Beneficiary Company Address
Jl. Hong Gil Dong, 88
﻿
Mandatory for 
﻿s above 100 million
Only for benefType 2 & 3
benefMerCategory
N
2
Beneficiary 
﻿ Category
01
﻿
Mandatory for 
﻿s above 100 million
Only for benefType 2 & 3
Refer list table 
﻿ Code for values
benefAuthPhoneNumber
NS
20
Beneficiary Authorized Phone Number
081623516151725378
﻿
Mandatory for 
﻿ above 100 million
Only for benefType 2 & 3
benefCoMgmtNm
ANS
100
Beneficiary Company Management Name
John Doe
﻿
Mandatory for 
﻿s above 100 million
Only for benefType 2 & 3
benefCoShNm
ANS
255
Beneficiary Company Shareholder Name
John Doe
﻿
Mandatory for 
﻿s above 100 million
Only for benefType 2 & 3
deliveryNm
ANS
100
Name of 
﻿ Beneficiary or Recipient
Ciki
﻿
Mandatory for 
﻿s above 100 million
deliveryId
ANS
20
Recipient's Identification Number such as ID Card, Passport, Driving License
123
﻿
Mandatory for 
﻿s above 100 million
﻿
Response Parameter for Payout Registration
﻿
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
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
﻿Payout 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
{
    "resultCd": "0000",
    "benefNm": "PT IONPAY NETWORKS",
    "referenceNo": "ORD12345",
    "accountNo": "5345000060",
    "bankCd": "BDIN",
    "tXid": "IONPAYTEST07202212191238107952",
    "amt": "10000",
    "payoutMethod": "0",
    "resultMsg": "SUCCESS",
    "payoutToken": null
}
{
    "resultCd": "0000",
    "benefNm": "PT IONPAY NETWORKS",
    "referenceNo": "ORD12345",
    "accountNo": "5345000060",
    "bankCd": "BDIN",
    "tXid": "IONPAYTEST07202212191238107952",
    "amt": "10000",
    "payoutMethod": "0",
    "resultMsg": "SUCCESS",
    "payoutToken": null
}
﻿
﻿

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

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
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
benefPOE	ANS	50	Beneficiary Place of Establishment	Kota Administrasi Jakarta Selatan Mandatory for s above 100 million Only for benefType 2 & 3
benefDOE	N	8	Beneficiary Date of Establishment	220101 YYYYMMDD Mandatory for s above 100 million Only for benefType 2 & 3
benefCoNo	ANS	30	Beneficiary Business License Number (NIB/TDB)	12345JP Mandatory for s above 100 million Only for benefType 2 & 3
benefAddr	ANS	255	Beneficiary Company Address	Jl. Hong Gil Dong, 88 Mandatory for s above 100 million Only for benefType 2 & 3
benefMerCategory	N	2	Beneficiary Category	01 Mandatory for s above 100 million Only for benefType 2 & 3 Refer list table Code for values
benefAuthPhoneNumber	NS	20	Beneficiary Authorized Phone Number	081623516151725378 Mandatory for above 100 million Only for benefType 2 & 3
benefCoMgmtNm	ANS	100	Beneficiary Company Management Name	John Doe Mandatory for s above 100 million Only for benefType 2 & 3
benefCoShNm	ANS	255	Beneficiary Company Shareholder Name	John Doe Mandatory for s above 100 million Only for benefType 2 & 3
deliveryNm	ANS	100	Name of Beneficiary or Recipient	Ciki Mandatory for s above 100 million
deliveryId	ANS	20	Recipient's Identification Number such as ID Card, Passport, Driving License	123 Mandatory for s above 100 million

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
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	Payout 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

Updated 02 Oct 2024

Did this page help you?

Payout API (Disbursement)

Check Balance - API Payout (Disbursement)

Registration - API Payout (Disbursement)

Tentang Registration - API Payout (Disbursement)

Registration - API Payout (Disbursement)

Request Parameter for Payout Registration

Response Parameter for Payout Registration

Sample JSON for Payout Registration

Selamat Datang di NICEPAY DOCS