Anular y reversar

El servicio de anulación está disponible en México 🇲🇽.

Con este endpoint puedes:

Hacer anulaciones

Hacer transacciones de reverso

Hacer operaciones sin tarjeta

Hacer anulaciones (voids)

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

Para anulaciones parciales, es necesario enviar el objeto amount.

⛔️ Importante: los reembolsos y las anulaciones parciales no están disponibles en México 🇲🇽.

Estructura

Para anular una transacción envía Void en el campo transaction_mode y el transaction_reference de la transacción que quieres cancelar como parte del cuerpo de tu request. (Revisa el ejemplo completo en el costado derecho de la pantalla).

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

Si la anulación se hace después del tiempo límite permitido, el request se procesará 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 22:59 (hora aproximada). Ten en cuenta que debes esperar al menos 1 minuto después de la transacción antes de iniciar un reverso.

Estructura

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

Operaciones sin tarjeta

Puedes hacer una reautorización, una captura, un reverso o una anulación sin necesidad de leer la tarjeta. A continuación encontrarás cómo llevar a cabo 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 es necesario 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`
`is_smart_void` (opcional)	`Boolean`	`true` `false`

NOTA: Las operaciones sin tarjeta están disponibles para tarjetas de crédito y débito Visa y Mastercard en Chile y en México internacional. En México local también están disponibles, procesadas a través de PROSA. Actualmente están en fase Beta en México y Perú.

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:

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

Hacer anulaciones (voids)

Estructura

Hacer reversos

Estructura

Operaciones sin tarjeta

Ejemplo de una operación sin tarjeta

Request

Responses

Anular y reversar

Hacer anulaciones (voids)#

Estructura#

Hacer reversos#

Estructura#

Operaciones sin tarjeta#

Ejemplo de una operación sin tarjeta#

Request

Responses

Hacer anulaciones (voids)

Estructura

Hacer reversos

Estructura

Operaciones sin tarjeta

Ejemplo de una operación sin tarjeta