v1

latestOpenAPI 3.1.02026-08-0425501.2 MB

Check Balance

post/?giftBalance

Request body

appidstring required

Merchant APP ID (Alphanumeric - Length of 32 chars and special chars $@%#)

appkeystring required

Merchant APP KEY (Alphanumeric - Length of 32 chars and special chars $@%#)

epistring required

EPI is an end point identifier, Identify the device on valor infrastructure, it's a 10 digit number starts with 2

txn_typestring required

Transaction type always should be set as 'giftbalance'

card_nostring required

Customer gift card number 15 to 19 digits

pinstring

Customer gift card pin number

Response

200

error_nostring

success_urlboolean

error_codestring

amountstring

taxstring

customfeestring

msgstring

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:desc","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:additional_info","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:clerk_id","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:clerk_name","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:clerk_label","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:additionalKeyOne","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:additionalKeyTwo","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:additionalValueOne","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:additionalValueTwo","oasType":"schema","type":"unknown"}

approval_codestring

rrnstring

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:txnid","oasType":"schema","type":"unknown"}

tran_nointeger

staninteger

is_partial_approveinteger

partial_amountstring

panstring

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:card_type","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:phone_number","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:email_id","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:zip","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:card_holder_name","oasType":"schema","type":"unknown"}

expiry_datestring

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:address","oasType":"schema","type":"unknown"}

epistring

channelstring

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:token","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/?giftBalance:post:responses:200:content:application/json:schema:properties:card_brand","oasType":"schema","type":"unknown"}

netamtnumber

Example response

{
  "error_no": "S00",
  "success_url": true,
  "error_code": "00",
  "amount": "1708.66",
  "msg": "APPROVED",
  "approval_code": "000000",
  "rrn": "004012055003",
  "tran_no": 8,
  "stan": 686,
  "partial_amount": "000000000000",
  "pan": "XXXX2926",
  "expiry_date": "/",
  "epi": "2319916601",
  "channel": "VT",
  "netamt": 1708.66
}