Autorización y captura

Los pagos presenciales mediante autorización y captura están disponibles en Perú.

Con este endpoint puedes:

Realizar preautorizaciones

Hacer reautorizaciones

Hacer capturas

Anular preautorizaciones

Canales de lectura soportados

Soportamos los siguientes canales de lectura. Los campos que nos envías para procesar un cargo pueden variar según el tipo de lectura.

ICC= Integrated Circuit Card

MCR= Magnetic Card reader

MFC= Multi-Function Card

Hacer preautorizaciones (retener el saldo de un pago con tarjeta)

Puedes retener el saldo de una tarjeta para reservar un monto determinado de la cuenta.

Estructura

Para hacer autorizaciones, 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).

Make reauthorizations

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

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

Puedes enviar un monto de $0 en la reautorización para extender la fecha de captura.

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

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

Estructura

Para hacer reautorizaciones, envía reAuthorization 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).

Descubre cómo hacer una reautorización sin tarjeta.

Capture a payment

Cuando necesites cobrar los fondos de la tarjeta, captura el monto que definas.

La captura debe ser la suma de la autorización y de todas las reautorizaciones hechas que no hayan sido anuladas. El monto a capturar puede ser igual o menor al monto autorizado o reautorizado.

Estructura

Para capturar envía capture en el campo transaction_type, Authorization en el campo transaction_mode y el transaction_reference de la transacción a capturar como parte del body de tu request (el transaction_reference debe ser de una autorización, no de una reautorización). (Revisa el ejemplo completo al lado derecho de la pantalla).

Descubre cómo hacer una captura sin tarjeta.

Cardless operations

Puedes hacer una reautorización, captura o anulación sin necesidad de leer la tarjeta. A continuación te explicamos cómo puedes hacer una operación sin tarjeta:

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

Para hacer una operación sin tarjeta debes enviar el campo omit_card con el valor true en el request. Los campos obligatorios para una operación sin tarjeta son los siguientes:

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 actualmente en fase Beta en Perú para tarjetas de crédito y débito Visa y Mastercard.

Ejemplo de una operación sin tarjeta

Para hacer una operación sin tarjeta, se envía el campo omit_card con el valor true y se omiten los demás campos no obligatorios:

{
    "amount": {
        "currency": "PEN",
        "iva": 0.0,
        "subtotal_iva": 0.0,
        "subtotal_iva0": 600
    },
    "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": "PEN",
        "iva": 0.0,
        "subtotal_iva": 0.0,
        "subtotal_iva0": 600
    },
    "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": "PEN",
        "iva": 0.0,
        "subtotal_iva": 0.0,
        "subtotal_iva0": 600
    },
    "transaction_mode": "Void",
    "transaction_type": "charge",
    "client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a",
    "transaction_reference": "f2f29080-0214-42c0-95a5-77ecf3434cd7",
    "omit_card": true
}

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": "PEN", "extra_taxes": { "iac": 0, "ice": 0, "airport_tax": 0, "travel_agency": 0 }, "subtotal_iva": 0, "subtotal_iva0": 600 }, "country": "PER", "cvm_type": "none", "is_cashback": false, "pos_details": { "brand": "SUNMI", "model": "P2-EU", "version": "Kushki SunmiV1.1.26", "location": { "latitude": -12.0464, "longitude": -77.0428 }, "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": "" }, "transaction_mode": "Authorization", "transaction_type": "preAuth", "client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a" }'

{ "additional_amounts": { "account_type": "", "amount": 0, "amount_type": "", "card_type": "", "currency_code": "" }, "authorized_amount": 601, "card_type": "credit", "cvm_type": "none", "F11": "101658", "franchise": "MASTERCARD", "kushki_response": { "code": "000", "message": "Transacción Aprobada." }, "message_fields": { "F38": "890862", "F39": "00" }, "transaction_reference": "2aa48997-a545-4bdb-8e1c-a57546f03e5f", "transaction_status": "APPROVAL", "transaction_type": "preAuth", "ticket_number": "111727462978861299" }

Canales de lectura soportados

Hacer preautorizaciones (retener el saldo de un pago con tarjeta)

Estructura

Make reauthorizations

Estructura

Capture a payment

Estructura

Cardless operations

Ejemplo de una operación sin tarjeta

Request

Responses

Autorización y captura

Canales de lectura soportados#

Hacer preautorizaciones (retener el saldo de un pago con tarjeta)#

Estructura#

Make reauthorizations#

Estructura#

Capture a payment#

Estructura#

Cardless operations#

Ejemplo de una operación sin tarjeta#

Request

Responses

Canales de lectura soportados

Hacer preautorizaciones (retener el saldo de un pago con tarjeta)

Estructura

Make reauthorizations

Estructura

Capture a payment

Estructura

Cardless operations

Ejemplo de una operación sin tarjeta