# Akhdar Developer Docs

> ## Agent Instructions
> Use {baseUrl} for the environment-specific base URL provided to the partner integration team. Do not invent an API hostname.
> x-akhdar-* fields are publication provenance only. Do not treat them as partner integration instructions.

- [Introduction](https://docs.akhdar-sa.com/introduction.md): Akhdar lets customers use existing loyalty points to support tree planting.
- [Quickstart](https://docs.akhdar-sa.com/quickstart.md): Confirm a loyalty-points contribution.
- [Authentication](https://docs.akhdar-sa.com/authentication.md): Akhdar partner APIs use server-to-server authentication with X-API-Key.
- [Contributions](https://docs.akhdar-sa.com/contributions.md): Confirm a loyalty-points contribution after the partner has deducted the customer's points.
- [Delivery Emissions](https://docs.akhdar-sa.com/delivery-emissions.md): Optional educational Well-to-Wheel estimates. An estimate is not environmental impact by itself.
- [Webhooks](https://docs.akhdar-sa.com/webhooks.md): Outbound signed events to your HTTPS receiver. Webhooks are not Akhdar REST paths.
- [Errors & Recovery](https://docs.akhdar-sa.com/errors-and-recovery.md): Partner server-to-server errors use a consistent envelope. Do not restore points after an unknown result.
- [Examples](https://docs.akhdar-sa.com/examples.md): Copyable cookbook for confirmation, recovery, estimates, and webhook verification. All examples use {baseUrl}.
- [Changelog](https://docs.akhdar-sa.com/changelog.md): Public documentation changes for Learn & Integrate.
- [API Reference](https://docs.akhdar-sa.com/api-reference.md): Index of partner server-to-server operations and outbound webhook events.
- [Confirm a loyalty-points contribution](https://docs.akhdar-sa.com/api-reference/contributions/confirm-a-loyalty-points-contribution.md): Confirms a loyalty-points contribution after you have successfully deducted the customer's points. `Idempotency-Key` is required.
- [Recover contribution status by partner_event_id](https://docs.akhdar-sa.com/api-reference/contributions/recover-contribution-status-by-partner_event_id.md): Recover contribution status by `partner_event_id` after a timeout or unknown result.
- [Retrieve contribution status by transaction_id](https://docs.akhdar-sa.com/api-reference/contributions/retrieve-contribution-status-by-transaction_id.md): Retrieves contribution status by Akhdar `transaction_id`. For timeout recovery after a lost confirmation response, prefer lookup by `partner_event_id`.
- [Create a delivery-emissions estimate](https://docs.akhdar-sa.com/api-reference/delivery-emissions/create-a-delivery-emissions-estimate.md): Creates an optional educational Well-to-Wheel delivery-emissions estimate. An estimate is not environmental impact by itself and is not required to confirm a contribution.
- [Retrieve a delivery-emissions estimate](https://docs.akhdar-sa.com/api-reference/delivery-emissions/retrieve-a-delivery-emissions-estimate.md): Retrieves a temporary estimate by `calculation_id`.
- [Associate a late emissions estimate](https://docs.akhdar-sa.com/api-reference/delivery-emissions/associate-a-late-emissions-estimate-with-a-confirmed-contribution.md): Associates a valid temporary estimate with a confirmed contribution. `Idempotency-Key` is required. At most one valid association exists per confirmed contribution and per estimate.
- [impact.transaction.confirmed](https://docs.akhdar-sa.com/api-reference/webhooks/impacttransactionconfirmed.md): Delivered when a contribution reaches terminal `confirmed`. This is not an Akhdar REST path.
- [impact.transaction.adjusted](https://docs.akhdar-sa.com/api-reference/webhooks/impacttransactionadjusted.md): Delivered when an adjustment for a confirmed contribution reaches `adjusted`. This is not an Akhdar REST path. The payload is identifier-only.
- [settlement.created](https://docs.akhdar-sa.com/api-reference/webhooks/settlementcreated.md): Delivered when a settlement identified by `settlement_id` has been created. This is not an Akhdar REST path. The payload is identifier-only (`settlement_id`, `partner_id`).
- [settlement.closed](https://docs.akhdar-sa.com/api-reference/webhooks/settlementclosed.md): Delivered when a settlement identified by `settlement_id` has been closed. Closed settlements are immutable. This is not an Akhdar REST path. The payload is identifier-only plus `status: closed`.
- [environmental.status.updated](https://docs.akhdar-sa.com/api-reference/webhooks/environmentalstatusupdated.md): Delivered when environmental status for a confirmed contribution changes. This is not an Akhdar REST path. The payload is `transaction_id` plus the status value.

## OpenAPI Specs

- [partner-api](/openapi/partner-api.yaml)