Consultar devoluciones

Descripción

Devuelve todas las notificaciones de devoluciones pendientes de consultar, según los filtros determinados. Cada notificación de devolución comprende la misma información que se envía por el Webhook: Devolución.

Este método sirve para conciliar las devoluciones. Sólo devuelve notificaciones pendientes de transacciones que ocurrieron en el último día en curso, y que estén en estado PENDIENTE. Al consultar y recuperar una notificación, esta pasa a estado ENTREGADO y no puede volver a consultarse por este método.

Si no se ha consultado por este método, la notificación estará disponible para ser consultada.

Endpoint

PATCH

{{baseURL}}/bindentidad-notificacion-v2/v2/api/v1.201/notificaciones-contracargos?TipoDestino={TipoDestino}&KeyDestino={KeyDestino}[&IdentificadorOrdenVenta][&IdentificadorTransaccion][&IdentificadorProcesador][&CodigoComercio][&CodigoCaja][&IdOrdenVentaQr][&IdentificadorReferencia]

Request

Path parameters

TipoDestino string
REQUIRED
Es el id del país del que se quiere consultar las provincias.
Valores permitidos:
ENTIDAD = Si se desea buscar notificaciones en toda la entidad.
COMERCIO = Si se desea buscar notificaciones en un solo comercio.
CAJA = Si se desea buscar notificaciones en una sola caja.

KeyDestino string
REQUIRED
Es el id de la entidad o el id de la caja, dependiendo qué se esté enviando en TipoDestino.

Path parameters

IdentificadorTransaccion string
OPCIONAL
Es el id de la transacción en el sistema de Bind PSP. Se crea al momento de insertar una transacción con un estado definitivo.

IdentificadorProcesador string
OPCIONAL
Es el id del procesador. La fuende dependerá de quién sea el Procesador del canal y medio de pago.

IdentificadorOrdenVenta string
OPCIONAL
Es un identificador específico de la intención de cobro de cada canal de pago.
Por ejemplo:
Para QR interoperable = Es el order id indicado a Coelsa.
Para Botón Simple = Es el paymentId, el identificador del link de pago creado.
Para Transfer = Es el CVU en el que se acreditó el pago.

IdOrdenVentaQr string
OPCIONAL
Es el id de la orden de venta creada, asociada a la transacción. Puede ser el devuelto al momento de Crear orden de venta o de Crear deuda.

IdentificadorReferencia string
OPCIONAL
Es un identificador de referencia de cada canal de pago.

CodigoComercio string
OPCIONAL
Es el identificador del comercio.

CodigoSucursal string
OPCIONAL
Es el identificador de la sucursal.

CodigoCaja string
OPCIONAL
Es el identificador de la caja.


Ejemplo de request

Copy code

curl -v -X PATCH "https://gw-staging-qrbind.epays.services/bindentidad-notificacion-v2/v2/api/v1.201/notificaciones-contracargos?TipoDestino=CAJA&KeyDestino=B07934" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6IlQxU3QtZExUdnlXUmd4Ql82NzZ1OGtyWFMtSSJ9.eyJhdWQiOiJiNmQ1OTEyYi00ZTM0LTRmYjItOWYzMS0yNzEzZTEwYWY3NDUiLCJpc3MiOiJodHRwczovL2xvZ2luLm1pY3Jvc29mdG9ubGluZS5jb20vNjFlZjViODktOGRmMy00OTlkLThjMTMtMzhmZWQ1ZDA5YzcyL3YyLjAiLCJpYXQiOjE3MDI2NTMxOTUsIm5iZiI6MTcwMjY1MzE5NSwiZXhwIjoxNzAyNjU3MDk1LCJhaW8iOiJFMlZnWUpnZ2RsOXpoV25FRkZjcDUxOW5aaVZjWGVrYzRIK3NsRGZQZjVkeC9wRnpldTBBIiwiYXpwIjoiMWVlZDNmMWQtZjY1Ny00NmI0LTg3MzYtYTcyYjFiNWUxYjc1IiwiYXpwYWNyIjoiMSIsIm9pZCI6IjEyMGJkMTQzLTY2YmYtNDU5Mi1hM2NlLWI3ZDA1MmUzYTlkNiIsInJoIjoiMC5BWDBBaVZ2dllmT05uVW1NRXpqLTFkQ2NjaXVSMWJZMFRySlBuekVuRS1FSzkwV2FBQUEuIiwicm9sZXMiOlsiR3JvdXAuRW50aXRpZXMiLCJYLUNsaWVudE5hbWUuUUEtMDUiLCJYLUVudGlkYWQuWiJdLCJzdWIiOiIxMjBiZDE0My02NmJmLTQ1OTItYTNjZS1iN2QwNTJlM2E5ZDYiLCJ0aWQiOiI2MWVmNWI4OS04ZGYzLTQ5OWQtOGMxMy0zOGZlZDVkMDljNzIiLCJ1dGkiOiJuamVXU3JFWl8wRzY5bVk4ZnJBYUFBIiwidmVyIjoiMi4wIn0.k24XYsokudfoxDJHNNCYSejszR9gSVVjNMNsUdtSOwc0raNmW1IsCjOU5FBaxeFGKV2obPj9ZX_s4uj0vSerzsJFYynxo23temNmyK9y4tgugp7wL04n1NyQXjfzdABuN11LOYUfUnBUKUDR5dZ21MRcsA24eSlgx0cvI51hvNbq5Mdw47VNgiXT1n6YXizCf1YkO-8X6W79tWGTnzFdlDC2xDLkEZrXRGVEYLibgsJ9xBw2lrbTdVaw2YywtZISO3SRnGZeC8cP4_TTu8Gdt6E6x7os9XaDeDalRb5dBxW_NmjH29Um3c2ejdIj5V0CF7B8jpyN2ddWi7JSaH97vw"

Response

When datetime
Fecha y hora en que fue enviada la notificación (UTC + 0).

Payload {} object
Objeto con información de la notificación.

TipoEvento string
Valor fijo:
"DEVOLUCIÓN"

IdentificadorOrigen string
Código unívoco de la Entidad a la que pertenece el comercio.

TipoDestino string
Valor fijo:
"ENTIDAD"

IdentificadorDestino string
Código unívoco de la Entidad a la que pertenece el comercio.

DestinoPrincipal string
Es la URL del destino principal en donde se envía el webhook de notificación.

DestinoSecundario string
Es la URL del destino secundario en donde se envía el webhook de notificación.

FechaEmision datetime
Fecha y hora en que se envió la notificación (UTC + 0).

IdMensaje string
Id guid de la notificación.

MensajePago {} object
Objeto con la información del pago.

IdentificadorProcesador string
Id del pago enviado por el procesador del pago (Coelsa, Global Processing, Decidir, etc). Es el identificador que utilizamos para conciliar con nuestros procesadores.

IdentificadorTransaccion string
Id de la transacción. Es el identificador único de la transacción para Bind PSP.

IdentificadorOrdenVenta string
Es un identificador adicional de interés para cada canal de pago.
Para TipoTransaccion = Transferencia30 es el order id de la API Resolve en Coelsa.
Para TipoTransaccion = Botón simple es el PaymentId, es decir, el id del link de pago.
Para TipoTransaccion = CVUCollect es el CVU en el que se recibió el pago.
Para TipoTransaccion = MPOS es el

IdentificadorReferencia string
Es un identificador adicional de referencia para cada canal de pago.

IdOrdenVentaQr string
Es el identificador de la orden de venta de QR.

TipoTransaccion string
Identifica al canal por el cuál se realizó el pago.
Valores permitidos:
Transferencia30 = QR
BotonSimple = Botón de pagos de cobro no presente
CVUCollect = Recaudación por transferencia a CVU
MPOS = Smartpos de cobro presente

RubroMovimiento string
Rubro interno de la transacción.

FechaNegocio datetime
Fecha y hora en que el cliente realizó el pago (UTC - 3).

FechaProceso datetime
Fecha y hora en que se procesó el cobro (UTC - 3).

FormaPago string
Medio de pago con que se realizó el pago.
Valores permitidos:
"Transf30" = QR interoperable
"TTDD" = Tarjeta de débito
"TTCC" = Tarjeta de crédito
"Transfer" = Recaudación por transferencia a CVU

Moneda string
Es el código de la caja en la cual se quiere crear la orden de venta.
Valor fijo:
"ARS" = Pesos argentinos

ImporteBruto decimal
Importe bruto total de la transacción. Es lo que pagó el cliente final.

EstadoTransaccion string
Estado de la transacción.
Valores permitidos:
"DEVUELTA" = Pago devuelto (estado definitivo).

Retenciones [] object
Objeto vacío.

Mcc string
Código de rubro según VISA MCC del comercio.

Cpa string
Código postal argentino del comercio.

Cuit string
CUIT del comercio.

CuentaVendedor string
CVU del comercio.

IdentificadorVendedor string
Información relativa al comercio. Concatena el CVU, el CBU y el ID Wallet (aplica para pagos con QR).

IdentificadorPagador string
CUIT del cliente pagador.

CuentaPagador string
CBU/CVU del cliente pagador.

CodigoComercio string
Código identificador del comercio en el sistema.

CodigoSucursal string
Código identificador de la sucursal en el sistema.

CodigoCaja string
Código identificador de la caja en el sistema.

InformacionAdicionalPagador [] object
Objeto con tuplas llave-valor con información adicional referente al cliente pagador.

Entidad string
Es un código unívoco de la Entidad en el sistema.

Psp string
Es el código del PSP al que pertenece la Entidad.

Procesador string
Id del pago enviado por el procesador del pago (Coelsa, Global Processing, Decidir, etc). Es el identificador que utilizamos para conciliar con nuestros procesadores.

InformacionAdicionalMensaje [] object
Objeto con tuplas llave-valor con información adicional referente a la notificación.

Ejemplo de response

HTTP 200

Consulta exitosa

Copy code

HTTP 200

Consulta exitosa

Copy code

HTTP 200

Consulta exitosa

Copy code

HTTP 204

No hay notificaciones pendientes

Copy code

HTTP 204

No hay notificaciones pendientes

Copy code

HTTP 204

No hay notificaciones pendientes

Copy code

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 dinámico

DEVELOPERS

DEVELOPERS

DEVELOPERS