Void & Reverse

Void service is available in Perú.

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 Peru (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`

NOTE: Cardless operations are currently in Beta phase in Peru for Visa and Mastercard credit and debit cards.

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

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