Void API

app_id

string

required

Defaults to WaJeJErcv5xpqZa2UZz6LZod5MSyyfJw

Merchant APP ID (Alphanumeric - Length of 32 chars)

auth_key

string

required

Defaults to 53PWdki5U0PGSVhRnVoFsfVSbuDutsA8

Merchant APP Key (Alphanumeric - Length of 32 chars)

epi

string

required

Defaults to 2203082193

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

mtype

string

required

Defaults to void

Message type should be set as 'void'

rrn

string

required

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

auth_code

string

required

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

tran_no

int32

required

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

stan

int32

required

STAN number (Numeric - Max length of 6 chars)

amount

double

required

Defaults to 1000

Add excess two zero for original void transaction amount (ex: 10.00 means 1000)

pos_entry_mode

string

required

Defaults to 012

Mode of transaction in POS terminal (Numeric - length of max chars)

surchargeIndicator

int32

required

Defaults to 1

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

pos_condition_code

int32

Defaults to 8

Check the condition of transaction (length of max 3 chars)

phone

string

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

userid

string

Defaults to 12043

Customer user id - Numeric max length of 11 chars

string

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

uid

string

A unique id of the request, A client can send any number of 10 digit

tax

double

Defaults to 0

Tax amount - Currency $ (Eg. 00.00)

custom_fee

double

Defaults to 10

Custom fee/surcharge fee if any - Add excess two zero for original amount (ex: 5.00 means 500)

tip_amount

double

Tip if any - Optional (Eg. 00.00)

xxxxxxxxxx
curl --request POST \
     --url 'https://vt-staging.valorpaytech.com:4430/?app_id=WaJeJErcv5xpqZa2UZz6LZod5MSyyfJw&auth_key=53PWdki5U0PGSVhRnVoFsfVSbuDutsA8&epi=2203082193&mtype=void&amount=1000&pos_entry_mode=012&surchargeIndicator=1&pos_condition_code=8&userid=12043&tax=0&custom_fee=10&/?void=' \
     --header 'accept: application/json'

200200

400400