Informar transacción para liquidar

Productos en los que aplica:

Descripción

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.

Endpoint

POST

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

Request

idMensaje string
OPTIONAL
Identificador de la notificación de pago interno de la Entidad.

identificadorProcesador string
REQUIRED
Identificador de la transacción indicado por el procesador de pagos.

identificadorReferencia string
REQUIRED
Identificador de referencia interno de la Entidad.
Este identificador la usaría para relacionar e identificar la transacción en el sistema de Bind Psp.

tipoTransaccion string
REQUIRED
Número de DNI.
Indica el tipo de transacción para el sistema.
Valor fijo: “Liquidador”

rubroMovimiento string
OPTIONAL
Indica el tipo de movimiento para el sistema.
Valor fijo: “PAGO”

formaPago string
REQUIRED
Medio de pago por el que se procesó el pago.
Valores permitidos:
Tarjeta de débito = “TTDD”
Tarjeta de crédito = “TTCC”

fechaNegocio string
REQUIRED
Fecha en que se realizó la transacción (UTC 0)

fechaProceso string
REQUIRED
Fecha en que se procesó la transacción (UTC 0).

moneda string
REQUIRED
Moneda de la transacción.
Valores permitidos:
Pesos argentinos = “ARS”

importeBruto double
REQUIRED
Importe bruto de la transacción.

estadoTransaccion string
REQUIRED
Estado de la transacción.
Valores permitidos:
Transacción exitosa = “ACREDITADO”
Transacción rechazada = “RECHAZADA”
Transacción devuelta = “DEVUELTA”

rubroTransaccion boolean
REQUIRED
Indica el rubro de la transacción para el sistema.
Valor fijo: “Liquidador”

procesadorPago string
REQUIRED
Denominación del procesador de pago.
Valores permitidos:
Decidir = “DECIDIR”

marca string
OPTIONAL
Tipo de tarjeta con que se realizó el pago.
Valores permitidos:
Visa = “VISA”
Mastercard = “MASTERCARD”
Maestro = “MAESTRO”
Cabal = “CABAL”

cuotas int
OPTIONAL
Cantidad de cuotas con que se procesó el pago

motivo string
REQUIRED
Descripción de motivo de devolución o rechazo.

cuentaVendedor string
OPTIONAL
CBU o CVU del comercio.

identificadorVendedor string
OPTIONAL
CUIT del comercio.

vendedor.informacionesAdicionales.key string
REQUIRED
Indica el tipo de movimiento para el sistema.
Valor fijo: “mcc”

vendedor.informacionesAdicionales.value string
REQUIRED
Rubro del comercio según MCC de VISA. (Puede ir vacío)

codigoCaja string
REQUIRED
Código de caja del comercio creada en Bind Psp.

identificadorPagador string
OPTIONAL
DNI del cliente pagador.

cuentaPagador string
REQUIRED
Últimos 4 dígitos del PAN de la tarjeta.

comprador.informacionesAdicionales.key string
REQUIRED
Indica el tipo de movimiento para el sistema.
Valor fijo: “dni”

comprador.informacionesAdicionales.value string
REQUIRED
Número de documento del cliente pagador. (Puede ir vacío)

Ejemplo de request

Copy code

curl --location 'https://gw-staging-qrbind.epays.services/ot-clone/api/v1/onboarding' \
--header 'Cache-Control: no-cache' \
--header 'Content-Type: application/json' \
--header 'Ocp-Apim-Subscription-Key: 123455f9d2544347b07dfb37be925c3e' \
--data-raw '{ 
  "entidadId": "12345678-2881-48ff-97a5-23adbe21a650",
  "externalrefid": "789654",
  "frente": "fotoEnBase64DelFrenteDelDni",
  "dorso": "fotoEnBase64DelDorsoDelDni",
  "documento": null,
  "documentoTramite": null,
  "genero": null,
  "selfie": "fotoEnBase64SelfieDelUsuario",
  "email": "pablogomes1234@gmail.com",
  "telefono": "1112341243",
  "maritalState": "SOLTERO",
  "occupation": "TRABAJADOR EN RELACIÓN DE DEPENDENCIA",
  "isOcde": false,
  "OcdeTimeStamp": "2024-10-23 10:10:48",
  "isFatca": false,
  "FatcaTimeStamp": "2024-10-23 10:10:48",
  "isPep": false,
  "PepTimeStamp": "2024-10-23 10:10:48",
  "isUIF": false,
  "UifTimeStamp": "2024-10-23 10:10:48",
  "isTyc": true,
  "tycTimeStamp": "2024-10-23 10:10:48"
}'

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.

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 401

Token de autenticación inválido

Copy code

HTTP 401

Token de autenticación inválido

Copy code

HTTP 401

Token de autenticación inválido

Copy code

HTTP 422

Onboarding rechazado porque no se extraer información del código PDF417 del DNI. Puede reintentarse enviando adicionalmente los datos del DNI ingresados manualmente por el usuario para poder continuar.

Copy code

HTTP 422

Onboarding rechazado porque no se extraer información del código PDF417 del DNI. Puede reintentarse enviando adicionalmente los datos del DNI ingresados manualmente por el usuario para poder continuar.

Copy code

HTTP 422

Onboarding rechazado porque no se extraer información del código PDF417 del DNI. Puede reintentarse enviando adicionalmente los datos del DNI ingresados manualmente por el usuario para poder continuar.

Copy code

HTTP 422

Onboarding rechazado porque ya existe una solicitud aprobada de la persona.

Copy code

HTTP 422

Onboarding rechazado porque ya existe una solicitud aprobada de la persona.

Copy code

HTTP 422

Onboarding rechazado porque ya existe una solicitud aprobada de la persona.

Copy code

HTTP 422

Onboarding rechazado porqueRenaper no reconoce el documento

Copy code

HTTP 422

Onboarding rechazado porqueRenaper no reconoce el documento

Copy code

HTTP 422

Onboarding rechazado porqueRenaper no reconoce el documento

Copy code

HTTP 422

Onboarding rechazado porque el DNI ingresado corresponde con una persona fallecida en Renaper

Copy code

HTTP 422

Onboarding rechazado porque el DNI ingresado corresponde con una persona fallecida en Renaper

Copy code

HTTP 422

Onboarding rechazado porque el DNI ingresado corresponde con una persona fallecida en Renaper

Copy code

HTTP 422

Onboarding rechazado porque el ejemplar del DNI ingresado no está vigente para Renaper

Copy code

HTTP 422

Onboarding rechazado porque el ejemplar del DNI ingresado no está vigente para Renaper

Copy code

HTTP 422

Onboarding rechazado porque el ejemplar del DNI ingresado no está vigente para Renaper

Copy code

HTTP 422

Onboarding rechazado porque el usuario tiene una edad menor a la permitida

Copy code

HTTP 422

Onboarding rechazado porque el usuario tiene una edad menor a la permitida

Copy code

HTTP 422

Onboarding rechazado porque el usuario tiene una edad menor a la permitida

Copy code

HTTP 401

Token de autenticación inválido

Copy code

HTTP 401

Token de autenticación inválido

Copy code

HTTP 401

Token de autenticación inválido

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