NICEPAY API
...
API Version 2 (V2)
Payout (Disbursement) API

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 .



Parameter

Type

Size

Description

Example / Notes

resultCd

N

4

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