Skip to main content
All examples use {baseUrl} rather than a live hostname. Full response fields are in the guides and API Reference.

1. Confirm a contribution

Confirm only after your system has deducted the customer’s points.
A successful confirmation returns HTTP 201 with status: confirmed. See Contributions.

2. Recover after a timeout

Look up the contribution by partner_event_id:
If no contribution is found, the response is not a final failure and does not authorize point restoration. Safe retry of the original confirmation request is permitted:
See Errors & Recovery.

3. Estimate, then associate

Create an estimate:
Associate the estimate to a confirmed contribution:
See Delivery Emissions.

4. Verify a webhook

Compute HMAC-SHA256 over the exact X-Akhdar-Timestamp value, a period (.), and the exact raw request body bytes. The signature format is v1=<hex>. Accept timestamps only within five minutes before or after receipt. Process idempotently by event_id. See Webhooks for the confirmed-contribution payload and partner actions.