Webhooks
Clickmax has two kinds of webhook: inbound (in), which receives events from an external platform, and outbound (out), which sends an event from Clickmax to an external URL when a trigger fires.
Role required: authenticated workspace member. Webhooks are managed in the Integrations area.
Direction
Inbound platforms
Values accepted when creating an inbound webhook.
Outbound platforms
Destinations accepted when creating an outbound webhook.
Triggers
Events that fire an outbound webhook (the trigger field).
Card declined vs transaction failed
REFUSED_CARD fires once per payment attempt in which the card was sent to the charge and refused. A second attempt by the buyer with the same card, minutes later, is a new refusal and fires again.
A purchase that never reaches the charge — required card missing, product out of stock, pending seller account, missing delivery address — is not a card refusal: it only fires TRANSACTION_FAILED. Pix and Boleto failures also use TRANSACTION_FAILED only.
When SUBSCRIPTION_CANCELLED fires
On any subscription cancellation, whatever its origin: cancelled by the buyer, by you or by support, the automatic cancellation for missed payment after the tolerance period, and the cancellation that comes with a refund.
A subscription that reached the end of its contracted duration (the plan's last scheduled charge) is not a cancellation and does not fire this trigger.
Record statuses
Every delivery creates a record with one of these statuses.
Related
If it didn't work
- The platform gets a
401when sending inbound: the webhook is inactive, has been deleted, or the token/signature does not match — see Error codes. - An outbound webhook never reaches its destination: check the record status and the endpoint's response in Error codes.
- General questions about integrations: see the Frequently asked questions.