Onboarding Webhooks
Onboarding Webhook Events
Onboarding End-State Webhook Event
Quadrata will emit a webhook event (HTTP Request) whenever an onboarding passport has reached an end-state. The payload for this request will contain all attributes and statuses known for the Passport at the time of the event.
An application's end-state is triggered when all attributes for an application type have been verified, and the application's status is set to either IN REVIEW, APPROVED, or REJECTED.
KYC
Emitted when a KYC application reaches an end-state.
AML
Emitted when an AML application reaches an end-state.
Accreditation
Emitted when an Accredited Investor's application reaches an end-state.
Business
Emitted when a KYB application reaches an end-state.
Payload Structure
Webhooks are sent over HTTPS with a signature verification header. Each payload will include the following data:
Request Header
Each webhook request that Quadrata emits will contain a header signature that an integrating application can use to verify the authenticity of the message.
X-WEBHOOK-SIGNATURE - Base64 Encoded
SHA384
request signature.
See Webhook Request Signaturefor more information on how to verify the webhook request signature.
Request Body
attributes
- JSON payload of all known attributes at the time of the eventeventId
- The UUID for the event that triggered this webhooknonce
- To ensure the signature is always uniquetimestamp
- Unix epoch representing the time when the notification was triggeredtype
- Representing the type of notification,ONBOARDING
walletAddresses
- Array of wallet addresses associated to the onboarding application.
For business applications, each wallet address related to the business entity will be included in the payload.
For individual applications, only the single passport wallet address will be included in the payload.
Quadrata will attempt to deliver a webhook payload up to 3 times for each configured URI, if an HTTP response status code is returned outside of the 2xx range (200, 201, etc).
See Passport Attributes for a list of supported attributes.
Company Offering Webhook Event
Quadrata will emit a webhook event (HTTP Request) whenever an onboarding passport has verified their INVESTOR_STATUS
for a company offering. The payload for this request will contain all attributes and statuses known for the Passport at the time of the event, along with the verification status for the specific offering.
Payload Structure
Webhooks are sent over HTTPS with a signature verification header. Each payload will include the following data:
Request Header
Each webhook request that Quadrata emits will contain a header signature that an integrating application can use to verify the authenticity of the message.
X-WEBHOOK-SIGNATURE - Base64 Encoded
SHA384
request signature.
See Webhook Request Signaturefor more information on how to verify the webhook request signature.
Request Body
attributes
- JSON payload of all known attributes at the time of the eventeventId
- The UUID for the event that triggered this webhooknonce
- To ensure the signature is always uniqueoffering
- JSON payload of all attributes associated with offering, including the offering idtimestamp
- Unix epoch representing the time when the notification was triggeredtype
- Representing the type of notification,ONBOARDING
walletAddresses
- Array of wallet addresses associated to the onboarding application.
Last updated