v1

latestOpenAPI 3.1.02026-08-0425501.2 MB

Void API

post/api/v1/void

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

amountstring

Base amount of original sale (Ex: 10.00). The amount is optional when ref_txn_id is provided. If auth_code, rrn, transaction number, and STAN are provided in the request, then the amount is required.

ref_txn_idstring required

A unique response transaction id from the response of a sale transaction (Numeric - Length of 20 chars)

surchargeindicatorstring required

The value '0' represents a transaction being ran on the traditional MID with no custom fee added, while '1' represents a transaction being ran on the cash discounting MID with the custom fee added

auth_codestring

Approval code response from sale transaction (Alphanumeric - Max length of 8 chars)

rrnstring

RRN number from sale txn response (Numeric - Max length of 15 chars)

tran_nostring

Should match the original sale tran_no (Numeric - Max length of chars 11)

stanstring

Should match the original sale stan (Numeric - Max length of chars 6)

phonestring

Customer phone number- 10 digit Numeric (Ex: 5247896523)

emailstring

Customer email id - Varchar (Ex: test@domain.com, Max length of 50 chars)

child_epistring

If the merchant has multi-MIDs, they need to send both the child EPI and the parent EPI in the EPI request

Response

200

object required