Notifications
Learn about how the notifications of the Cashout API v3 work
Notifications
A notification will be sent every time the status of a cashout changes.
For security reasons we don't send the status of the cashout on the notification itself. Once you have received the notification, you will need to use the Cashout Status Endpoint to retrieve its new status.
The notifications will be sent to the notification_url
specified in the request or to the default Withdrawals URL you have configured on the Merchant Panel by POST protocol in x-www-form-urlencoded format and will have the following fields:
STG Testing
In the STG environment you can force a notification to be sent to your notification_url
from the STG Merchant Panel by going to the Transactions -> Withdrawals
page, opening the cashout transaction and clicking on one of the options that will appear when clicking in the three dots button on the top right of the screen. Those options will change the status of the cashout therefore sending the respective notification after a few minutes.
On STG, the notifications could take up to 5 minutes in being sent.
Example Notifications
Control String
The control string for the notifications is made up of some random characters at the beginning and the end of the request and the external_id
received in the middle.
The control string should be generated using your own secret key (API Signature) and must be in upper case.
Make sure you convert the message to hash to UTF-8 to prevent errors.
Check the examples below on how to calculate the control string for the notifications:
Retry logic
Every time a cashout changes its status, we will send you a notification so you can check its status back.
In case that for some reason your server was unable to receive the notification and you returned an HTTP code different than 2XX, we will retry the notification up to 5 more times or until you respond with HTTP 2XX, whatever comes first.
In case of errors while handling the notification, make sure you will answer with an HTTP code distinct than 2XX, that way we will retry the notification.
The time between the 5 notifications attempts will be of 5 minutes each.
When the notification failed to be sent, it will be shown like this in our Merchant Panel:
If you see the errors from the screenshot above, it means the cashout was successfully completed but suddenly we couldn't notify you. Keep reading to know how to resend the notifications.
Resend Notifications
In case your system was unable to receive the notification in any of the 5 attempts, you can always check its status with the Cashout Status Endpoint.
If you need to trigger the check status by receiving our notification, once the issue preventing you from receiving our notifications was fixed, you can go to the Merchant Panel, locate the cashout (Transactions -> Withdrawals) and click on the three dots button under the "Status History" section and then "Resend notification" to force a new notification to be sent.
It can take up to 2 minute for the notification to be resent.
Last updated