Examples

All examples use {baseUrl} rather than a live hostname. For your first contribution, see Quickstart. For recovery after a timeout, see Errors & Recovery.

1. Estimate, then associate

Create an estimate (only when Delivery Emissions is enabled for your Partner):

curl -X POST "{baseUrl}/v1/emissions/estimates" \
  -H "X-API-Key: $AKHDAR_API_KEY" \
  -H "Idempotency-Key: idem_est_01HZX4K9M2Q8R7N6P5T4V3" \
  -H "Content-Type: application/json" \
  -d '{"partner_order_ref":"ord_9f3c2a71","distance_km":"7.400","distance_unit":"km","vehicle_category":"motorcycle_gasoline"}'

Associate the estimate to a confirmed contribution (Loyalty or Direct):

curl -X POST "{baseUrl}/v1/impact-transactions/txn_01HZX6M4N5P6Q7R8S9T0U1V2/emissions-associations" \
  -H "X-API-Key: $AKHDAR_API_KEY" \
  -H "Idempotency-Key: idem_assoc_01HZX8A1B2C3D4E5F6G7H8" \
  -H "Content-Type: application/json" \
  -d '{"calculation_id":"calc_01HZX4K9M2Q8R7N6P5T4V3W2X1"}'

See Delivery Emissions.

2. 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 delivery behavior, partner actions, and payload schemas in the API Reference. For planting fulfilment batch status (environmental.status.updated event version 2), see Planting fulfilment batch webhooks.

Getting started

Guides

Resources

1. Estimate, then associate

2. Verify a webhook

​1. Estimate, then associate

​2. Verify a webhook

1. Estimate, then associate

2. Verify a webhook