---
title: Request Access Token - API NICEPAY Inquiry Virtual Account SNAP
slug: nicepay-api-snap-request-access-token-nicepay-inquiry-virtual-account
description: Informasi tentang Request Access Token - API NICEPAY Inquiry Virtual Account SNAP yang terdapat pada sistem NICEPAY
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/PzA1GBuvYO2VJilayXYNN_microsoftteams-image.png
icon: {"faIcon":"fa-solid fa-book"}
docTags: 
createdAt: 2025-05-07T04:43:46.174Z
---

# 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

***

:::hint{type="warning"}
Sebelum melakukan proses integrasi, Merchant perlu mengirimkan base URL (Merchant Domain) via email kepada Tim Integrasi NICEPAY ([integration@nicepay.co.id](mailto\:integration@nicepay.co.id)) 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`<br />(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 <br />created using asymmetric<br />signature SHA256withRSA algorithm<br />(`Private_Key`, `stringToSign`)<br />`stringToSign `= `client ID` + “`\|`” + `X-TIMESTAMP` |



## Request Access Token Body Parameter&#x20;

| **Parameter**    | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi**   |
| ---------------- | -------- | ---------- | ------------- | --------------- |
| `grantType`&#xD; | 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

:::CodeblockTabs
JSON Request

```json
{
 "grantType": "client_credentials",
 "additionalInfo": {}
}
```

JSON Response

```json
{
 "responseCode": "2007300",
 "responseMessage": "Successful",
 "accessToken": "Xy8duZzAvv9bwDXxRxcb89tsuvk4MF4kx4lGfE4aCRVxR7XdERhbe1",
 "tokenType": "Bearer",
 "expiresIn": "900",
 "additionalInfo": {}
}
```
:::