---
title: "Inquiry Virtual Account API"
method: POST
path: "/transfer-va/inquiry-va"
---

# Inquiry Virtual Account API

`POST /transfer-va/inquiry-va`

The following endpoint can be used to inquiry a virtual account information.

## Headers

- `Content-Type` string, required
- `X-TIMESTAMP` string, required
- `Authorization` string
- `X-SIGNATURE` string, required
- `X-PARTNER-ID` string, required
- `X-EXTERNAL-ID` string, required
- `CHANNEL-ID` string, required

## Request body

- object
  - `partnerServiceId` string, required — Virtual Account prefix. Please pass the same one as returned in the Create VA API.
  - `customerNo` string, required — Virtual Account suffix. Please pass the same one as returned in the Create VA API.
  - `virtualAccountNo` string, required — Full Virtual Account number. Please pass the same one as returned in the Create VA API.
  - `trxId` string, required — Transaction reference from merchant’s system.

## Response `200`

This response indicates that inquiry virtual account was successful.

- object
  - `responseCode` string, required — Response code indicating the result of the operation.
  - `responseMessage` string, required — Message explaining the responseCode.
  - `virtualAccountData` object, required
    - `partnerServiceId` string — First 8 digits of the virtual account number.
    - `customerNo` string — Remaining suffix of the virtual account number assigned by merchant.
    - `virtualAccountNo` string — Full virtual account number to be shared to customer.
    - `virtualAccountName` string — Name displayed on ATM/banking interface.
    - `trxId` string — Merchant’s unique transaction reference.
    - `virtualAccountTrxType` string — C = Closed, O = Open.
    - `expiredDate` string — Expiry date of VA. Format: YYYY-MM-DDThh:mm:ss+07:00.
    - `totalAmount` object — This will only be returned if the virtual account is closed amount type.
      - `value` string — Transaction amount with 2 decimal places.
      - `currency` string — Currency format in ISO 4217. Only "IDR" accepted.
    - `additionalInfo` object
      - `bankCode` string — Code of issuing bank (e.g., BCA, BRI, MANDIRI).
      - `isReusable` boolean — true = VA can be paid multiple times until expiry time, false = VA can only be paid once.
      - `referenceNo` string — Durianpay internal payment reference ID.
      - `customerInfo` object
        - `customer_id` string — Durianpay's internal customer ID.
        - `customer_ref_id` string — Merchant's internal customer reference ID.
        - `given_name` string — Customer name.
        - `email` string — Customer email address.
        - `mobile` string — Customer phone number.
      - `paymentHistory` object[] — List of payments made to this VA.
        - `paymentRequestId` string — Durianpay's unique ID of the payment.
        - `paidAmount` object
          - `value` string — Paid amount, 2 decimals.
          - `currency` string — SO 4217, must be "IDR".
        - `trxDateTime` string — Date and time of the payment.

## Other responses

- `400` — This response indicates a client-side error occurred while processing the request.
- `404` — This response indicates a server-side not found error occurred while processing the request.
- `500` — This response indicates a server-side error occurred while processing the request.

---

[API](https://skmtc.net/durianpay/apis/durianpay-api.md) · [All operations](https://skmtc.net/durianpay/apis/durianpay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/durianpay/durianpay-api/versions/ffc0e7e8a227/schema)