Documentation V3
Search…
⌃K

Callbacks - Webhooks

Get updates on transaction status
Every transaction that affects your account balance (which represents a final status) will be notified via Callback. Those transactions are:
  • PAYINS
    • Cash y Bank Transfer: When transaction status is Rejected, Expired, Cancelled, Completed, Refunded
    • Cards (Credit/Debit): When transaction status is Rejected, Expired, Cancelled, Completed, Refunded, Chargeback
  • PAYOUTS
    • When transaction status is Completed, Rejected, Cancelled, Returned, Recalled
  • INTERNAL TRANSFER
  • REFUND
  • CHARGEBACK
  • RECURRING FEE
  • WIRE IN
  • WIRE OUT
  • RETURN
  • RECALL
  • CURRENCY EXCHANGE

Callback configuration

The configuration of the CALLBACK service is very simple since it can be done through the LocalPayment user interface Stage and/or Production environment.
Once you have entered the user interface, click on: Settings → Edit Client → Notifications.
In the "Notifications" section, select Callbacks tab and enter a URL. On the reported URL, you will receive a POST request each time a transaction reaches a final status (described above).
In addition to the notification URL, we will configure and share with you a secret key that will be used to sign the request via HMAC-SHA256. The resulting signature will be sent in the X-Signature header like shown in the image:
HMAC-SHA256 KEY
HMAC-SHA256 ecac5e86f0c63a52297e1b48cbgea38fbf98kce89n8227b22d3009b6713428e9
When you sign the HMAC-SHA256 request, it is recommended that you compress the json request to remove white space. Also avoid using any json formatter that can modify the original format of property values.
Remember that you are able to setup and change your own Callbacks - Webhooks by accessing with an ADMIN user to the application.
Our Dynamic tutorial:

Example: Callback Notifications Service

The general structure for this request is:
{
"transactionType": "Payin",
"data": {
...
} }
The "data" node content of the Callback is the same as the Body structure of the Check Payment
Remember that you can also check the status of each transaction using the Check Status endpoint. The request payload you will receive will be the same as the one sent by the CALLBACK push notification service.
Examples Callback Notifications Service