NICEPAY API
...
Payout (Disbursement) API
Registration - API Payout (Disbursement)
8 min
about registration api payout (disbursement) registration api payout (disbursement) {{process}} is {{the}} initial {{process}} on {{proceed}} ing {{the}} fund transfer into {{the}} destination account this {{api}} aims to register {{the}} {{payout}} {{transaction}} request from you to {{nicepay}} {{nicepay}} urges you to ensure that your {{payout}} {{balance}} is sufficient before {{proceed}} ing with this {{payout}} registration {{process}} by using docid\ k fteznfcnpae2d04yrga {{api}} so {{the}} {{payout}} {{process}} able to going smoothly if your {{payout}} {{balance}} is insufficient, please {{proceed}} with a fund deposit firsthand on your {{payout}} {{balance}} {{please}} check {{the}} docid\ b3gbwzifvfxav30llqfqp {{page}} to view further related {{information}} registration api payout (disbursement) api endpoint /nicepay/api/direct/v2/requestpayout request method post post header content type application/json merchant token sha256 (timestamp + imid + amt + accountno + merchantkey) request parameter for payout registration parameter type size description example / notes timestamp required required n 14 {{api}} request date 20221219085959 imid required required an 10 {{merchant}} id ionpaytest msid an 30 {{merchant}} seller id seller0001 amt required required n 12 {{payout}} amount 1000 merchanttoken required required an 64 {{merchant}} token b252d9f89a448d94e163e913a47b4d5c4c0af82a39b951e18eccdb3d28f59bbf accountno required required n 20 beneficiary account number 5345000060 referenceno required required an 40 reference number ord12345 bankcd required required n 4 docid\ qbeq29lj53z vbvxtvb7l bdin benefnm required required an 40 beneficiary name pt ionpay networks benefphone required required n 12 beneficiary phone 082111111111 benefstatus required required n 2 beneficiary status 1 wni 2 wna 1 beneftype required 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 {{paymentproduct}} notification this is test payoutmethod required required n 2 docid 7pas vd5ylg4vdurmygwo 0 overbooking 1 online 2 skn 3 rtgs 4 cashout response parameter for payout registration parameter type size description example / notes resultcd n 4 docid 2r5sr3xvppu1eju1nitg 0000 benefnm an 40 beneficiary name pt ionpay networks resultmsg an 255 result message docid 4 fpewlvczfhcvygxwck9 success txid an 30 {{payout}} transaction id (key from {{nicepay}} ) ionpaytest07202212191238107952 referenceno an 40 reference number (key from {{merchant}} ) ord1234 payoutmethod n 2 docid 7pas vd5ylg4vdurmygwo 0 overbooking 1 online 2 skn 3 rtgs 4 cashout 0 amt n 12 {{payout}} amount 10000 accountno n 20 beneficiary account number 123456789 payouttoken an 100 {{payout}} token null bankcd an 4 docid\ qbeq29lj53z vbvxtvb7l idmc sample json for payout registration json request // api url https //www nicepay co id/nicepay/direct/v2/requestpayout // request body { "timestamp" "20221219085959", "imid" "ionpaytest", "msid" "", "merchanttoken" "b252d9f89a448d94e163e913a47b4d5c4c0af82a39b951e18eccdb3d28f59bbf", "accountno" "5345000060", "benefnm" "pt ionpay networks", "benefstatus" "1", "beneftype" "1", "bankcd" "bdin", "amt" "10000", "referenceno" "ord12345", "reserveddt" "", "reservedtm" "", "benefphone" "082111111111", "description" "this is test request", "payoutmethod" "4" } json response { "resultcd" "0000", "benefnm" "pt ionpay networks", "referenceno" "ord12345", "accountno" "5345000060", "bankcd" "bdin", "txid" "ionpaytest07202212191238107952", "amt" "10000", "payoutmethod" "0", "resultmsg" "success", "payouttoken" null } 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"); requestmap put("benefpoe", "kota administrasi jakarta selatan"); requestmap put("benefdoe", "220101"); requestmap put("benefcono", "12345jp"); requestmap put("benefaddr", "jl hong gil dong, 88"); requestmap put("benefmercategory", "01"); requestmap put("benefauthphonenumber", "081623516151725378"); requestmap put("benefcomgmtnm", "john doe"); requestmap put("benefcoshnm", "john doe, john doe1"); requestmap put("deliverynm", "ciki"); requestmap put("deliveryid", "1234567890234512"); //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(); }