NICEPAY API V2 Registration - API Payout (Disbursement)

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
}
﻿
﻿

Bank Indonesia telah menerbitkan Standar API terkait Pembayaran yang tercantum dalam Peraturan Anggota Dewan Gubernur No 23/15/PADG/2021 tentang Implementasi Standar Nasional Open Application Interface Pembayaran (SNAP).

Sebagai bentuk dukungan dan kepatuhan terhadap Peraturan Bank Indonesia, NICEPAY mendorong seluruh merchant untuk melakukan migrasi ke API SNAP BI.

Seluruh Merchant ditargetkan untuk dapat menyelesaikan migrasi API SNAP BI pada Juni 2024.

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

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