Webhooks
Webhook Event Catalogue
Exhaustive list of webhook event types and sample JSON payload schemas.
Depa emits structured events covering identity verification, bank wire settlements, blockchain confirmations, and account security.
1. Identification Events
identification_verified
Fired when a user or corporate identity passes all KYC/KYB checks.
{
"data": {
"event": "identification_verified",
"attributes": {
"identification_id": "ident_9f3b120c",
"status": "verified",
"timestamp": 1714562415
}
}
}identification_failed
Fired when verification is definitively rejected.
{
"error": {
"event": "identification_failed",
"attributes": {
"identification_id": "ident_9f3b120c",
"message": "Sanctions screening match",
"status": "rejected",
"timestamp": 1714562415
}
}
}2. Fiat Payment Events
fiat_payment_received
Fired when incoming funds clear into a virtual IBAN.
{
"data": {
"event": "fiat_payment_received",
"attributes": {
"fiat_payment_uuid": "pay_989eg9c7-3h8a-9d0a-987a-02ka192a8012",
"bank_account_id": "ba_989eg9c7",
"account_id": "acct_8921a8d0",
"iban": "ES3500818245944561890645",
"recipient": "Acme Capital SL",
"sender_name": "Kraken European Operations",
"amount": "50000.00",
"currency": "EUR",
"status": "confirmed",
"settlement_status": "settled",
"timestamp": 1714562415
}
}
}fiat_payment_sent
Fired when an outbound wire leaves Depa's nostro clearing account.
{
"data": {
"event": "fiat_payment_sent",
"attributes": {
"fiat_payment_uuid": "pay_989eg9c7-3h8a-9d0a-987a-02ka192a8012",
"bank_account_id": "ba_989eg9c7",
"account_id": "acct_8921a8d0",
"recipient_iban": "DE89370400440532013000",
"amount": "15000.00",
"currency": "EUR",
"status": "confirmed",
"timestamp": 1714562430
}
}
}3. Blockchain Payment Events
blockchain_payment_confirmed
Fired when an on-chain stablecoin transfer achieves finality on its target network.
{
"data": {
"event": "blockchain_payment_confirmed",
"attributes": {
"payment_id": "bpay_88291a0",
"asset": "USDC",
"amount": "25000.00",
"network": "ethereum",
"tx_hash": "0x9f3a12b829c01192...",
"block_number": 19842109,
"timestamp": 1714562430
}
}
}