Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Fired when a cardholder’s KYC status changes
cardholder.kyc.updatedPOST /partner/cardholders/{id}/kyc returns "status": "pending", and this event fires once verification completes. When the outcome is approval, a cardholder.approved event is emitted alongside this one. Sandbox replays the same pending-then-approved sequence after a short delay (payloads include "sandbox": true).
{
"cardholderId": "ch_abc123",
"cardProgramId": "prog_def456",
"kycStatus": "approved"
}
| Field | Type | Description |
|---|---|---|
cardholderId | string | Cardholder whose KYC status changed |
cardProgramId | string | Card program the KYC was initiated for |
kycStatus | string | New KYC status. One of approved, rejected, pending |
| Status code | Meaning |
|---|---|
200 | Event received and processed |
202 | Event received, will process asynchronously |
| Any non-2xx | Delivery failed — will retry |
app.post("/webhooks/contro", (req, res) => {
const eventType = req.headers["x-contro-event"];
if (eventType === "cardholder.kyc.updated") {
const { cardholderId, kycStatus } = req.body;
if (kycStatus === "approved") {
// Cardholder is verified — you can now issue cards
} else if (kycStatus === "rejected") {
// Notify your user to retry or contact support
}
}
res.status(200).send("OK");
});