Reauthorize a preauthorization
With this service, you can perform the following actions to modify a transaction that was previously approved::
- Increase the payment amount
- Make an adjustment to the authorization.
- Sending an amount of $0 in the reauthorization is a common practice to extend the capture date without actually capturing any funds from the cardholder’s account.
To perform reauthorizations, you need to consume the endpoint https://api-uat.kushkipagos.com
/pos/v1/transaction
and send reAuthorization
in the transaction_type
field and Authorization
in the transaction_mode
field as part of the request body. It also include the transaction_reference
of the preauthorization.
Please follow the steps in the guide available in the API.
The request you need to send depends on the reading channel of your merchant’s POS terminal (chip, magnetic stripe, contactless [NFC]). Please review the examples below:
- JSON
- JSON
- JSON
//ICC (Chip){"card": {"card_holder_name": "John Doe"},"amount": {"iva": 0,"tip": 0,"currency": "CLP","extra_taxes": {"iac": 0,"ice": 0,"airport_tax": 0,"travel_agency": 0},"subtotal_iva": 0,"subtotal_iva0": 60000},"country": "COL","cvm_type": "none","is_cashback": false,"is_deferred": false,"pos_details": {"brand": "SUNMI","model": "P2-EU","version": "Kushki SunmiV1.1.26","location": {"latitude": -0.22480833333333333,"longitude": -78.487955},"has_print": true,"terminal_id": "PB04216R20537"},"card_details": {"tracks": {"track_ksn": "FFFF4357486333600002","enc_track2": "283587285CE10278E7FA50AD5C97CFFE87F472C9FE6406F8"},"enc_tlv": "CE447A062C49774934E42A7F826668C0C478E38402C158062EE794C0E471B43EA8CE49C256C2C8B157526B0B2BE74FC23F65E18D4F52B99A1A0910E6CCD9B11A32D6D537E2B6E2B011C89569DE6A3D53318080BC77E0E70B398ED3083FD7366CCF8FB4DBF34A116E6D52CFBEF26371878D842034E5029EF62DF235D2C427F04102E451773D9E8975978917E3BC531327702967052E239F8C592734AE14688E603C52B858FC1D97B763AE623603F1475FFFB065EC07AF7A29","pin_ksn": "FFFF4357486333600002","reading_type": "ICC"},"contact_details": {"email": "","last_name": "","first_name": "","phone_number": "","document_type": "-1","document_number": "","second_last_name": ""},"transaction_mode": "Authorization","transaction_type": "reAuthorization","client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a","transaction_reference": "f2f29080-0214-42c0-95a5-77ecf3434cd7"}
//MCR{"card": {"card_holder_name": "John Doe"},"amount": {"iva": 0,"tip": 0,"currency": "CLP","extra_taxes": {"iac": 0,"ice": 0,"airport_tax": 0,"travel_agency": 0},"subtotal_iva": 0,"subtotal_iva0": 2000},"country": "COL","pos_details": {"brand": "SUNMI","model": "P2-EU","version": "Kushki SunmiV1.1.13","location": {"latitude": -0.1848534,"longitude": -78.4769761},"has_print": true,"terminal_id": "PB04209860189"},"card_details": {"tracks": {"track_ksn": "FFFF4357486333600002","enc_track1": "06056D9EE9D77E4D846912F77C0B37C5FC6A95D1DF21DD502D3A08E8141CF82818F5DC4FA7637F400EA488D388F2B70F8A22EAEFBBEEDDE93A118BFB789BD8C0","enc_track2": "FD580B3BBFCCB821EAB4AB64947C4632C0BE6C70AB4ECDE4"},"pin_ksn": "FFFF4357486333600002","reading_type": "MCR"},"contact_details": {"email": "","last_name": "","first_name": "","phone_number": "","document_type": "0","document_number": "123666","second_last_name": ""},"transaction_mode": "Authorization","transaction_type": "reAuthorization","client_transaction_id": "ae6dd91a-9173-4ec7-8934-3178454ef341"}
//NFC{"card": {"card_holder_name": "John Doe"},"amount": {"iva": 0,"tip": 0,"currency": "CLP","extra_taxes": {"iac": 0,"ice": 0,"airport_tax": 0,"travel_agency": 0},"subtotal_iva": 0,"subtotal_iva0": 2000},"country": "COL","pos_details": {"brand": "SUNMI","model": "P2-EU","version": "Kushki SunmiV1.1.13","location": {"latitude": -0.1848534,"longitude": -78.4769761},"has_print": true,"terminal_id": "PB04209860189"},"card_details": {"tracks": {"track_ksn": "FFFF4357486333600002","enc_track2": "283587285CE10278E7FA50AD5C97CFFE87F472C9FE6406F8"},"enc_tlv": "CE447A062C49774934E42A7F826668C0A53CE9AF633A510E66C8031171AAFCF8CE29857B19101326ED67512533B86C51ED16C5E624DA97EDA72864A39763822418FCAC5439D2F1F72F6FC0BAA6EED37630767D9D161612654E49944FC435525C6C356177B1BD0A545C19FF5E47685E35B02B20B307BDE2A26FAD2F42D7CB00BE9C53FD05BECE71110919ADE3158398B8B02003F682374B942C4B6D7FD54DE2B65A9C66125DF28A80","pin_ksn": "FFFF4357486333600002","reading_type": "NFC"},"contact_details": {"email": "","last_name": "","first_name": "","phone_number": "","document_type": "0","document_number": "123666","second_last_name": ""},"transaction_mode": "Authorization","transaction_type": "reAuthorization","client_transaction_id": "ae6dd91a-9173-4ec7-8934-3178454ef341"}
Reauthorization without card
It is possible to perform reauthorizations by omitting the card details. To do so, you must send the omit_card
field with a value of true
. See here for details of the transaction body when you want to omit this information.
{"amount": {"currency": "CLP","iva": 0.0,"subtotal_iva": 0.0,"subtotal_iva0": 600000},"transaction_mode": "Authorization","transaction_type": "reAuthorization","client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a","transaction_reference": "f2f29080-0214-42c0-95a5-77ecf3434cd7","omit_card": true}
How to cancel a reauthorization?
To cancel a reautorization, send the transaction_reference of the last reautorization generated. See the example here.