Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Fired when a new card is issued
card.issuedPOST /partner/cards returns immediately with "status": "pending" and this event fires later — once the card has been fully provisioned and transitioned to active. Treat this event (not the issue response) as the signal that the card is ready to use. Sandbox reproduces the same sequence after a short delay.
{
"cardId": "card_xyz789",
"cardholderId": "ch_abc123",
"programId": "prog_def456",
"userId": "usr_ghi789"
}
| Field | Type | Description |
|---|---|---|
cardId | string | Newly issued card ID |
cardholderId | string | Cardholder the card was issued to |
programId | string | Card program used for issuance |
userId | string | Internal user ID linked to the cardholder |
| 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 === "card.issued") {
const { cardId, cardholderId, programId } = req.body;
// Notify your user that their card is ready
}
res.status(200).send("OK");
});