Request Access Token - API NICEPAY Inquiry Convenience Store SNAP
Tentang Request Access Token - API NICEPAY Inquiry Convenience Store SNAP
Bagian ini berisi tentang informasi terkait API dengan standar SNAP yang digunakan pada metode pembayaran Convenience Store dengan fitur NICEPAY Inquiry Convenience Store (NICO) agar dapat mengajukan token untuk melakukan proses transaksi.
Request Access Token - API NICEPAY Inquiry Convenience Store 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 NICO.
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 NICO |
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": {}
}