Crear devolución QR

POST

/bindentidad-workflow-v2/v2/api/v1.201/contracargo-qr-v31

Instruye una devolución de un pago realizado con QR.

Para utilizar este método, la transacción debe encontrarse en estado ACREDITADO y el medio de pago debe ser "Transferencia30" (QR interoperable).

Pueden realizarse dos tipos de devoluciones:

Devolución total: Devolución del monto total de la compra.
Devolución parcial: Pueden realizarse infinitas devoluciones de montos parciales hasta completar el monto total de la compra, siempre y cuando se realicen dentro del plazo de 30 días desde que se ejecutó la compra.

Considerar que en todos los casos las devoluciones sólo se inician en el comercio. Por lo tanto, un cliente desde su billetera NO puede iniciar un contracargo en este medio de pago.

Request

qrIdTrx string
— REQUIRED
Es el identificadorOrdenVenta de la transacción. Esta información se encuentra dentro de la notificación de pago (Ver Webhook: Notificación de pago o Consultar notificaciones de pago).

codigoComercio string
— REQUIRED
Es el código identificador del comercio.

parcial boolean
— REQUIRED
Indica si se trata de una devolución parcial o total.
Valores permitidos: true (Devolución parcial), false (Devolución total)

importe double
— REQUIRED
Es el importe total a devolver. Debe ingresarse el importe bruto sin descuentos.

motivo string
— REQUIRED
Descripción del motivo de devolución. Longitud máxima = 100 caracteres.

usuario string
— OPTIONAL
Usuario que realizó la devolución.

curl request

Copy code

curl -v -X POST "https://gw-staging-qrbind.epays.services/bindentidad-workflow-v2/v2/api/v1.201/contracargo-qr-v31" -H "Content-Type: application/json-patch+json" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6IlQxU3QtZExUdnlXUmd4Ql82NzZ1OGtyWFMtSSJ9.eyJhdWQiOiJiNmQ1OTEyYi00ZTM0LTRmYjItOWYzMS0yNzEzZTEwYWY3NDUiLCJpc3MiOiJodHRwczovL2xvZ2luLm1pY3Jvc29mdG9ubGluZS5jb20vNjFlZjViODktOGRmMy00OTlkLThjMTMtMzhmZWQ1ZDA5YzcyL3YyLjAiLCJpYXQiOjE3MDExMTEzMTksIm5iZiI6MTcwMTExMTMxOSwiZXhwIjoxNzAxMTE1MjE5LCJhaW8iOiJFMlZnWUhoYnkySE1ZYlhQejRublFlRDNSOXQvL3RUMFc2KzhWYWp5NDJWWEFRNW42MlFBIiwiYXpwIjoiMWVlZDNmMWQtZjY1Ny00NmI0LTg3MzYtYTcyYjFiNWUxYjc1IiwiYXpwYWNyIjoiMSIsIm9pZCI6IjEyMGJkMTQzLTY2YmYtNDU5Mi1hM2NlLWI3ZDA1MmUzYTlkNiIsInJoIjoiMC5BWDBBaVZ2dllmT05uVW1NRXpqLTFkQ2NjaXVSMWJZMFRySlBuekVuRS1FSzkwV2FBQUEuIiwicm9sZXMiOlsiR3JvdXAuRW50aXRpZXMiLCJYLUNsaWVudE5hbWUuUUEtMDUiLCJYLUVudGlkYWQuWiJdLCJzdWIiOiIxMjBiZDE0My02NmJmLTQ1OTItYTNjZS1iN2QwNTJlM2E5ZDYiLCJ0aWQiOiI2MWVmNWI4OS04ZGYzLTQ5OWQtOGMxMy0zOGZlZDVkMDljNzIiLCJ1dGkiOiJDd0h0Z2FqWmpFNlkwQ0F6ejBZTkFBIiwidmVyIjoiMi4wIn0.I5QzKpTejEzYUjnuN_oZmy4XA6xQTSPP-eg09dEJfB_idwf_J48M7EX2w4Nzz0x2eY0XcE7-SVeHwHkZKam-pdiPpcpTT7cHBBmLHcf3IZztGUnq86RO-duxIRQKgLBz7g419Fpl2yyHSbQBSqOxio8CD38prE78GW0RIEbw8rk7uZFg0paHDildvUfluFOKZ_zIRHERfdaSXYhRYzI4F3KzPahNKtrwpxRPYi9smR8rG2Zmwu0mRoKQm7e3clbZTBD7Nwb85SmqZ92kcxQ4LuICKw75Q4SH__orwyoGy9DGGnqqkSdlrrzXeapOuasx1ksGGn1nNQc7nIo4hQpOKw" --data-raw "{
    \"qrIdTrx\": \"ZOC124E78E0F2097B000004550920000000545500000010000446C10E6A4\",
    \"codigoComercio\": \"C07663\",
    \"parcial\": false,
    \"importe\": 100,
    \"motivo\": \"error en cobro\",
}"

Response

id int
Id de la orden de venta creada.

estado string
Estado de la devolución.
Valores permitidos: "PENDIENTE" (La devolución aún se encuentra en proceso. Estado no definitivo), "PROCESADOENBIND" (Se ha descontado el dinero al comercio pero aún no se ha completado la devolución al cliente pagador. Estado no definitivo), "ACEPTADO" (La devolución se completó con éxito. Estado definitivo), "RECHAZADO" (La devolución tuvo un error. Estado definitivo)

HTTP 200

Creación exitosa

HTTP 202

Identificador orden inválido

HTTP 400

Falta algún campo requerido

HTTP 401

Token de autenticación inválido

Guías

¿Cómo cobrar con QR asociado a una deuda única?

API Reference

POST

Crear una deuda

GET

Consultar una deuda

DEL

Eliminar una deuda

POST

Crear devolución QR

GET

Consultar devolución

EVENT

Aviso de transacción QR deuda

EVENT

Aviso de devolución QR dinámico