Notificaciones Webhook
El webhook de notificación es una llamada HTTP (POST) a una url configurada previamente en Totalcoin (el cliente debe proporcionar dicha url por medio de un canal seguro). La misma se envia al cliente cuando se recibe un pago por medio de alguno de los canales de pago soportados por Totalcoin (y configurados para el cliente), como ser: Transferencia bancaria (cvu,cbu), Pago QR o Pago con Tarjeta Debito o Credito.
Este documento describe el payload del webhook y los campos del mismo. Quedando en otros documentos la explicacion de como se realiza la conciliacion de los pagos.
Payload del Webhook
El payload del webhook que recibira el cliente en su endpoint configurado es el siguiente:
{
"Concepto": "1234567890",
"Referencia": "0000004053",
"Monto": 1000,
"MontoNeto": 937.2,
"Tarifas": 51.9,
"Impuestos": 10.9,
"FechaCreacion": "11/19/2020 16:40:20",
"FechaConfirmacion": "11/19/2020 16:40:23",
"FechaAcreditacion": "04/21/2021 14:34:53",
"Estado": "APROBADO",
"MetodoPago": "TARJETA",
"Operacion": "COBRANZA TARJETA",
"NombreCompletoEmisor": "TOTAL COIN",
"EmailEmisor":"@totalcoin.com",
"NombreCompletoReceptor": "TOTAL COIN",
"EmailReceptor": "@totalcoin.com",
"CuilCuitEmisor": "11111111",
"CuilCuitReceptor": "11111111",
"BarCode": null,
"CbuOrigen": "",
"CvuOrigen": null,
"Tarjeta": "VISA",
"Cuotas": "02",
"ReferenciaMerchant": null
}
Explicacion de los campos de este body (los campos mas relevantes estan en negrita):
| Campo | Descripción |
|---|---|
| Concepto | En algunas integraciones como por ejemplo Checkout (Campo ER) el cliente puede poner una referencia, esa referencia sera notificada en este campo concepto. |
| Referencia | Este campo posee el ID unico de referencia de la transaccion en Totalcoin. |
| Monto | Monto de la Operacion. |
| MontoNeto | Monto resultante luego de descontar impuestos y tarifas de Totalcoin. |
| Tarifas | Tarifas de Totalcoin aplicadas a esta operacion. |
| Impuestos | Impuestos aplicados a esta operacion. |
| FechaCreacion | Fecha en que se registro la operacion en Totalcoin. |
| FechaConfirmacion | Fecha en que se confirmo efectivamente el pago. |
| FechaAcreditacion | Fecha en que se acredito o se acreditara el pago. Usada para operaciones de Pago con acreditacion diferida, por ejemplo Pago con Tarjeta de Credito. |
| Estado | Ultimo estado de la operacion: Transferencias: ACREDITADO Tarjetas: APROBADO, RECHAZADO QR: ACREDITADO |
| MetodoPago | Metodo de pago utilizado para la operacion. Transferencias: BIND Tarjetas: TARJETA QR: BIND |
| Operacion | Operacion realizada en el Metodo de Pago: Transferencias: TRANSFERENCIA ENTRANTE BIND Tarjetas: COMPRA TARJETA QR: TRANSFERENCIA ENTRANTE BIND |
| NombreCompletoEmisor | Nombre completo del originario de la transaccion: Transferencias: Nombre de la persona que realizo la transferencia Tarjetas: Nombre del titular de la tarjeta QR: Nombre del titular de la wallet usada para pagar |
| EmailEmisor | Email de la persona que realizo la transaccion si aplicase, null en caso contrario. |
| NombreCompletoReceptor | Nombre de la empresa que recibe el webhook |
| Email Receptor | Email registrado de la empresa que recibe el webhook |
| CuilCuitEmisor | CUIT de la persona que realizo la transaccion |
| CuilCuitReceptor | CUIT registrado de la empresa que recibe el webhook |
| BarCode | Codigo de barra de la operacion si aplicase, null en caso contrario. |
| CbuOrigen | CBU de la persona que realizo la transaccion, null en caso de transferencias por billeteras o QR. |
| CvuOrigen | CVU de la persona que realizo la transaccion, null en caso de transferencias Bancarias con CBU. |
| Tarjeta | Nombre de la tarjeta usada para la operacion. |
| Cuotas | Cantidad de cuotas usadas para la operacion. |
| ReferenciaMerchant | IdOperacion del merchant, este campo es utilizado para identificar si la operacion ya fue conciliada con el merchant y totalcoin. Cuando este campo tiene un valor significa que se realizo una conciliacion de la operacion entre el merchant y totalcoin. |
Configuración de Webhook: Contacte al departamento técnico para configurar los endpoints de webhook y definir la seguridad de los mismos.
A continuacion se detallan algunos ejemplos de notificaciones de webhook:
Debido a que se utiliza el mismo webhook para notificar distintos eventos, a continuacion se detallan algunos ejemplos de notificaciones de webhook
Ejemplo de notificacion de webhook para una transferencia bancaria:
{
"Concepto":"0110660830066003759998 - VAR",
"Referencia":"0050392924",
"Monto":7000.00,
"MontoNeto":6856.01,
"Tarifas":119.00,
"Impuestos":24.99,
"FechaCreacion":"05/08/2025 23:21:12",
"FechaConfirmacion":"05/08/2025 23:21:12",
"FechaAcreditacion":"05/08/2025 23:21:12",
"Estado":"ACREDITADO",
"MetodoPago":"BIND",
"Operacion":"TRANSFERENCIA ENTRANTE BIND",
"NombreCompletoEmisor":"GONZALEZ JUAN",
"EmailEmisor":null,
"NombreCompletoReceptor":"BPLAY",
"EmailReceptor":"admin@cplay.com.ar",
"CuilCuitEmisor":"27347522127",
"CuilCuitReceptor":"30709753661",
"BarCode":null,
"CbuOrigen":"",
"CvuOrigen":"0110660830066008723697",
"Tarjeta":"COELSA",
"Cuotas":"Transferencia CVU",
"ReferenciaMerchant":null
}
Ejemplo de notificacion de webhook para un pago con tarjeta de credito:
{
"Concepto":"0000068877",
"Referencia":"0050388577",
"Monto":10000.00,
"MontoNeto":9927.40,
"Tarifas":60.00,
"Impuestos":12.60,
"FechaCreacion":"05/08/2025 23:26:32",
"FechaConfirmacion":"05/08/2025 23:26:46",
"FechaAcreditacion":"05/08/2025 23:26:46",
"Estado":"ACREDITADO",
"MetodoPago":"BIND",
"Operacion":"TRANSFERENCIA ENTRANTE BIND",
"NombreCompletoEmisor":"Cesar Veizaga",
"EmailEmisor":null,
"NombreCompletoReceptor":"PLAYCETO",
"EmailReceptor":"admininfo@playceto.bet.ar",
"CuilCuitEmisor":"20261111001",
"CuilCuitReceptor":"30717666182",
"BarCode":null,
"CbuOrigen":"",
"CvuOrigen":"0000003100109123430986",
"Tarjeta":"COELSA",
"Cuotas":"QR Interoperable",
"ReferenciaMerchant":null
}
Ejemplo de notificacion de webhook para un pago con QR:
{
"Concepto":"0000065677",
"Referencia":"0050393577",
"Monto":10000.00,
"MontoNeto":9927.40,
"Tarifas":60.00,
"Impuestos":12.60,
"FechaCreacion":"05/08/2025 23:26:32",
"FechaConfirmacion":"05/08/2025 23:26:46",
"FechaAcreditacion":"05/08/2025 23:26:46",
"Estado":"ACREDITADO",
"MetodoPago":"BIND",
"Operacion":"TRANSFERENCIA ENTRANTE BIND",
"NombreCompletoEmisor":"Cesar Veizaga",
"EmailEmisor":null,
"NombreCompletoReceptor":"PLAYCETO",
"EmailReceptor":"admininfo@playceto.bet.ar",
"CuilCuitEmisor":"20261112001",
"CuilCuitReceptor":"30732432382",
"BarCode":null,
"CbuOrigen":"",
"CvuOrigen":"0000003100109132311986",
"Tarjeta":"COELSA",
"Cuotas":"QR Interoperable",
"ReferenciaMerchant":null
}