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

providerpathrequiredstring

Responses

200Acknowledged, whether processed, duplicate or ignored.
receivedbooleanrequired
duplicateboolean
ignoredstring
400Signature verification failed.
errorobjectrequired

Example

curl
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.