Approve Transaction - API Payout (Disbursement) SNAP

7min

Tentang Request Approve - API Payout (Disbursement) SNAP
﻿
API ini digunakan untuk menyetujui proses yang diajukan pada saat pendaftaran. Kemudian, data transaksi akan lanjut untuk dieksekusi.
﻿
Request Approve - API Payout (Disbursement) SNAP
﻿
Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian Request Access Token API - SNAP﻿.
API Endpoint
﻿/nicepay/api/v1.0/transfer/approve﻿
HTTP Method
POST
Description
Approve Payout Transaction
Content-type
application/json
﻿
Request Approve Disbursement Header Parameter
Parameter
Tipe
Ukuran
Kebutuhan
Deskripsi
Content-Type
String
127
Mandatory
Application/JSON
Authorization
String
Variable
Mandatory
Bearer “accessToken”
X-TIMESTAMP
String
25
Mandatory
Using ISO 8601 as timestamp format.
Transaction date time, in format YYYYMMDDTHH:mm:ss+07:00.
Time must be in GMT+7 (Jakarta time).
2022-03-21T10:11:40+07:00.
X-SIGNATURE
String
Variable
Mandatory
Signature will be generated automatically by
Merchant
X-PARTNER-ID
String
20
Mandatory
Unique Partner ID, Partner ID = Client ID
X-EXTERNAL-ID
String
40
Mandatory
Unique messaging Reference ID generated by
Merchant. Numeric String. Reference number that
should be unique in every transaction.
CHANNEL-ID
String
5
Mandatory
Device identification on which the API services is
currently being accessed by the End User (Customer)
﻿
Request Approve Disbursement Body Parameter
Parameter
Tipe
Ukuran
Kebutuhan
Deskripsi
originalPartnerReferenceNo
String
40
Mandatory
Original transaction identifier on consumer system
originalReferenceNo
String
40
Mandatory
Original transaction identifier on service provider system
merchantId
String
10
Mandatory
Merchant identifier that is unique per each Merchant
﻿
Response Approve Disbursement Parameter
Parameter
Tipe
Ukuran
Kebutuhan
Deskripsi
responseCode
String
7
Mandatory
Refer to General Response Code and Message - API SNAP﻿﻿
responseMessage
String
150
Mandatory
Refer to General Response Code and Message - API SNAP﻿﻿
originalReferenceNo
String
40
Mandatory
Original transaction identifier on service provider system
originalPartnerReferenceNo
String
40
Mandatory
Original transaction identifier on service provider system. Must be filled upon
successful transaction.
beneficiaryAccountNo
String
25
Mandatory
Beneficiary Account Number
beneficiaryName
String
100
Mandatory
Beneficiary Name
beneficiaryBankCode
String
4
Mandatory
Beneficiary Bank Code - API SNAP﻿﻿
amount
Array of JSON
Object
Variable
Mandatory
Amount Information
"amount": {...}
value
String
12
Mandatory
Transaction amount, If it’s IDR then value
includes 2 decimal digits.
e.g. IDR 10.000,- will be placed with
10000.00
currency
String
3
Mandatory
Currency code based on ISO
transactionStatus
String
2
Mandatory
﻿Transaction Status - API SNAP﻿ 
﻿
Sample Parameter
Request Body
Sample Response
//HEADER SECTION
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=
X-TIMESTAMP: 2024-12-31T10:11:40+07:00
X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ==
X-PARTNER-ID :IONPAYTEST
X-EXTERNAL-ID: eXid202402111402271707638104
CHANNEL-ID: IONPAYTEST

{
  "merchantId": "IONPAYTEST",
  "originalReferenceNo": "IONPAYTEST07202302221348332909",
  "originalPartnerReferenceNo": "order1677048512514"
}
//HEADER SECTION
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=
X-TIMESTAMP: 2024-12-31T10:11:40+07:00
X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ==
X-PARTNER-ID :IONPAYTEST
X-EXTERNAL-ID: eXid202402111402271707638104
CHANNEL-ID: IONPAYTEST

{
  "merchantId": "IONPAYTEST",
  "originalReferenceNo": "IONPAYTEST07202302221348332909",
  "originalPartnerReferenceNo": "order1677048512514"
}
﻿
﻿

API Endpoint	/nicepay/api/v1.0/transfer/approve
HTTP Method	POST
Description	Approve Payout Transaction
Content-type	application/json

Parameter	Tipe	Ukuran	Kebutuhan	Deskripsi
Content-Type	String	127	Mandatory	Application/JSON
Authorization	String	Variable	Mandatory	Bearer “accessToken”
X-TIMESTAMP	String	25	Mandatory	Using ISO 8601 as timestamp format. Transaction date time, in format YYYYMMDDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time). 2022-03-21T10:11:40+07:00.
X-SIGNATURE	String	Variable	Mandatory	Signature will be generated automatically by Merchant
X-PARTNER-ID	String	20	Mandatory	Unique Partner ID, Partner ID = Client ID
X-EXTERNAL-ID	String	40	Mandatory	Unique messaging Reference ID generated by Merchant. Numeric String. Reference number that should be unique in every transaction.
CHANNEL-ID	String	5	Mandatory	Device identification on which the API services is currently being accessed by the End User (Customer)

Parameter	Tipe	Ukuran	Kebutuhan	Deskripsi
originalPartnerReferenceNo	String	40	Mandatory	Original transaction identifier on consumer system
originalReferenceNo	String	40	Mandatory	Original transaction identifier on service provider system
merchantId	String	10	Mandatory	Merchant identifier that is unique per each Merchant

Parameter	Tipe	Ukuran	Kebutuhan	Deskripsi
responseCode	String	7	Mandatory	Refer to General Response Code and Message - API SNAP
responseMessage	String	150	Mandatory	Refer to General Response Code and Message - API SNAP
originalReferenceNo	String	40	Mandatory	Original transaction identifier on service provider system
originalPartnerReferenceNo	String	40	Mandatory	Original transaction identifier on service provider system. Must be filled upon successful transaction.
beneficiaryAccountNo	String	25	Mandatory	Beneficiary Account Number
beneficiaryName	String	100	Mandatory	Beneficiary Name
beneficiaryBankCode	String	4	Mandatory	Beneficiary Bank Code - API SNAP
amount	Array of JSON Object	Variable	Mandatory	Amount Information "amount": {...}
value	String	12	Mandatory	Transaction amount, If it’s IDR then value includes 2 decimal digits. e.g. IDR 10.000,- will be placed with 10000.00
currency	String	3	Mandatory	Currency code based on ISO
transactionStatus	String	2	Mandatory	Transaction Status - API SNAP

Updated 12 Mar 2024

Did this page help you?

Registration - API Payout (Disbursement) SNAP

Inquiry - API Payout (Disbursement) SNAP

Approve Transaction - API Payout (Disbursement) SNAP

Tentang Request Approve - API Payout (Disbursement) SNAP

Request Approve - API Payout (Disbursement) SNAP

Request Approve Disbursement Header Parameter

Request Approve Disbursement Body Parameter

Response Approve Disbursement Parameter

Sample Parameter

Selamat Datang di NICEPAY DOCS