Void & Reverse

With this endpoint you can cancel a transaction (void), roll one back after a timeout (reverse), and do either without re-reading the card.

Void a transaction

Voiding cancels an authorization or a completed order identified by its transaction_reference — the reference returned when the original charge or deferred charge was approved.

INFO

For a partial void, include the amount object with the portion you want to cancel. Omit it for a full void.

Structure: send Void in transaction_mode, plus the transaction_reference of the transaction you're cancelling.

WARNING

Voids are only accepted the same day as the original transaction, before 23:59 Chile local time. Once that cutoff passes, Kushki processes the request as a refund instead — same transaction_reference, no extra steps on your side.

Reverse a transaction

Use a reverse when a request times out or the connection drops and you don't know whether the charge actually went through. It's a safety net for uncertain outcomes, not a general-purpose cancellation.

Structure: send Reverse in transaction_mode, plus the client_transaction_id of the transaction you're reversing (not transaction_reference).

WARNING

Reverses are only valid the same day as the original transaction, before 23:59 Chile local time — and only after waiting at least 1 minute from the original request.

Cardless operations

Void, reverse, capture, and reauthorization can all be done without reading the card again — useful when you already captured the card data in a previous step and just need to adjust or cancel that transaction. Send omit_card: true and drop everything except the fields below:

Property	Type	Allowed values
`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` (optional)	Boolean	`true`, `false`

TIP

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

Chile only — is_smart_void

For BCI, Banco de Chile, and Scotiabank credit cards, set is_smart_void: true so Kushki routes the cancellation as a refund behind the scenes instead of a void — these issuers don't process straight voids reliably.

Example — cardless capture:

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

Example — cardless void:

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

Example — cardless reverse:

{
    "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 'https://api-uat.kushkipagos.com/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": "", "amount": 0, "amount_type": "", "card_type": "", "currency_code": "CLP" }, "authorized_amount": 600, "card_type": "debit", "cvm_type": "none", "F11": "195967", "franchise": "VISA", "kushki_response": { "code": "000", "message": "Approval and completed successfully Accepted and processed." }, "message_fields": { "F38": "123456", "F39": "00" }, "transaction_reference": "260091a5-3ce6-43bd-92ef-4100b024fcd9", "transaction_status": "APPROVAL", "transaction_type": "charge", "ticket_number": "111728108177182252" }

Void a transaction

Reverse a transaction

Cardless operations

Request

Responses

Void & Reverse

Void a transaction#

Reverse a transaction#

Cardless operations#

Request

Responses

Void a transaction

Reverse a transaction

Cardless operations