Quickstart

Confirm your first contribution after the customer action completes on your side:

Loyalty Points — after you deduct points from the loyalty wallet.
Direct Contribution — after you collect payment through your own infrastructure (no card or PSP data sent to Akhdar).

Your Partner is assigned loyalty_points or direct_contribution, and Delivery Emissions may be enabled separately. See Contributions for the four supported combinations and request shapes.

Assumptions

You are integrating server-to-server. After API access is granted, your integration team receives a partner API key and an environment-specific base URL. The secret is shown once: store it securely and never log it. This credential is for partner server-to-server use only. Sandbox and Production are separate. Use the environment-specific base URL provided to your integration team.

Request API access

Request API Access

Open Akhdar’s contact form to request API access.

Configure credentials

Set placeholders only. Replace them with the values provided to your integration team.

AKHDAR_API_KEY — partner API key
{baseUrl} — environment-specific base URL

Confirm first contribution

Use the request for your Partner method.

Loyalty Points
Direct Contribution

After points deduction:

curl -X POST "{baseUrl}/v1/impact-transactions" \
  -H "X-API-Key: $AKHDAR_API_KEY" \
  -H "Idempotency-Key: idem_01HZX5Z9Y8X7W6V5U4T3S2R1" \
  -H "Content-Type: application/json" \
  -d '{"partner_event_id":"evt_contrib_01HZX5A1B2C3D4E5F6G7H8J9","partner_order_ref":"ord_9f3c2a71","points":500,"opaque_customer_ref":"cust_ref_8a1b2c3d"}'

After partner-side payment collection:

curl -X POST "{baseUrl}/v1/impact-transactions" \
  -H "X-API-Key: $AKHDAR_API_KEY" \
  -H "Idempotency-Key: idem_01HZX5Z9Y8X7W6V5U4T3S2R1" \
  -H "Content-Type: application/json" \
  -d '{"partner_event_id":"evt_direct_01HZX5A1B2C3D4E5F6G7H8J9","partner_order_ref":"ord_direct_9f3c2a71","amount_halalas":500,"partner_payment_reference":"pay_ref_abc123xyz","opaque_customer_ref":"cust_ref_8a1b2c3d"}'

Check the response

A successful confirmation returns HTTP 201 with status: confirmed. The response includes contribution_method and method-specific fields (points or amount_halalas / partner_payment_reference).Save the transaction_id. A confirmed status is terminal and the contribution is non-refundable.

Getting started

Guides

Resources

Assumptions

Request API Access

Next

​Assumptions

Request API Access

​Next

Assumptions

Next