Référence API/Webhooks

Webhooks

Enregistrez un endpoint et recevez des événements signés à chaque changement d’état de paiement, décaissement, dépôt et demande de paiement. Les livraisons sont réessayées avec délai pendant 24 heures. Vérifiez Decaf-Signature en HMAC-SHA256 sur l’horodatage, un point et le corps brut ; rejetez les horodatages de plus de cinq minutes.

Événements

Événement	Quand
payout.submitted	Funds committed and handed to the rail
payout.awaiting_claim	Claim link sent
payout.claimed	Recipient claimed and chose a method
payout.succeeded	Delivered
payout.failed	Final failure after retries
payout.refunded	Funds returned after a failed delivery
disbursement.awaiting_approval	Submitted for approval
disbursement.launched	Execution started
disbursement.completed	Every item final and succeeded
disbursement.completed_with_failures	Every item final, at least one failed
deposit.received	A bank or on-chain deposit credited your balance
payment_request.paid	A fixed-amount request was matched

Register a webhook endpoint

POST/webhooks

Deliveries retry with backoff for 24 hours. The secret is shown once. Verify Decaf-Signature as HMAC-SHA256 over t + . + raw_body; reject timestamps older than five minutes.

Champ	Type	obligatoire	Notes
url	string	obligatoire
events	array	obligatoire

Requête

{
  "url": "https://example.com/decaf",
  "events": [
    "payout.*",
    "disbursement.*",
    "deposit.*"
  ]
}

Réponse 201

{
  "id": "wh_2c1d",
  "url": "https://example.com/decaf",
  "events": [
    "payout.*",
    "disbursement.*",
    "deposit.*"
  ],
  "secret": "whsec_9f3e..."
}

Exemples: Register a webhook endpoint

curl -X POST https://sandbox.api.decaf.so/v1/webhooks \
  -H "Authorization: Bearer $DECAF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/decaf","events":["payout.*","disbursement.*","deposit.*"]}'

List webhooks

GET/webhooks

Delete a webhook

DELETE/webhooks/{id}

Paramètres

idpathstringobligatoire

Obtenir l’accès

Développez sur le sandbox dès cette semaine.

Dites-nous les corridors dont vous avez besoin et qui vous payez. Les clés sandbox sont délivrées par une personne.