---
title: "Balance Inquiry API"
method: POST
path: "/balance-inquiry"
---

# Balance Inquiry API

`POST /balance-inquiry`

The following endpoint fetch the current balance in the merchant's Durianpay account.

## 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
  - `accountNo` string, required — Merchant's balance accountNo (merchant_id)
  - `additionalInfo` object — The field for additional information. JSON object with keys: deviceId and channel. example: {"deviceId": "1234567", "channel": "mobilephone"}
    - `deviceId` string — device id of the request source
    - `channel` string — channel of the request source

## Response `200`

200

- object
  - `accountInfos` object[]
    - `availableBalance` object
      - `currency` string
      - `value` string
  - `responseCode` string
  - `responseMessage` string

## Other responses

- `400` — 400
- `401` — 401
- `409` — 409
- `500` — 500
- `504` — 504

---

[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/revisions/ffc0e7e8a227/schema)