---
title: Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP
slug: en/nicepay-api-snap-inquiry-account-binding-e-wallet-direct-debit
description: Information about Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP available on the NICEPAY system
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/1soQCDFXbLV_0uYvZu5Bl_microsoftteams-image.png
icon: {"faIcon":"fa-solid fa-book"}
docTags: 
createdAt: 2025-08-18T03:11:16.753Z
---

# About Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP

***

This API uses to check whether the user account own by the Customer is successfully linked or not to the E-Wallet payment method based on SNAP standardization.




Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP
==========================================================

***

| **Service Code** | `08`                                               |
| ---------------- | -------------------------------------------------- |
| **API Endpoint** | `/nicepay/api/v1.0/ registration-account-inquiry`  |
| **Method**       | `POST`                                             |



## Request Header Parameter for Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP

***

| **Parameter**   | **Type** | **Length** | **Mandatory** | **Description**                                                                                                                   |
| --------------- | -------- | ---------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `Content-Type`  | String   | Variable   | Mandatory     | Content type, value always `application/json`                                                                                     |
| `Authorization` | String   | Variable   | Mandatory     | Bearer “`accessToken`”                                                                                                            |
| `X-TIMESTAMP`   | String   | Variable   | Mandatory     | Transaction date time, in format `YYYY-MMDDTHH:mm:ss+07:00`. Time must be in GMT+7 (Jakarta time)                                 |
| `X-SIGNATURE`   | String   | Variable   | Mandatory     | Signature will be generated automatically by Merchant                                                                             |
| `X-PARTNER-ID`  | String   | 10         | 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 Body Parameter for Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP

***

| **Parameter**        | **Type**    | **Length** | **Mandatory** | **Description**                                            |
| -------------------- | ----------- | ---------- | ------------- | ---------------------------------------------------------- |
| `partnerReferenceNo` | String      | 40         | Mandatory     | Original transaction identifier on service provider system |
| `additionalInfo`     | JSON Object | Variable   | Mandatory     | Additional information                                     |
| `refreshToken`       | String      | 40         | Mandatory     | `refreshToken` from NICEPAY                                |
| `mitraCd`            | String      | 40         | Mandatory     | NICEPAY Mitra Code Example :&#xD;<br />AstraPay : `ASTR`   |



## Response Header Parameter for Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP

***

| **Parameter**  | **Type** | **Length** | **Mandatory** | **Description**                                                                                   |
| -------------- | -------- | ---------- | ------------- | ------------------------------------------------------------------------------------------------- |
| `Content-Type` | String   | Variable   | Mandatory     | Content type, value always `application/json`                                                     |
| `X-TIMESTAMP`  | String   | Variable   | Mandatory     | Transaction date time, in format `YYYY-MMDDTHH:mm:ss+07:00`. Time must be in GMT+7 (Jakarta time) |



## Response Body Parameter for Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP

***

| **Parameter**        | **Type**    | **Length** | **Mandatory** | **Description**                                                                      |
| -------------------- | ----------- | ---------- | ------------- | ------------------------------------------------------------------------------------ |
| `responseCode`       | String      | 7          | Mandatory     | Refer to response code list                                                          |
| `responseMessage`    | String      | 150        | Mandatory     | Debug message to provide more&#xD;<br />information                                  |
| `referenceNo`        | String      | 40         | Mandatory     | NICEPAY Transaction ID                                                               |
| `partnerReferenceNo` | String      | 40         | Mandatory     | Merchant transaction identifier                                                      |
| `additionalInfo`     | JSON Object | Variable   | Mandatory     | Additional information                                                               |
| `mitraCd`            | String      | 4          | Mandatory     | NICEPAY Mitra Code Example :&#xD;<br />AstraPay : `ASTR`&#xD;<br />AlloBank : `ALLO` |
| `accountToken`       | String      | 40         | Mandatory     | Account Token Information                                                            |
| `accessTokenInfo`    | JSON Object | Variable   | Mandatory     | Account Token Information                                                            |
| `accessToken`        | String      | 150        | Mandatory     | Access Token                                                                         |
| `expiresIn`          | String      | 25         | Mandatory     | Date Time of Token Expiration                                                        |
| `refreshToken`       | String      | 150        | Mandatory     | Refresh token                                                                        |
| `reExpiresIn`        | String      | 25         | Mandatory     | Date time of refresh token expiration                                                |
| `authCode`           | String      | 30         | Mandatory     | Authentication Code for Merchant                                                     |



## Sample Parameter for Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP

***

### Request Parameter

:::CodeblockTabs
cURL

```curl
curl -X POST \
  'https://dev.nicepay.co.id/nicepay/api/v1.0/registration-account-inquiry' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=' \
  -H 'X-TIMESTAMP: 2024-01-31T10:11:40+07:00' \
  -H 'X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ==' \
  -H 'X-PARTNER-ID: IONPAYTEST' \
  -H 'X-EXTERNAL-ID: tXid202410142300021707638093' \
  -H 'CHANNEL-ID: IONPAYTEST01' \
  -d '{"partnerReferenceNo":"2020102900000000000001","additionalInfo":{"referenceNo":"IONPAYTEST05202208121451526358","mitraCd":"ASTR"}}'
```

Node.js

```nodejs
const config = {
  isProduction: false,
  privateKey: cons.privateKey,
  clientSecret: cons.clientSecret,
  clientId: "IONPAYTEST",
  isCloudServer: false,
};

const ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=";

const parameter = {
  body: {
    // Inquiry Body Fields
    partnerReferenceNo: "2020102900000000000001",
    additionalInfo: {
      referenceNo: "IONPAYTEST05202208121451526358",
      mitraCd: "ASTR"
    }
  },
  headers: {
    X_EXTERNAL_ID: "tXid202410142300021707638093",
    CHANNEL_ID: "IONPAYTEST01",
  },
};

let snap = new Snap(config);
let endPoint = `/api/v1.0/registration-account-inquiry`;
let response = snap
  .requestSnapTransaction(parameter, endPoint, ACCESS_TOKEN, "POST");
```
:::

### Response Parameter

:::CodeblockTabs
Sample Response

```json
{
    "responseCode": "2000800",
    "responseMessage": "Successful",
    "referenceNo": "IONPAYTEST05202208121451526358",
    "partnerReferenceNo": "2020102900000000000001",
    "additionalInfo": {
        "mitraCd": "ASTR",
        "accountToken": "1Fhas7281han862=",
        "accessTokenInfo": {
            "accessToken": "ublicpBa869cad0990e4e17a57ecf7c5469a4b2",
            "expiresIn": "2021-07-04T12:08:56+05:30",
            "refreshToken": "201208134b203fe6c11548bcabd8da5bb087a83b",
            "reExpiresIn": "2051-07-04T12:08:56+05:30",
            " authCode": "nlleyvaQcB2SOkVjtF7ceCuC16BiqCc6DRrjaKOnnfRdToW8Tr"
        }
    }
}
```
:::