Authorization and capture

With this endpoint you can carry out preauthorizations, make reauthorizations, capture a payment, and void a preauthorization on a card-present transaction in Chile.

Supported reading channels

ICC — Integrated Circuit Card (chip)

MCR — Magnetic Card reader

NFC — Near Field Communication (contactless)

Make a preauthorization (place a hold on a card)

You can retain the balance of a card to withhold a certain amount pending capture.

Structure

Send preAuth in the transaction_type field and Authorization in the transaction_mode field as part of the body of your request. (See full example on the right side of the screen.)

Make a reauthorization

You can extend the amount or effect of an existing authorization.

The currency must be the same as the original authorization.

An amount of 0 can be sent in the reauthorization to extend the capture date without increasing the hold amount.

The reauthorization can be for an amount greater than the original authorization.

NOTE: A reauthorization can be canceled. After the cancellation, no further reauthorizations can be made on that transaction.

Structure

Send reAuthorization in the transaction_type field and Authorization in the transaction_mode field, along with the transaction_reference of the original preauthorization.

Capture a payment

Once you're ready to collect the funds, capture the amount you define.

The capture amount must equal the sum of the authorization and all non-canceled reauthorizations, or less. Send capture in the transaction_type field, Authorization in the transaction_mode field, and the transaction_reference of the transaction to capture — this reference must come from the authorization, not from a reauthorization.

Cardless operations

You can perform a reauthorization, capture, or void without requiring the card to be read again — useful when you already captured the card data in a previous step.

NOTE: You can also check the information for a cardless refund.

To perform a cardless operation, send omit_card: true. The fields required for a cardless operation are:

PROPERTY	TYPE	Allowed values
`amount`	`Object`
`transaction_mode`	`String`	`Authorization`, `Void`
`transaction_type`	`String`	`charge`, `reAuthorization`, `capture`
`client_transaction_id`	`String`
`transaction_reference`	`String`
`omit_card`	`Boolean`	`true`

NOTE: Cardless operations are available for Visa and Mastercard credit and debit cards in Chile.

Example of a cardless operation

To perform a cardless operation, send omit_card: true and omit the other non-required fields:

{
    "amount": {
        "currency": "CLP",
        "iva": 0,
        "subtotal_iva": 0,
        "subtotal_iva0": 20000
    },
    "transaction_mode": "Authorization",
    "transaction_type": "reAuthorization",
    "client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a",
    "transaction_reference": "f2f29080-0214-42c0-95a5-77ecf3434cd7",
    "omit_card": true
}

{
    "amount": {
        "currency": "CLP",
        "iva": 0,
        "subtotal_iva": 0,
        "subtotal_iva0": 20000
    },
    "transaction_mode": "Authorization",
    "transaction_type": "capture",
    "client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a",
    "transaction_reference": "f2f29080-0214-42c0-95a5-77ecf3434cd7",
    "omit_card": true
}

{
    "amount": {
        "currency": "CLP",
        "iva": 0,
        "subtotal_iva": 0,
        "subtotal_iva0": 20000
    },
    "transaction_mode": "Void",
    "transaction_type": "charge",
    "client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a",
    "transaction_reference": "f2f29080-0214-42c0-95a5-77ecf3434cd7",
    "omit_card": true
}

Hold limits

Card type	Maximum hold duration
Credit card	28 days
Debit card	7 days

If the transaction is not captured within the allowed period, the held funds are released by the issuing bank.

curl --location 'https://api-uat.kushkipagos.com/pos/v1/transaction' \ --header 'Private-Credential-Id;' \ --header 'Content-Type: application/json' \ --data '{ "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": 600 }, "country": "CHL", "cvm_type": "none", "is_cashback": false, "pos_details": { "brand": "SUNMI", "model": "P2-EU", "version": "Kushki SunmiV1.1.26", "location": { "latitude": -33.4489, "longitude": -70.6693 }, "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": "preAuth", "client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a" }'

{ "additional_amounts": { "account_type": "string", "amount": 0, "amount_type": "string", "card_type": "string", "currency_code": "string" }, "authorized_amount": 0, "card_type": "debit", "cvm_type": "string", "F11": "string", "franchise": "VISA", "kushki_response": { "code": "string", "message": "string" }, "message_fields": { "F38": "string", "F39": "string", "F55": "string" }, "transaction_reference": "string", "transaction_status": "APPROVAL", "transaction_type": "string", "ticket_number": "string" }

Supported reading channels

Make a preauthorization (place a hold on a card)

Structure

Make a reauthorization

Structure

Capture a payment

Cardless operations

Example of a cardless operation

Hold limits

Request

Responses

Authorization and capture

Supported reading channels#

Make a preauthorization (place a hold on a card)#

Structure#

Make a reauthorization#

Structure#

Capture a payment#

Cardless operations#

Example of a cardless operation#

Hold limits#

Request

Responses

Supported reading channels

Make a preauthorization (place a hold on a card)

Structure

Make a reauthorization

Structure

Capture a payment

Cardless operations

Example of a cardless operation

Hold limits