How can I set up webhooks to receive a merchant's status during onboarding?
Webhooks can be created via the Partner Console or through the API. To keep track of the status of new merchant accounts, monitor the account.updated
event and the property capabilities.status
in the payload.
Onboarding statuses
-
created
: Merchant application has been created in Tilled. -
started
: Merchant has started the merchant application. -
submitted
: Merchant has successfully submitted the merchant application. Awaiting a response from Underwriting. -
active
: Merchant has been approved to process payments. This is the normal status after submitting. -
disabled
: The merchant account has been disabled due to suspension or termination. -
in_review
: The merchant application is under review. Additional documentation may be requested. -
rejected
: The merchant application has been rejected by Underwriting. -
withdrawn
: The merchant application has been withdrawn.
For more information on webhooks, how to build them, and verifying their signatures, review our webhooks documentation here.