REVERSAL

IT-OF-022
 INTRODUCTION
This document explains how to use the API to perform a Reversal. To have full
understanding on how to encrypt some fields, please refer to the How to Encrypt
document.
Keep in mind that you must switch between the QA and Production environments.
To learn more about this, please refer to the corresponding document. Each step in
this manual consumes an endpoint, and they can be found in the QA ENDPOINTS
or PRODUCTION ENDPOINTS document.
 PERFORMING A REVERSAL
In each service, consider that you must send the x-request-with header and
remember that some of the fields within the JSON object could be encrypted. (For
more information see the How to Encrypt and the Endpoints QA documents).
For more information about the response codes, please see the Response Codes
document.

To perform a successful Reversal, it is necessary to execute the following step:

a) Generate a Reversal
In this step, you must send a JSON following the example below:
{
"affiliation": "1234567",
"amount": 56.78,
"transactionDate": 1396337052148,
"orderId": "12345",

"pan":"d1746575dadaa9819b40bb98355d24177a412355c73835d7c6848b30d12d10be",
"cardholderName":"a137de9f88ee0be325b84000f7958243",
"cvv2":"949bdb88f4da811ef5487e8e62b79253",
"expDate":"9294ab1738cdfe70ba9f62f5ca74bd78",
"authnum":"54654",
"transactionId":"654"
}
 FIELD MANDATORY TYPE DETAILS
Your affiliation
number.
affiliation Yes String
15 characters
Max.
The amount of
amount Yes Numeric the sale to be
refunded
The actual date.
transactionDate Yes Numeric
EPOCH format
The orderId of
orderId Yes String the sale to be
refunded
The same PAN of
the original
sale to be
pan Yes String
refunded may be
used.
Encryption data.
The same PAN of
the original
sale to be
cardholderName Yes String
refunded may be
used.
Encryption data.
The same PAN of
the original
sale to be
cvv2 No String
refunded may be
used.
Encryption data.
The same PAN of
the original
sale to be
expDate Yes String
refunded may be
used.
Encryption data.
authnum Yes String This Data is
obtained when
you perform a
transactionId Yes String
Sale (EMV,
swipe, etc.)
If everything is correct, the response will be like this:
{
"responseCode": "00"
}

FIELD TYPE DETAILS

If this code is
different from “00”,
responseCode String please refer to the
Response Codes
document.