Informar transacción para liquidar

POST

/bindentidad-pagoexterno-v2/v2/api/v1.201/ConfirmarPagoDevolucionPrivadoLiquidador

Informa una transacción, para que este procese esta notificación, persista la transacción y posteriormente realice la liquidación al comercio.
Sólo deben informarse pagos que tengan un estado aprobado definitivo.

Request

operacion object — REQUERIDO
Objeto que agrupa todos los atributos principales y métricas de control de la transacción efectuada.

operacion.idMensaje string — REQUERIDO
Identificador de la notificación.

operacion.identificadorProcesador string — REQUERIDO
Código de referencia o ID interno provisto por el procesador de pagos externo (ej: Coelsa, Payway, Global Processing) que sirve para la conciliación con las redes transaccionales.

operacion.identificadorTransaccion string — REQUERIDO
Identificador de la transacción dentro del sistema centralizador de cobros de Bind PSP. Corresponde al ID de la orden obtenido originalmente en el flujo de verificación.

operacion.identificadorOrdenVenta string — OPCIONAL
Identificador específico de la intención o la orden de cobro interoperable. En canales QR equivale al valor de la orden centralizada.

operacion.identificadorReferencia string — OPCIONAL
Código alfanumérico indicado por la entidad para correlacionar y asociar el movimiento con sus sistemas contables internos.

operacion.tipoTransaccion string — REQUERIDO
Clasificación del canal o el flujo por el cual se procesa el cobro en el ecosistema. Valor fijo: "Liquidador"

operacion.rubroMovimiento string — REQUERIDO
Categoría operativa interna del sistema de cuentas. Valor fijo: "PAGO"

operacion.rubroTransaccion string — REQUERIDO
Indicador del módulo de liquidación o lógica transaccional aplicada a la operación. Valor fijo: "Liquidador"

operacion.procesadorPago string — REQUERIDO
Denominación o nombre comercial de la entidad o gateway externa encargada de procesar el pago. Valor fijo: "DECIDIR"

operacion.formaPago string — REQUERIDO
Medio de pago o instrumento financiero con el que el cliente pagador canceló la operación. Valores posibles: "TTCC" (Tarjeta de Crédito), "TTDD" (Tarjeta de Débito), "TTPP" (Tarjeta prepaga)

operacion.fechaNegocio string — REQUERIDO
Fecha y hora en la que tuvo lugar la cobranza o transacción en tiempo real (Formato ISO-8601 expresada en zona horaria local UTC-3).

operacion.fechaProceso string — REQUERIDO
Fecha legal de rendición contable y clearing en la plataforma, calculada según los días hábiles del sistema financiero (Formato ISO-8601 expresada en zona horaria local UTC-3).

operacion.moneda string — REQUERIDO
Código estandarizado de la divisa en la que se expresa y procesa el cobro de la transacción. Valor fijo: "ARS" (Pesos Argentinos)

operacion.importeBruto double — REQUERIDO
Monto total abonado por el comprador final antes de la aplicación de aranceles, comisiones del comercio o retenciones impositivas.

operacion.estadoTransaccion string — REQUERIDO
Estado final y definitivo del procesamiento de la transacción en el sistema centralizador. Valores posibles: "ACREDITADO", "RECHAZADA", "DEVUELTA"

vendedor object — REQUERIDO
Objeto que contiene los datos identificatorios, fiscales y de destino de fondos del comercio o establecimiento receptor del pago.

vendedor.cuentaVendedor string — REQUERIDO
CBU / CVU correspondiente a la cuenta de la entidad o comercio donde se acreditan los fondos liquidados.

vendedor.identificadorVendedor string — REQUERIDO
Identificación fiscal (CUIT) sin guiones de la persona física o jurídica dueña del comercio que recibe el cobro.

vendedor.codigoCaja string — REQUERIDO
Identificador unívoco del punto de venta o caja física/virtual registrada en la sucursal del comercio donde se imputó el cobro.

vendedor.informacionesAdicionales array — REQUERIDO
Colección de objetos estructurados en formato llave-valor para complementar la información de rubro o negocio del vendedor.

vendedor.informacionesAdicionales[].key string — REQUERIDO
Nombre del atributo complementario del vendedor. Valores posibles: "MCC"

vendedor.informacionesAdicionales[].value string — REQUERIDO
Valor asociado a la clave del vendedor.
Si key es "MCC", es el tal como el código de actividad económica de Visa (Merchant Category Code).

comprador object — REQUERIDO
Objeto que agrupa los atributos de identidad y de cuenta pertenecientes al cliente que origina el pago.

comprador.identificadorPagador string — REQUERIDO
Número de identificación del pagador. Puede corresponder al número de DNI o CUIT/CUIL sin guiones según el canal de pago utilizado.

comprador.cuentaPagador string — REQUERIDO
Referencia de la cuenta origen de los fondos. Puede reflejar los últimos 4 dígitos del PAN de la tarjeta o el CVU/CBU completo de la billetera origen.

informacionesAdicionales array — REQUERIDO
Listado de metadatos globales estructurados en tuplas llave-valor para añadir variables de control de red o ecosistema a la transacción.

informacionesAdicionales[].key string — REQUERIDO
Nombre de la variable de entorno o negocio. Valores posibles: "ID_BILLETERA"

informacionesAdicionales[].value string — REQUERIDO
Valor o contenido alfanumérico de la variable. Si key es "MCC", poner valor fijo "".

curl request

Copy code

curl -X POST 'https://gw-staging-qrbind.epays.services/bindentidad-pagoexterno-v2/v2/api/v1.201/ConfirmarPagoDevolucionPrivadoLiquidador' \
  -H "Authorization: Bearer {{access_token}}" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "operacion": {
      "idMensaje": "abcdefg1234",
      "identificadorProcesador": "31241232132",
      "identificadorTransaccion": "346",
      "identificadorOrdenVenta": "1234qWNJP",
      "identificadorReferencia": "1234qWNJP",
      "tipoTransaccion": "Liquidador",
      "rubroMovimiento": "PAGO",
      "rubroTransaccion": "Liquidador",
      "procesadorPago": "DECIDIR",
      "formaPago": "TTCC",
      "fechaNegocio": "2026-03-02T03:00:00.000000Z",
      "fechaProceso": "2026-03-02T20:09:33.674701Z",
      "moneda": "ARS",
      "importeBruto": 1012.56,
      "estadoTransaccion": "ACREDITADO"
    },
    "vendedor": {
      "cuentaVendedor": "3220064920000000327022",
      "identificadorVendedor": "30717449076",
      "codigoCaja": "B00010515123",
      "informacionesAdicionales": [
        {
          "key": "MCC",
          "value": "6300"
        }
      ]
    },
    "comprador": {
      "identificadorPagador": "92987309",
      "cuentaPagador": "4410"
    },
    "informacionesAdicionales": [
      {
        "key": "ID_BILLETERA",
        "value": " "
      }
    ]
  }'

Response

liquidador_id_trx string
Identificador de la transacción creada en Bind Psp. Con este id luego podrá consultar sobre esta transacción.

id_procesador string
Identificador del procesador informado por la Entidad

id_billetera int
Valor fijo= 0

fecha_negocio string
Fecha en que se realizó la transacción (UTC - 3)

payment_reference string
Identificador de intención de pago interno para seguimiento en el sistema. No será utilizado por la Entidad

codigo_postal string
Código postal del comercio.

mcc string
Rubro del comercio según el MCC de VISA.

status string
Estado final del procesamiento de la notificación del pago por parte de Bind Pagos.
Valores permitidos:
OK = “PASS”
ERROR = “FAIL”

on_error int
Código de error, si corresponde.

HTTP 200

Creación exitosa

HTTP 401

Token de autenticación inválido

Guías

API Reference

POST

Informar transacción para liquidar