Request Access Token - API NICEPAY Inquiry Virtual Account SNAP
Tentang Request Access Token - API NICEPAY Inquiry Virtual Account SNAP
Bagian ini berisi tentang informasi terkait API dengan standar SNAP yang digunakan pada metode pembayaran Virtual Account dengan fitur NICEPAY Inquiry Virtual Account (NIVA) agar dapat mengajukan token untuk melakukan proses transaksi.
Request Access Token - API NICEPAY Inquiry Virtual Account SNAP
Sebelum melakukan proses integrasi, Merchant perlu mengirimkan base URL (Merchant Domain) via email kepada Tim Integrasi NICEPAY ([email protected]) agar Merchant dapat mengakses API NIVA.
Setelah menerima URL Base, NICEPAY akan memberikan Public Key kepada Merchant, sehingga Merchant dapat langsung memulai proses integrasi.
Get Access Token
NICEPAY akan mengajukan generate access_token kepada Merchant melalui API. access_token yang diberikan akan mengikuti format dari Merchant dan memiliki waktu kedaluwarsa 15 menit.
API Endpoint | https://[merchant-domain]/api/v.1.0/access-token/b2b |
|---|---|
Method | POST |
Description | Untuk melakukan request access token transaksi NIVA |
Content-type | application/json |
Request Access Token Header Parameter
Parameter | Tipe | Kebutuhan | Deskripsi | Contoh |
|---|---|---|---|---|
Content-Type | String | Mandatory | String Media Type of the Resource | application/json |
X-TIMESTAMP | String | Mandatory | NICEPAY Timezone | YYYY-MM-DDTHH:MM:SS (2024-01-22T15:00:01+07:00) |
X-CLIENT KEY | String | Mandatory | Merchant ID | IONPAYTEST |
X-SIGNATURE | String | Mandatory | NICEPAY Signature | Generated by Partner/Merchant created using asymmetric signature SHA256withRSA algorithm (Private_Key, stringToSign) stringToSign = client ID + “|” + X-TIMESTAMP |
Request Access Token Body Parameter
Parameter | Tipe | Ukuran | Kebutuhan | Deskripsi |
|---|---|---|---|---|
grantType | String | 8 | Mandatory | Customer Name |
additionalInfo | String | 17 | Mandatory | Goods/Item Name |
Request Access Token Response Parameter
Parameter | Tipe | Ukuran | Kebutuhan | Deskripsi |
|---|---|---|---|---|
responseCode | String | 5 | Mandatory | Response Code |
responseMessage | String | 100 | Mandatory | Response Message |
accessToken | String | 150 | Mandatory | Access Token |
tokenType | String | 8 | Mandatory | Type Token |
expiresIn | String | 17 | Mandatory | Session Expiry in Second |
additionalInfo | String | 17 | Mandatory | Additional Information |
Sample Parameter
{
"responseCode": "2007300",
"responseMessage": "Successful",
"accessToken": "Xy8duZzAvv9bwDXxRxcb89tsuvk4MF4kx4lGfE4aCRVxR7XdERhbe1",
"tokenType": "Bearer",
"expiresIn": "900",
"additionalInfo": {}
}