Autorización y captura

🔐 Producto en versión beta en Colombia

Estamos trabajando en nuestra versión beta. ¡Manténte atento a su lanzamiento oficial! También puedes contactar a tu gerente de cuenta para más información.

Con este endpoint puedes:

Realizar preautorizaciones

Realizar reautorizaciones

Realizar 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

Realizar preautorizaciones (retener el pago con tarjeta)

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

Estructura

Para realizar autorizaciones, envía preAuth en el campo transaction_type y Authorization en el campo transaction_mode como parte del body de tu solicitud. (Revisa el ejemplo completo en la parte derecha de la pantalla).

Realizar reautorizaciones

Puedes ampliar 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 la anulación, no puedes realizar reautorizaciones sobre la transacción anulada.

Estructura

Para realizar reautorizaciones, envía reAuthorization en el campo transaction_type y Authorization en el campo transaction_mode como parte del body de tu solicitud. (Revisa el ejemplo completo en la parte derecha de la pantalla).

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

Capturar un pago

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 realizadas que no se hayan anulado. 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 solicitud (el transaction_reference debe ser de una autorización, no de una reautorización). (Revisa el ejemplo completo en la parte derecha de la pantalla).

Descubre cómo realizar una captura sin tarjeta.

Operaciones sin tarjeta

Puedes realizar una reautorización, captura o una anulación sin necesidad de leer la tarjeta. A continuación descubres cómo realizar una operación sin tarjeta:

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

Para realizar una operación sin tarjeta debes enviar el campo omit_card con el valor true en la solicitud. Los campos requeridos 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 disponibles para tarjetas de crédito y débito Visa y Mastercard en Colombia.

Ejemplo de una operación sin tarjeta

Para realizar una operación sin tarjeta, envía el campo omit_card con el valor true y omite los demás campos no requeridos:

{
    "amount": {
        "currency": "COP",
        "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": "COP",
        "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": "COP",
        "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 '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": "COP", "extra_taxes": { "iac": 0, "ice": 0, "airport_tax": 0, "travel_agency": 0 }, "subtotal_iva": 0, "subtotal_iva0": 600 }, "country": "COL", "cvm_type": "none", "is_cashback": 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": "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

Realizar preautorizaciones (retener el pago con tarjeta)

Estructura

Realizar reautorizaciones

Estructura

Capturar un pago

Estructura

Operaciones sin tarjeta

Ejemplo de una operación sin tarjeta

Request

Responses

Autorización y captura

Canales de lectura soportados#

Realizar preautorizaciones (retener el pago con tarjeta)#

Estructura#

Realizar reautorizaciones#

Estructura#

Capturar un pago#

Estructura#

Operaciones sin tarjeta#

Ejemplo de una operación sin tarjeta#

Request

Responses

Canales de lectura soportados

Realizar preautorizaciones (retener el pago con tarjeta)

Estructura

Realizar reautorizaciones

Estructura

Capturar un pago

Estructura

Operaciones sin tarjeta

Ejemplo de una operación sin tarjeta