Anular y reversar

Con este endpoint puedes cancelar una transacción (anulación), deshacerla después de un timeout (reverso) y hacer cualquiera de las dos sin volver a leer la tarjeta.

Anular una transacción

La anulación cancela una autorización o una orden completada identificada por su transaction_reference: la referencia que se entrega cuando el cargo o el cargo diferido original fue aprobado.

INFO

Para una anulación parcial, incluye el objeto amount con la porción que quieres cancelar. Omítelo para una anulación total.

Estructura: envía Void en transaction_mode, junto con el transaction_reference de la transacción que estás cancelando.

WARNING

Las anulaciones solo se aceptan el mismo día de la transacción original, antes de las 23:59 hora local de Chile. Pasado ese corte, Kushki procesa el request como un reembolso: el mismo transaction_reference, sin pasos extra de tu lado.

Reversar una transacción

Usa un reverso cuando un request se vence por timeout o se corta la conexión y no sabes si el cargo se procesó o no. Es una red de seguridad para resultados inciertos, no una cancelación de uso general.

Estructura: envía Reverse en transaction_mode, junto con el client_transaction_id de la transacción que estás reversando (no el transaction_reference).

WARNING

Los reversos solo son válidos el mismo día de la transacción original, antes de las 23:59 hora local de Chile, y solo después de esperar al menos 1 minuto desde el request original.

Operaciones sin tarjeta

La anulación, el reverso, la captura y la reautorización se pueden hacer sin volver a leer la tarjeta: es útil cuando ya capturaste los datos de la tarjeta en un paso anterior y solo necesitas ajustar o cancelar esa transacción. Envía omit_card: true y omite todo salvo los campos de abajo:

Propiedad	Tipo	Valores permitidos
`amount`	Object	—
`transaction_mode`	String	`Authorization`, `Void`, `Reverse`
`transaction_type`	String	`capture`, `charge`, `preAuth`
`client_transaction_id`	String	—
`transaction_reference`	String	—
`omit_card`	Boolean	`true`
`is_smart_void` (opcional)	Boolean	`true`, `false`

TIP

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

Solo Chile — is_smart_void

Para transacciones con tarjeta de crédito de BCI, Banco de Chile y Scotiabank, puedes enviar opcionalmente is_smart_void: true para que Kushki procese la cancelación como un reembolso en vez de una anulación. Por defecto es false.

Ejemplo — captura sin tarjeta:

{
    "amount": {
        "currency": "CLP",
        "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
}

Ejemplo — anulación sin tarjeta:

{
    "amount": {
        "currency": "CLP",
        "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
}

Ejemplo — reverso sin tarjeta:

{
    "amount": {
        "currency": "CLP",
        "iva": 0.0,
        "subtotal_iva": 0.0,
        "subtotal_iva0": 600
    },
    "transaction_mode": "Reverse",
    "transaction_type": "charge",
    "client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a",
    "omit_card": true
}

curl --location '/pos/v1/transaction' \ --header 'Private-Credential-Id;' \ --header 'Content-Type: application/json' \ --data '{ "amount": { "currency": "CLP", "iva": 0, "subtotal_iva": 0, "subtotal_iva0": 60000 }, "transaction_mode": "Void", "transaction_type": "charge", "client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a", "transaction_reference": "f2f29080-0214-42c0-95a5-77ecf3434cd7", "omit_card": true }'

{ "additional_amounts": { "account_type": "string", "amount": 0, "amount_type": "string", "card_type": "string", "currency_code": "string" }, "authorized_amount": 0, "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" }

Anular una transacción

Reversar una transacción

Operaciones sin tarjeta

Request

Responses

Anular y reversar

Anular una transacción#

Reversar una transacción#

Operaciones sin tarjeta#

Request

Responses

Anular una transacción

Reversar una transacción

Operaciones sin tarjeta