Crear devolución QR

Productos en los que aplica:

QR INTEROPERABLE

Descripción

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).

La devolución se crea en estado PENDIENTE. Luego, se procesará y terminará en estado ACEPTADO o RECHAZADO. Es decir, que luego de crear la devolución con este método, hay que esperar el Webhook: Notificación de devolución o Consultar notificaciones de devoluciones pendientes para conocer su estado definitivo.

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.

Endpoint

POST

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

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.

Ejemplo de 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.

Ejemplo de response

HTTP 200

Creación exitosa

Copy code

HTTP 200

Creación exitosa

Copy code

HTTP 200

Creación exitosa

Copy code

HTTP 202

Identificador orden inválido

Copy code

HTTP 202

Identificador orden inválido

Copy code

HTTP 202

Identificador orden inválido

Copy code

HTTP 400

Falta algún campo requerido

Copy code

HTTP 400

Falta algún campo requerido

Copy code

HTTP 400

Falta algún campo requerido

Copy code

Descripción

Endpoint

Request

Ejemplo de request

Response

Ejemplo de response

DEVELOPERS

Listado de API disponibles para

QR INTEROPERABLE

REC. X TRANSFERENCIA

BOTÓN SIMPLE

DISPOSITIVO POS

WALLET / PSP

ONBOARDING

LIQUIDADOR

Autenticación

Cobrar con QR estático

Cobrar con QR dinámico

Cobrar con botón de pagos

Cobrar con transferencia

Comercio

Comprobantes

Operaciones

Webhooks

Archivos batch

DEVELOPERS

API reference

Ir a productos