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
﻿
﻿
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
//Request Parameter Setting
HashMap<String, Object> requestMap = new HashMap<String, Object>();
requestMap.put("timeStamp", "20221219085959");
requestMap.put("iMid", "IONPAYTEST");
requestMap.put("msId", "");
requestMap.put("amt", "10000");
requestMap.put("merchantToken","b252d9f89a448d94e163e913a47b4d5c4c0af82a39b951e18eccdb3d28f59bbfd");
requestMap.put("accountNo", "5345000060");
requestMap.put("benefNm", "PT IONPAY NETWORKS");
requestMap.put("benefPhone", "082111111111");
requestMap.put("benefStatus", "1");
requestMap.put("benefType", "1");
requestMap.put("bankCd", "BDIN");
requestMap.put("referenceNo", "ORD12345");
requestMap.put("reservedDt", "");
requestMap.put("reservedTm", "");
requestMap.put("description", "This is test request");
requestMap.put("payoutMethod", "4");
//Nicepay Api Domain
String myDomain = "https://www.nicepay.co.id";
//Response Json String
String resultData = "";
try {
//Make json
    ObjectMapper mapper = new ObjectMapper();
    String contents = mapper.writeValueAsString(requestMap);
    URL url = new URL(myDomain + "/nicepay/direct/v2/requestPayout");
    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();
    }
    InputStreamReader isr = new InputStreamReader(conn.getInputStream(), "UTF-8");
    BufferedReader br = new BufferedReader(isr);
    String str = "";
    resultData = "";
    while ((str = br.readLine()) != null) {
        resultData += str;
    }
        br.close();
    } catch (MalformedURLException e) {
        System.out.println("The URL address is incorrect.");
        e.printStackTrace();
    } catch (Exception e) {
        System.out.println("It can't connect to the web page.");
    e.printStackTrace();
}
//Request Parameter Setting
HashMap<String, Object> requestMap = new HashMap<String, Object>();
requestMap.put("timeStamp", "20221219085959");
requestMap.put("iMid", "IONPAYTEST");
requestMap.put("msId", "");
requestMap.put("amt", "10000");
requestMap.put("merchantToken","b252d9f89a448d94e163e913a47b4d5c4c0af82a39b951e18eccdb3d28f59bbfd");
requestMap.put("accountNo", "5345000060");
requestMap.put("benefNm", "PT IONPAY NETWORKS");
requestMap.put("benefPhone", "082111111111");
requestMap.put("benefStatus", "1");
requestMap.put("benefType", "1");
requestMap.put("bankCd", "BDIN");
requestMap.put("referenceNo", "ORD12345");
requestMap.put("reservedDt", "");
requestMap.put("reservedTm", "");
requestMap.put("description", "This is test request");
requestMap.put("payoutMethod", "4");
//Nicepay Api Domain
String myDomain = "https://www.nicepay.co.id";
//Response Json String
String resultData = "";
try {
//Make json
    ObjectMapper mapper = new ObjectMapper();
    String contents = mapper.writeValueAsString(requestMap);
    URL url = new URL(myDomain + "/nicepay/direct/v2/requestPayout");
    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();
    }
    InputStreamReader isr = new InputStreamReader(conn.getInputStream(), "UTF-8");
    BufferedReader br = new BufferedReader(isr);
    String str = "";
    resultData = "";
    while ((str = br.readLine()) != null) {
        resultData += str;
    }
        br.close();
    } catch (MalformedURLException e) {
        System.out.println("The URL address is incorrect.");
        e.printStackTrace();
    } catch (Exception e) {
        System.out.println("It can't connect to the web page.");
    e.printStackTrace();
}
﻿
﻿

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

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 31 Jan 2025

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