⚠️

Warning

Authorization responses are subject to the addition of new fields from card brands/issuers.
Integrate in a way that anticipates this behavior by properly using serialization and deserialization techniques.

ℹ️

The capture of the credit transaction can be automatic or later.

• For automatic capture, send the Payment.Capture `parameter in the request as “true”;
• For later capture, send the parameter as "false" and subsequently make the capture after authorization.

⚠️

• By default, the API E-commerce accepts up to 12 installments for credit cards.
  • To enable up to 24 installments, you must contact E-commerce Support. Activation is subject to review and approval.

Warning

• It is not possible to perform a transaction with an Amount of 0. To verify the validity of a card, use Zero Auth;
• Mastercard credit transactions with stored credentials: Mastercard requires the Transaction Initiation Indicator for credit and debit card purchases using stored card data. The goal is to indicate whether the transaction was initiated by the cardholder (Cardholder-Initiated Transaction - CIT) or by the merchant (Merchant-Initiated Transaction - MIT). In this scenario, it is mandatory to send the InitiatedTransactionIndicator node with the Category and SubCategory parameters for Mastercard transactions, within the Payment node. Check the example of the node and the list of categories and subcategories in Mastercard Transaction Initiator Indicator.
• The Payment.ServiceTaxAmount field is exclusive to airlines and travel agencies, allowing them to charge the boarding fee separately from the airfare.
• To confirm if authentication was accepted in the authorization, check the ECI value returned in Payment.Eci. The API replicates the ECI informed by the merchant in the Payment.ExternalAuthentication field. However, the value actually used by the brand in the authorization is the one shown in Payment.Eci.

ℹ️

Important

The validation and return of the Payment.Eci field occur only in the production environment at this initial stage.

Visa Intelligent Data Exchange (IDX)

If you use Visa’s IDX authentication service, see Visa Intelligent Data Exchange (IDX).

Cancellation guarantee

When a transaction returns with the status Not Finalized and the Void Guarantee feature is enabled for the merchant, do not reuse the same MerchantOrderID value in new transaction attempts.

For subsequent attempts, generate a new order identifier. Resubmitting a transaction using the same MerchantOrderID from an attempt that returned as Not Finalized can cause processing errors.

Credit card transaction response

Following table presents the main parameters that may be returned by the API when creating a credit card payment.