Approve - API Payout (Disbursement)

8 min

Tentang API Payout Approve
﻿
Proses Approval bertujuan untuk meminta konfirmasi ﻿ terkait request pengiriman dana beserta rincian ﻿ penerima dana ﻿. ﻿ ini digunakan untuk menyetujui request ﻿ diajukan pada Registration - API Payout (Disbursement)﻿.
﻿
API Payout Approve
﻿
API Endpoint
/nicepay/api/direct/v2/approvePayout
Request Method 
﻿POST﻿
Header
Content-Type: application/json
Merchant Token
SHA256 (timeStamp + iMid + tXid+ merchantKey)
﻿
Request Parameter for Payout Approve
﻿
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
timeStamp
﻿Required﻿
N
14
﻿﻿ Request Date
20221219085959
tXid
﻿Required﻿
AN
30
Transaction ID
IONPAYTEST07202212191238107952
iMid
﻿Required﻿
AN
10
﻿﻿ ID
IONPAYTEST
merchantToken
﻿Required﻿
AN
255
﻿﻿ Token
9f33948e1ce99b6f42c2a223234ec50ff1bc450c78a16885227c57fae4f4ff80
﻿
Response Parameter for Payout Approve
﻿
Apabila terjadi timeout pada saat ﻿ Approve kepada ﻿, diharapkan untuk ﻿ tidak menganggap status transaksi tersebut sukses atau gagal, melainkan suspect. Sebab, telah terjadi pemotongan dana pada ﻿ ﻿ ini.
Transaksi ﻿ dianggap suspect akan tetap ter﻿, hanya membutuhkan waktu tambahan. Setelah ﻿ selesai, maka ﻿ akan mendapatkan ﻿ ﻿ akhir ﻿nya dari URL callback ﻿ sudah didaftarkan ke ﻿.
<!-- <p>paste iframe code here</p> -->Jika status transaksi suspect tidak mengalami perubahan hingga H+1, silakan hubungi <a style="color:blue; text-decoration-line:underline" href="mailto:cs@nicepay.co.id">NICEPAY Customer Service</a> untuk mendapatkan bantuan lebih lanjut.
<!-- <p>paste iframe code here</p> -->Jika status transaksi suspect tidak mengalami perubahan hingga H+1, silakan hubungi <a style="color:blue; text-decoration-line:underline" href="mailto:cs@nicepay.co.id">NICEPAY Customer Service</a> untuk mendapatkan bantuan lebih lanjut.
﻿
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
resultCd
N
4
﻿Result Code﻿ 
0000
resultMsg
AN
10
Result Message: Error Code﻿ 
Success
tXid
AN
30
﻿﻿ Transaction ID (Key from ﻿)
IONPAYTEST07202212191238107952
iMid
AN
10
﻿﻿ ID
IONPAYTEST
referenceNo
ANS
40
﻿﻿ Order Number (Key from ﻿)
ORD12345
amt
N
12
﻿﻿ Amount
1000
transDt
N
8
Transaction Date (YYYYMMDD)
null
transTm
N
6
Transaction Time (HH24MISS)
null
accountNo
N
20
Beneficiary Account Number
5345000060 
benefNm
AN
40
Beneficiary Name
PT IONPAY NETWORKS
bankCd
AN
4
﻿Bank Code﻿ 
BDIN
validDate
﻿Only For Cashout﻿
N
8
Valid Token Date (YYYYMMDD)
20220819
﻿
(Default D+1)
validTm
﻿Only For Cashout﻿
N
6
Valid Token Time
(HH24MISS)
131207
﻿
(Default D+1)
cashoutToken
﻿Only For Cashout﻿
N
20
Generate Token by ﻿﻿
0030456405
mCode
﻿Only For Cashout﻿
AN
40
Valid Token Time (HH24MISS)
﻿﻿ CASHOUT TEST
﻿
Sample JSON for Payout Approve
﻿
JSON Request
JSON Response
Java Request
{
	"resultCd" : "0000",
	"resultMsg" : "SUCCESS",
	"tXid" : "IONPAYTEST07202212191238107952",
	"referenceNo" : "OrdNo-20230504110578",
	"iMid" : "IONPAYTEST",
	"benefNm" : "PT IONPAY NETWORKS",
	"accountNo" : "5345000060",
	"bankCd" : "BDIN",
	"amt" : "100000",
	"transDt" : null,
	"transTm" : null,
	"validDate" : "20230505", //Only For Cashout
	"valiDTime" : "110217", //Only For Cashout
	"cashoutToken" : "0030456405", //Only For Cashout
	"mCode" : "NICEPAY-CASHOUT-TEST" //Only For Cashout
}
{
	"resultCd" : "0000",
	"resultMsg" : "SUCCESS",
	"tXid" : "IONPAYTEST07202212191238107952",
	"referenceNo" : "OrdNo-20230504110578",
	"iMid" : "IONPAYTEST",
	"benefNm" : "PT IONPAY NETWORKS",
	"accountNo" : "5345000060",
	"bankCd" : "BDIN",
	"amt" : "100000",
	"transDt" : null,
	"transTm" : null,
	"validDate" : "20230505", //Only For Cashout
	"valiDTime" : "110217", //Only For Cashout
	"cashoutToken" : "0030456405", //Only For Cashout
	"mCode" : "NICEPAY-CASHOUT-TEST" //Only For Cashout
}
﻿
﻿

API Endpoint	/nicepay/api/direct/v2/approvePayout
Request Method	POST
Header	Content-Type: application/json
Merchant Token	SHA256 (timeStamp + iMid + tXid+ merchantKey)

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
timeStamp Required	N	14	Request Date	20221219085959
tXid Required	AN	30	Transaction ID	IONPAYTEST07202212191238107952
iMid Required	AN	10	ID	IONPAYTEST
merchantToken Required	AN	255	Token	9f33948e1ce99b6f42c2a223234ec50ff1bc450c78a16885227c57fae4f4ff80

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
resultCd	N	4	Result Code	0000
resultMsg	AN	10	Result Message: Error Code	Success
tXid	AN	30	Transaction ID (Key from )	IONPAYTEST07202212191238107952
iMid	AN	10	ID	IONPAYTEST
referenceNo	ANS	40	Order Number (Key from )	ORD12345
amt	N	12	Amount	1000
transDt	N	8	Transaction Date (YYYYMMDD)	null
transTm	N	6	Transaction Time (HH24MISS)	null
accountNo	N	20	Beneficiary Account Number	5345000060
benefNm	AN	40	Beneficiary Name	PT IONPAY NETWORKS
bankCd	AN	4	Bank Code	BDIN
validDate Only For Cashout	N	8	Valid Token Date (YYYYMMDD)	20220819 (Default D+1)
validTm Only For Cashout	N	6	Valid Token Time (HH24MISS)	131207 (Default D+1)
cashoutToken Only For Cashout	N	20	Generate Token by	0030456405
mCode Only For Cashout	AN	40	Valid Token Time (HH24MISS)	CASHOUT TEST

Check Balance - API Payout (Disbursement)

Reject - API Payout (Disbursement)

Approve - API Payout (Disbursement)

Tentang API Payout Approve

API Payout Approve

Request Parameter for Payout Approve

Response Parameter for Payout Approve

Sample JSON for Payout Approve

Selamat Datang di NICEPAY DOCS