Void & Reverse

🔐 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.

With this endpoint you can:

Make cancellations

Perform reverse transactions

Cardless operations

Make cancellations (voids)

You can void an authorization or an order identified by its transaction_reference number. The transaction_reference is provided when a charge or a deferred charge is successful.

For partial voids, it is necessary to send the amount object.

Structure

To void a transaction send Void in the transaction_mode field, and the transaction_reference of the transaction to cancel as part of the body of your request. (See full example on the right side of the screen).

Discover how to perform a cardless void.

If a void is performed after the allowed time limit, the request will be processed as a refund.

Make reverses

In case there are communication issues, and you are not sure if a transaction was approved or declined, you can perform a reverse to void a transaction.

Reversals are only available on the same day as the transaction was made, before 23:59 for Chile and Peru or 22:59 for Mexico (approximate time). Please note that you must wait at least 1 minute after the transaction before initiating a reversal.

Structure

To reverse a transaction send Reverse in the transaction_mode field, and the client_transaction_id of the transaction to reverse as part of the body of your request. (See full example on the right side of the screen).

Cardless operations

You can perform a reauthorization, capture, reverse, or void without requiring the reading of the card. Below you will find out how you can carry out a cardless operation:

NOTE: You can also check the information for a cardless refund.

To perform an operation without a card it is required to send the omit_card field with the value of true in the request. The fields required for a cardless operation are the following:

PROPERTY	TYPE	Allowed values
`amount`	`Object`
`transaction_mode`	`String`	`Authorization`, `Void`, `Reverse`
`transaction_type`	`String`	`charge`, `preAuth`, `capture`
`client_transaction_id`	`String`
`transaction_reference`	`String`
`omit_card`	`Boolean`	`true` `false`
`is_smart_void` (optional)	`Boolean`	`true` `false`

NOTE: Cardless operations are available for Visa and Mastercard credit and debit cards in Chile and international Mexico. Local Mexico it is also available, processed through PROSA. It is currently in Beta phase in Mexico and Peru.

Example of a cardless operation

To perform a cardless operation, the omit_card field is sent with the value of true and then the other non-required fields are omitted:

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

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

Make cancellations (voids)

Structure

Make reverses

Structure

Cardless operations

Example of a cardless operation

Request

Responses

Void & Reverse

Make cancellations (voids)#

Structure#

Make reverses#

Structure#

Cardless operations#

Example of a cardless operation#

Request

Responses

Make cancellations (voids)

Structure

Make reverses

Structure

Cardless operations

Example of a cardless operation