Inquiry - API Payout (Disbursement) SNAP

7min

Tentang Inquiry - API Payout (Disbursement) SNAP
﻿
API ini digunakan untuk mendapatkan rincian transaksi inquiry yang melalui proses Disbursement.
﻿
Inquiry - 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/inquiry﻿
HTTP Method
POST
Description
Untuk mendapatkan rincian transaksi inquiry yang melalui proses Disbursement.
Content-type
application/json
﻿
Request Inquiry Disbursement Header Parameter
Parameter
Tipe
Ukuran
Kebutuhan
Deskripsi
Content-Type
String
127
Mandatory
Content type, value always 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 Inquiry Disbursement Body Parameter
Parameter
Tipe
Ukuran
Kebutuhan
Deskripsi
merchantId
String
10
Mandatory
Merchant identifier that is unique per each Merchant
originalReferenceNo
String
40
Mandatory
Original transaction identifier on service provider system
originalPartnerReferenceNo
String
40
Mandatory
Original transaction identifier on consumer system
beneficiaryAccountNo
String
25
Mandatory
Beneficiary Account Number
﻿
Response Inquiry Disbursement Parameter
Parameter
Tipe
Ukuran
Kebutuhan
Deskripsi
responseCode
String
7
Mandatory
Refer to General Response Code and Message - API SNAP﻿ list
responseMessage
String
150
Mandatory
Refer to General Response Code and Message - API SNAP﻿ list
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
beneficiaryCustomerResidence
String
2
Mandatory
Beneficiary Customer Residence:
1: Indonesia
2: Non Indonesia
beneficiaryCustomerType
String
2
Mandatory
Beneficiary Customer Type:
1: Personal
2: Company
3: Government
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
transactionDate
String
25
Mandatory
Transaction Date
latestTransactionStatus
String
2
Mandatory
﻿Transaction Status - API SNAP﻿﻿
transactionStatusDesc
String
50
Optional
Transaction Status Description
﻿
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: eXid202402111402271707638105
CHANNEL-ID: IONPAYTEST

{
    "merchantId": "IONPAYTEST",
    "originalPartnerReferenceNo": "order1677048512514",
    "originalReferenceNo": "IONPAYTEST07202302221348332909",
    "beneficiaryAccountNo": "5345000060"
}
//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: eXid202402111402271707638105
CHANNEL-ID: IONPAYTEST

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

Bank Indonesia telah menerbitkan Standar API terkait Pembayaran yang tercantum dalam Peraturan Anggota Dewan Gubernur No 23/15/PADG/2021 tentang Implementasi Standar Nasional Open Application Interface Pembayaran (SNAP).

Sebagai bentuk dukungan dan kepatuhan terhadap Peraturan Bank Indonesia, NICEPAY mendorong seluruh merchant untuk melakukan migrasi ke API SNAP BI.

Seluruh Merchant ditargetkan untuk dapat menyelesaikan migrasi API SNAP BI pada Juni 2024.

API Endpoint	/nicepay/api/v1.0/transfer/inquiry
HTTP Method	POST
Description	Untuk mendapatkan rincian transaksi inquiry yang melalui proses Disbursement.
Content-type	application/json

Parameter	Tipe	Ukuran	Kebutuhan	Deskripsi
Content-Type	String	127	Mandatory	Content type, value always 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)

Inquiry - API Payout (Disbursement) SNAP

Tentang Inquiry - API Payout (Disbursement) SNAP

Inquiry - API Payout (Disbursement) SNAP

Request Inquiry Disbursement Header Parameter

Request Inquiry Disbursement Body Parameter

Response Inquiry Disbursement Parameter

Sample Parameter

Selamat Datang di NICEPAY DOCS