API reference / Payments
post
/v2/webhooks/{provider}Payment provider callback
- Operation
providerWebhook- Authentication
- None — public
Called by the payment provider, not by partners. **Unauthenticated** — a provider cannot present a Haavisa API key, so the request is authenticated by signature instead, and a bad signature is a 400 because it is an unauthenticated instruction to move money.
Delivery is at-least-once and duplicates are expected: the provider and event id are unique together, so a redelivery is acknowledged without reprocessing. An unknown provider is acknowledged rather than rejected, so a misconfiguration cannot cause a retry storm.
Request
Parameters
providerpathrequiredstringResponses
200Acknowledged, whether processed, duplicate or ignored.
receivedbooleanrequiredduplicatebooleanignoredstring400Signature verification failed.
errorobjectrequiredExample
curl -X POST https://api.haavisa.com/v2/webhooks/<provider>More in Payments
Something unclear? The eligibility guide explains the model behind the answers; the errors guide covers the envelope.