Anular y reversar

🔐 Producto en versión beta

Con este endpoint puedes:

Realizar anulaciones

Realizar reversos de transacciones

Operaciones sin tarjeta

Realizar anulaciones (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 en diferido es exitoso.

Para anulaciones parciales, debes enviar el objeto amount.

Estructura

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 solicitud. (Revisa el ejemplo completo en la parte derecha de la pantalla).

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

Si realizas una anulación después del límite de tiempo permitido, la solicitud se procesa como un reembolso.

Realizar reversos

Si hay problemas de comunicación y no tienes certeza de si una transacción fue aprobada o rechazada, puedes realizar un reverso para anular la transacción.

Los reversos solo están disponibles el mismo día en que se realizó la transacción, antes de las 23:59. 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 a reversar como parte del body de tu solicitud. (Revisa el ejemplo completo en la parte derecha de la pantalla).

Operaciones sin tarjeta

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

NOTA: También puedes revisar la información de un reembolso sin tarjeta.

Para realizar una operación sin tarjeta debes enviar el campo omit_card con el valor true en la solicitud. Los campos requeridos 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`

Ejemplo de una operación sin tarjeta

Para realizar una operación sin tarjeta, envía el campo omit_card con el valor true y omite los demás campos no requeridos:

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

Realizar anulaciones (voids)

Estructura

Realizar reversos

Estructura

Operaciones sin tarjeta

Ejemplo de una operación sin tarjeta

Request

Responses

Anular y reversar

Realizar anulaciones (voids)#

Estructura#

Realizar reversos#

Estructura#

Operaciones sin tarjeta#

Ejemplo de una operación sin tarjeta#

Request

Responses

Realizar anulaciones (voids)

Estructura

Realizar reversos

Estructura

Operaciones sin tarjeta

Ejemplo de una operación sin tarjeta