Webhook Notifications
The notification webhook is an HTTP call (POST) to a URL previously configured in Totalcoin (the client must provide this URL through a secure channel). It is sent to the client when a payment is received through any of the payment channels supported by Totalcoin (and configured for the client), such as: Bank transfer (cvu,cbu), QR Payment or Debit or Credit Card Payment.
This document describes the webhook payload and its fields. The explanation of how payment reconciliation is performed is covered in other documents.
Webhook Payload
The webhook payload that the client will receive in their configured endpoint is as follows:
{
"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
}
Explanation of the fields in this body (most relevant fields are highlighted in bold):
| Field | Description |
|---|---|
| Concepto | In some integrations such as Checkout (ER Field) the client can set a reference, that reference will be notified in this concept field. |
| Referencia | This field contains the unique reference ID of the transaction in Totalcoin. |
| Monto | Operation Amount. |
| MontoNeto | Resulting amount after deducting Totalcoin taxes and fees. |
| Tarifas | Totalcoin fees applied to this operation. |
| Impuestos | Taxes applied to this operation. |
| FechaCreacion | Date when the operation was registered in Totalcoin. |
| FechaConfirmacion | Date when the payment was effectively confirmed. |
| FechaAcreditacion | Date when the payment was or will be credited. Used for deferred credit payment operations, for example Credit Card Payment. |
| Estado | Last operation status: Transfers: ACREDITADO Cards: APROBADO, RECHAZADO QR: ACREDITADO |
| MetodoPago | Payment method used for the operation: Transfers: BIND Cards: TARJETA QR: BIND |
| Operacion | Operation performed in the Payment Method: Transfers: TRANSFERENCIA ENTRANTE BIND Cards: COMPRA TARJETA QR: TRANSFERENCIA ENTRANTE BIND |
| NombreCompletoEmisor | Full name of the transaction originator: Transfers: Name of the person who made the transfer Cards: Name of the cardholder QR: Name of the wallet holder used for payment |
| EmailEmisor | Email of the person who made the transaction if applicable, null otherwise. |
| NombreCompletoReceptor | Name of the company receiving the webhook |
| EmailReceptor | Registered email of the company receiving the webhook |
| CuilCuitEmisor | CUIT of the person who made the transaction |
| CuilCuitReceptor | Registered CUIT of the company receiving the webhook |
| BarCode | Operation barcode if applicable, null otherwise. |
| CbuOrigen | CBU of the person who made the transaction, null for wallet or QR transfers. |
| CvuOrigen | CVU of the person who made the transaction, null for Bank transfers with CBU. |
| Tarjeta | Name of the card used for the operation. |
| Cuotas | Number of installments used for the operation. |
| ReferenciaMerchant | Merchant's Operation ID, this field is used to identify if the operation has already been reconciled between the merchant and totalcoin. When this field has a value it means that an operation reconciliation has been performed between the merchant and totalcoin. |
Webhook Configuration: Contact the technical department to configure webhook endpoints and define their security.
Below are some examples of webhook notifications:
Since the same webhook is used to notify different events, below are some examples of webhook notifications
Example of webhook notification for a bank transfer:
{
"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
}
Example of webhook notification for a credit card payment:
{
"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
}
Example of webhook notification for a QR payment:
{
"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
}