Anular y reversar

El servicio de anulación está disponible en Perú.
Con este endpoint puedes:

Hacer anulaciones

Realizar reversos

Operaciones sin tarjeta

Make cancellations (voids)

Puedes anular una autorización o una orden identificada por su número de transaction_reference. El transaction_reference se entrega cuando un cargo o un cargo diferido es exitoso.

Para anulaciones parciales, es necesario enviar el objeto amount.

Estructura de la anulación

Para anular una transacción envía Void en el campo transaction_mode y el transaction_reference de la transacción a anular como parte del body de tu request. (Revisa el ejemplo completo al lado derecho de la pantalla).

Descubre cómo hacer una anulación sin tarjeta.

WARNING

Si haces una anulación después del límite de tiempo permitido, el request se procesa como un reembolso.

Hacer reversos

Si hay problemas de comunicación y no estás seguro de si una transacción fue aprobada o declinada, puedes hacer un reverso para anular la transacción.

Los reversos solo están disponibles el mismo día en que se hizo la transacción, antes de las 23:59 para Perú (hora aproximada). Ten en cuenta que debes esperar al menos 1 minuto después de la transacción antes de iniciar un reverso.

Estructura del reverso

Para reversar una transacción envía Reverse en el campo transaction_mode y el client_transaction_id de la transacción a reversar como parte del body de tu request. (Revisa el ejemplo completo al lado derecho de la pantalla).

Cardless operations

Puedes hacer una reautorización, captura, un reverso o una anulación sin necesidad de leer la tarjeta. A continuación te explicamos cómo puedes hacer una operación sin tarjeta:

NOTA: También puedes revisar la información de un reembolso sin tarjeta.
Para hacer una operación sin tarjeta debes enviar el campo omit_card con el valor true en el request. Los campos obligatorios para una operación sin tarjeta son los siguientes:

PROPIEDAD	TIPO	Valores permitidos
`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`

NOTA: Las operaciones sin tarjeta están actualmente en fase Beta en Perú para tarjetas de crédito y débito Visa y Mastercard.

Ejemplo de una operación sin tarjeta

Para hacer una operación sin tarjeta, se envía el campo omit_card con el valor true y se omiten los demás campos no obligatorios:

Captura

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

Anulación

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

Reverso

{
    "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 '/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)

Estructura de la anulación

Hacer reversos

Estructura del reverso

Cardless operations

Ejemplo de una operación sin tarjeta

Captura

Anulación

Reverso

Request

Responses

Anular y reversar

Make cancellations (voids)#

Estructura de la anulación#

Hacer reversos#

Estructura del reverso#

Cardless operations#

Ejemplo de una operación sin tarjeta#

Captura#

Anulación#

Reverso#

Request

Responses

Make cancellations (voids)

Estructura de la anulación

Hacer reversos

Estructura del reverso

Cardless operations

Ejemplo de una operación sin tarjeta

Captura

Anulación

Reverso