Callbacks

Callbacks are used by Any.Cash for sending order status finalization message to a URL passed in the method request

Transaction Completion Notification

This callback is intended to allow Any.Cash server to inform a user or tenant of the final status of a transaction (either Bill or Withdrawal). Any.Cash will send a notification to the user or tenant upon finalization of every Bill or Withdrawal.

A callback is an HTTP POST request sent to a URL passed in a method call.

Your application must implement the same authorization mechanism which is used to call Any.Cash API. Also, Any.Cash server uses the same headers as the ones used to call Any.Cash API, when we send a callback.

NOTE! If a static tenant URL is used, then the full URL must be provided by the tenant including setting any parameters in the path. The URL should be HTTPS.

Types of callbacks

Order type	Callback payload
Bill	See Bill data representation
Withdrawal	See Withdrawal data representation

A user or tenant application should respond immediately with a 200 OK to indicate that they received the request. Any.Cash will retry sending the request for a configurable number of attempts in the case of connection issues, but once a connection is made any error response or read timeout will be ignored.