Pre-Authorization Editing

Brazil

For GetnetLac route you can change the value of a non-captured preauthorization. Consult our support to avail which other routes have this functionality too. To use this functionality, simply call the doPreAuthorization operation with data from a pre-authorization transaction with status CON (confirmed) in addition to the amount field. Below are the details for this call.

Request Parameters

Parameter	Description	Format	Mandatory
`nit`	Transaction ID in Carat Portal (encrypted). Obtained from beginTransaction's return.	= 64 A	Yes
`authorizer_id`	Carat Portal authorizers ID. See Authorizers.	≤ 3 N	Yes
`amount`	Purchase amount specified by store (in cents).	< 12 AN	Yes
`number`	Buyer card number (PAN).	≤ 19 N	Yes
`token`	Used for recurring pre-authorizations, when the card is already stored at Carat Portal database.	= 88 A	Conditional
`expiry_date`	Card expiration date in format MMAA.	= 4 N	Yes
`security_code`	Security code.	≤ 5 N	Yes
`ecomm_pos_ref`	This field will send and identification that will appear in the PDV field of the SiTef Web report for e-commerce transactions.	≤ 8 AF	No

Response Parameters

Parameter	Description	Format
`code`	Carat Portal response code. Anything besides "0" means failure. See more information at the Response Code document	< 4 N
`message`	Carat Portal response message.	< 500 AN
`acquirer_id`	Acquirer/routing ID used in transaction.	< 4 N
`acquirer_name`	Acquirer/routing name used in transaction.	< 100 AN
`amount`	Purchase amount specified by store (in cents).	< 12 AN
`authorization_number`	Authorization number	< 6 AN
`authorizer_code`	Authorizer responde code.	< 10 AN
`authorizer_date`	Authorizer pre-auth effectuation date, returned by the authorizer on the format DD/MM/AAAA’T’HH:mm. Example: 13/07/2017T16:03	= 16 D
`authorizer_id`	Authorizer ID used in transaction.	< 4 N
`authorizer_merchant_id`	Merchant ID from authorizer.	< 100 AN
`authorizer_message`	Reponse message from authorizer.	< 500 AN
`customer_receipt`	Customer receipt.	< 4000 AN
`eci`	Eletronic Commerce Indicator (pre-authorization security level indicator on transactions via Cielo e-Commerce).	< 3 AN
`esitef_usn`	Carat Portal pre-authorization's unique sequential number.	= 15 N
`host_usn`	Authorizer NSU.	< 15 AN
`issuer`	Issuer code returned by the authorizer.	< 5 AN
`merchant_receipt`	Merchant receipt.	< 4000 AN
`merchant_usn`	Unique sequential number sent by store at the transaction creation.	< 12 AN
`nit`	Carat Portal pre-authorization transaction ID.	= 64 AN
`order_id`	Order ID sent by the store at transaction creation.	< 40 AN
`payment_type`	Payment type from the selected authorizer: B = boleto, C = credit, D = debit, P = Private Label credit card, T = bank transfer, G = gift card, O = other ways of payments, W = Boleto NR via Web Service	= 1 A
`sitef_usn`	SiTef pre-authorization's unique sequential number.	= 6 N
`status`	Carat Portal pre-authorization transaction status.	= 3 AN
`tid`	Acquirer/routing transaction ID. This field is only returned in transactions with external acquirer's.	< 40 AN
`xid`	XID field returned on 3DS authentications or certain acquirers/routings.	< 40 AN

In case of success, the responseCode returned will be '0'. Transaction status will not be changed under any circumstances (success or failure). On the other hand, the fields sitef_usn, host_usn, authorization_number, sitef_date, customer_receipt e merchant_receipt will change in case the edition is confirmed.