Sale request types

Our API offers three different methods for processing payments with debit and credit cards:

Simple sale: Charges the customer's debit or credit card directly.
Card Tokenization and Charge via Token: Tokenizes the customer's card information and processes the charge using the generated token.
Charge with 3DS (3D Secure): Processes payments using the 3D Secure protocol to enhance transaction security.

3DS Process

The transaction result will be returned in the "result" query parameter, encoded in base64 and hosted in the URL send when initialize the transaction. You will need to decode this value to access the transaction response object.

Recurrence charges

To indicate the frequency of charges you have to send any of these values in the recurrence field:

daily : every 1 day.
weekly: every 7 days.
biweekly: every 15 days.
monthly: every 30 days.
threefortnights: every six weeks or 42 days.
bimonthly: every 60 days.
quarterly: every 90 days.
fourmonths: every 120 days.
halfyearly: every 180 days
yearly: every 360 days.

Sale parameters

Parameter	Type	Description
amount	Number	Amount of transaction
currency	String	"484" all transactions must be in Mexican pesos
reference	String	E-commerce external identifier
customerInformation	Object	Customer information
customerInformation.firstName	String	Customer firstname
customerInformation.lastName	String	Customer lastname
micustomerInformation.middleName	String	Customer middlename
customerInformation.phone1	String	Customer phone
customerInformation.email	String	Customer email
customerInformation.city	String	Customer city
customerInformation.address1	String	Customer address
customerInformation.postalCode	String	Customer postalcode
customerInformation.state	String	Customer state
customerInformation.country	String	Customer country ISO in 2 characters
customerInformation.ip	String	Customer IP
cardData	Object	Card information
cardData.cardholderName	String	Card owner name
cardData.cardNumber	String	Card number
cardData.expirationMonth	String	Card expiration month
cardData.expirationYear	String	Card expiration year
cardData.cvv	String	Card CVV or CVC

Accounts in El Salvador

For accounts in El Salvador only, the following parameters must be changed:

	ASCII	HTML
currency	String	"840" all transactions must be in USD
redirectUrl	String	Redirect URL with response 3DS

Transactions

Each method has its own benefits and can be used in different scenarios based on your business needs. The following sections provide examples of each method: