v1

latestOpenAPI 3.1.02026-08-0425501.2 MB

Capture/Ticket API

post/?ticket

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

ref_txn_idstring required

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

amountnumber double required

Transaction amount - Maximum amount $99,999.99 (Ex: 0.1 to 99,999.99). A request should not be sent when the amount is 0. The amount must be greater than zero

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

tran_nointeger

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)

rrnstring

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

auth_codestring

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

surchargeAmountstring

Additional fee of surcharge amount - Currency $ (Eg: 10.00)

tax_amountstring

The tax amount should be passed for example, $10.00 should be sent as 1000 and $2.01 as 201.

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