| name | aiprise-webhooks |
| description | Receive and verify AiPrise webhooks (callbacks). Use when setting up AiPrise identity/KYC/KYB callback handlers, debugging X-HMAC-SIGNATURE verification, or handling verification results like APPROVED, DECLINED, REVIEW, and UNKNOWN.
|
| license | MIT |
| metadata | {"author":"hookdeck","version":"0.1.0","repository":"https://github.com/hookdeck/webhook-skills"} |
AiPrise Webhooks
AiPrise is an identity verification (KYC/KYB) platform. It notifies your server of
verification outcomes and business-profile changes via callbacks — signed HTTP
POST webhooks.
When to Use This Skill
- How do I receive AiPrise webhooks (callbacks)?
- How do I verify the AiPrise
X-HMAC-SIGNATURE header?
- How do I handle
APPROVED, DECLINED, REVIEW, or UNKNOWN verification results?
- Why is my AiPrise webhook signature verification failing?
- How do I correlate a callback with a verification session?
Verification (core)
AiPrise signs every callback with HMAC-SHA256 over the raw request body,
lowercase hex, in the X-HMAC-SIGNATURE header. The HMAC key is your AiPrise API
private key directly (e.g. abcdef12-pqrs-...) — there is no separate signing or
endpoint secret, and this is Standard Webhooks. Verify against the exact raw
body bytes; re-serializing the JSON changes bytes and breaks the signature.
