Approve - API Payout (Disbursement)

8min

About API Payout Approve
﻿
The approval ﻿ aims to request your confirmation related to ﻿ request for a transfer of funds along with ﻿ details of ﻿ ﻿ Beneficiary ﻿. This ﻿ uses to confirm ﻿ request from 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 API Payout Approve
﻿
Parameter
Type
Size
Description
Example / Notes
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 API Payout Approve
﻿
If ever got a timeout during ﻿ Approve ﻿ to ﻿, ﻿ ﻿ hopefully doesn't treat ﻿ ﻿ ﻿ as success or failed, but suspect. Because ﻿ fund deduction already ﻿s on this ﻿ ﻿.
Transactions that are considered suspect will still be ﻿ed, and only need extra time. After ﻿ ﻿ finishes, ﻿ ﻿ will get that final ﻿ ﻿ from ﻿ registered callback URL to ﻿.
If the transaction status doesn't update from suspect until D+1, please contact NICEPAY Customer Service for further assistance.
<!-- <p>paste iframe code here</p> -->If the transaction status doesn't update from suspect until D+1, please contact <a style="color:blue; text-decoration-line:underline" href="mailto:cs@nicepay.co.id">NICEPAY Customer Service</a> for further assistance.
<!-- <p>paste iframe code here</p> -->If the transaction status doesn't update from suspect until D+1, please contact <a style="color:blue; text-decoration-line:underline" href="mailto:cs@nicepay.co.id">NICEPAY Customer Service</a> for further assistance.
﻿
Parameter
Type
Size
Description
Example / Notes
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
Valid Token Time
(HH24MISS)
2070520843
﻿
mCode
﻿Only For Cashout﻿
AN
40
Generate Token by ﻿ 
﻿﻿ CASHOUT TEST
﻿
Sample JSON for Payout Approve
﻿
JSON Request
JSON Response
Java Request
// Approve Payout
HashMap<String, Object> requestMap = new HashMap<String, Object>();
requestMap.put("timeStamp", "20221221131217");
requestMap.put("iMid", "IONPAYTEST");
requestMap.put("merchantToken",nicePay.getMerchantToken());
requestMap.put("tXid", "IONPAYTEST07202212211309324833");
//Nicepay Api Domain
String myDomain = "https://dev.nicepay.co.id";
//Response Json String
String resultData = "";
try {
    ObjectMapper mapper = new ObjectMapper();
    String contents = mapper.writeValueAsString(requestMap);
    URL url = new URL(myDomain + "/nicepay/api/direct/v2/rejectPayout");
    URLConnection conn = url.openConnection();
    conn.setDoOutput(true);
    conn.setUseCaches(false);
    conn.setRequestProperty("Content-Type", "application/json");
    DataOutputStream os = null;
    try {
        os = new DataOutputStream(conn.getOutputStream());
        os.writeBytes(contents);
        os.flush();
    } finally {
         if (out != null) os.close();
    }
}
// Approve Payout
HashMap<String, Object> requestMap = new HashMap<String, Object>();
requestMap.put("timeStamp", "20221221131217");
requestMap.put("iMid", "IONPAYTEST");
requestMap.put("merchantToken",nicePay.getMerchantToken());
requestMap.put("tXid", "IONPAYTEST07202212211309324833");
//Nicepay Api Domain
String myDomain = "https://dev.nicepay.co.id";
//Response Json String
String resultData = "";
try {
    ObjectMapper mapper = new ObjectMapper();
    String contents = mapper.writeValueAsString(requestMap);
    URL url = new URL(myDomain + "/nicepay/api/direct/v2/rejectPayout");
    URLConnection conn = url.openConnection();
    conn.setDoOutput(true);
    conn.setUseCaches(false);
    conn.setRequestProperty("Content-Type", "application/json");
    DataOutputStream os = null;
    try {
        os = new DataOutputStream(conn.getOutputStream());
        os.writeBytes(contents);
        os.flush();
    } finally {
         if (out != null) os.close();
    }
}
﻿

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

Parameter	Type	Size	Description	Example / Notes
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	Type	Size	Description	Example / Notes
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	Valid Token Time (HH24MISS)	2070520843
mCode Only For Cashout	AN	40	Generate Token by	CASHOUT TEST

Check Balance - API Payout (Disbursement)

Reject - API Payout (Disbursement)

Approve - API Payout (Disbursement)

About API Payout Approve

API Payout Approve

Request Parameter API Payout Approve

Response Parameter API Payout Approve

Sample JSON for Payout Approve

Welcome to NICEPAY DOCS