v1

latestOpenAPI 3.1.02026-08-0425501.2 MB

Add Balance

post/?addBalance

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 'giftaddvalue'

amountnumber double required

Base amount of original sale (Ex: 10.00)

card_nostring required

Customer gift card number 15 to 19 digits

pininteger

Customer gift card pin number

Response

200

error_nostring

success_urlboolean

error_codestring

amountstring

taxstring

customfeestring

msgstring

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

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

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

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

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

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

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

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

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

approval_codestring

rrnstring

txnidstring

tran_nointeger

staninteger

is_partial_approveinteger

partial_amountstring

panstring

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

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

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

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

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

expiry_datestring

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

epistring

channelstring

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

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

netamtinteger

Example response

{
  "error_no": "S00",
  "success_url": true,
  "error_code": "00",
  "amount": "10.00",
  "msg": "APPROVED",
  "approval_code": "000000",
  "rrn": "004012056001",
  "txnid": "5846171",
  "tran_no": 8,
  "stan": 688,
  "partial_amount": "000000001000",
  "pan": "XXXX2926",
  "expiry_date": "/",
  "epi": "2319916601",
  "channel": "VT",
  "netamt": 10
}