What are Webhooks used for?

Tax calculations are asynchronous processes and can take a while to finish.
In order to get notified when the tax calculation is complete you can use a webhook where Taxtris will send updates for running calculations.
Taxtris will make a POST request to the URI provided by the exchange in webHookURI field.

Webhook request body

Parameters are sent as JSON body and contain information about the customer and the status of the running tax. calculation

The params supplied to the webHookURI:

• externalId - ID of the Customer, provided by CEX
• trackingId - Taxtris ID of the running/run tax calculation
• status - Status of the Taxtris tax calculation
  (PROCESSING, CALCULATING, GENERATING_REPORT COMPLETED, ERROR)

Example body request:

{
  "externalId":"d290f1ee-...",
  "trackingId":"d290f1ee-6c54...",
  "status":"processing"
}

API integration

When the Tax calculation process is successfully completed by starting it with the API call to:

calculates on-demand tax for a specific account
or
subscribes account to tax calculations

Taxtris will make a POST request to the URI provided by the exchange in webHookURI property.

Manual update callbacks

Manually updating assets by the customer, adding or removing a wallet, or changing a country, will trigger a recalculation of their obligations without you knowing.
In this case, we will use your default webHookURI property and notify you when the new calculation is finished.

The webhookURI property is set in the partner config section, as part of the CEX partner account initialization process.