Pre-Authorization Editing Service
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.