Autorización y captura

Con este endpoint puedes hacer preautorizaciones, reautorizaciones, capturar un pago y anular una preautorización en una transacción presencial en Chile.

Canales de lectura soportados

ICC — Integrated Circuit Card (chip)

MCR — Magnetic Card reader

NFC — Near Field Communication (contactless)

Hacer una preautorización (retener el saldo de una tarjeta)

Puedes retener el saldo de una tarjeta para reservar un monto determinado en espera de la captura.

Estructura

Envía preAuth en el campo transaction_type y Authorization en el campo transaction_mode como parte del body de tu request. (Revisa el ejemplo completo al lado derecho de la pantalla).

Hacer una reautorización

Puedes extender el monto o la vigencia de una autorización existente.

La moneda debe ser la misma de la autorización original.

Puedes enviar un monto de 0 en la reautorización para extender la fecha de captura sin aumentar el monto retenido.

La reautorización puede ser por un monto mayor al de la autorización original.

NOTA: Una reautorización se puede anular. Después de anularla, no se pueden hacer más reautorizaciones sobre esa transacción.

Estructura

Envía reAuthorization en el campo transaction_type y Authorization en el campo transaction_mode, junto con el transaction_reference de la preautorización original.

Capturar un pago

Cuando estés listo para cobrar los fondos, captura el monto que definas.

El monto de la captura debe ser igual a la suma de la autorización y de todas las reautorizaciones no anuladas, o menor. Envía capture en el campo transaction_type, Authorization en el campo transaction_mode y el transaction_reference de la transacción a capturar: esta referencia debe venir de la autorización, no de una reautorización.

Cardless operations

Puedes hacer una reautorización, una captura o una anulación sin necesidad de volver a leer la tarjeta: es útil cuando ya capturaste los datos de la tarjeta en un paso anterior.

NOTA: También puedes revisar la información de un reembolso sin tarjeta.

Para hacer una operación sin tarjeta, envía omit_card: true. Los campos obligatorios para una operación sin tarjeta son:

PROPIEDAD	TIPO	Valores permitidos
`amount`	`Object`
`transaction_mode`	`String`	`Authorization`, `Void`
`transaction_type`	`String`	`charge`, `reAuthorization`, `capture`
`client_transaction_id`	`String`
`transaction_reference`	`String`
`omit_card`	`Boolean`	`true`

NOTA: Las operaciones sin tarjeta están disponibles para tarjetas de crédito y débito Visa y Mastercard en Chile.

Ejemplo de una operación sin tarjeta

Para hacer una operación sin tarjeta, envía omit_card: true y omite los demás campos no obligatorios:

{
    "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
}

Límites de la retención

Tipo de tarjeta	Duración máxima de la retención
Tarjeta de crédito	28 días
Tarjeta de débito	7 días

Si la transacción no se captura dentro del plazo permitido, el banco emisor libera los fondos retenidos.

curl --location '/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" }

Canales de lectura soportados

Hacer una preautorización (retener el saldo de una tarjeta)

Estructura

Hacer una reautorización

Estructura

Capturar un pago

Cardless operations

Ejemplo de una operación sin tarjeta

Límites de la retención

Request

Responses

Autorización y captura

Canales de lectura soportados#

Hacer una preautorización (retener el saldo de una tarjeta)#

Estructura#

Hacer una reautorización#

Estructura#

Capturar un pago#

Cardless operations#

Ejemplo de una operación sin tarjeta#

Límites de la retención#

Request

Responses

Canales de lectura soportados

Hacer una preautorización (retener el saldo de una tarjeta)

Estructura

Hacer una reautorización

Estructura

Capturar un pago

Cardless operations

Ejemplo de una operación sin tarjeta

Límites de la retención