---
title: "Check Balance"
method: POST
path: "/?giftBalance"
---

# Check Balance

`POST /?giftBalance`

## Request body

- object
  - `appid` string, required — Merchant APP ID (Alphanumeric - Length of 32 chars and special chars $@%#)
  - `appkey` string, required — Merchant APP KEY (Alphanumeric - Length of 32 chars and special chars $@%#)
  - `epi` string, required — EPI is an end point identifier, Identify the device on valor infrastructure, it's a 10 digit number starts with 2
  - `txn_type` string, required — Transaction type always should be set as 'giftbalance'
  - `card_no` string, required — Customer gift card number 15 to 19 digits
  - `pin` string — Customer gift card pin number

## Response `200`

200

- object
  - `error_no` string
  - `success_url` boolean
  - `error_code` string
  - `amount` string
  - `tax` string
  - `customfee` string
  - `msg` string
  - `desc` unknown
  - `additional_info` unknown
  - `clerk_id` unknown
  - `clerk_name` unknown
  - `clerk_label` unknown
  - `additionalKeyOne` unknown
  - `additionalKeyTwo` unknown
  - `additionalValueOne` unknown
  - `additionalValueTwo` unknown
  - `approval_code` string
  - `rrn` string
  - `txnid` unknown
  - `tran_no` integer
  - `stan` integer
  - `is_partial_approve` integer
  - `partial_amount` string
  - `pan` string
  - `card_type` unknown
  - `phone_number` unknown
  - `email_id` unknown
  - `zip` unknown
  - `card_holder_name` unknown
  - `expiry_date` string
  - `address` unknown
  - `epi` string
  - `channel` string
  - `token` unknown
  - `card_brand` unknown
  - `netamt` number

## Other responses

- `400` — 400

---

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