DIWAN
Partner API · v1

Give DIWAN members a benefit — from your own app or website.

Health platforms, telecoms, banks, schools and online shops can check a DIWAN card and report each sale with the member discount. Members see what they saved in their DIWAN app; you reach thousands of members; DIWAN invoices the agreed commission.

One API key

Issued by DIWAN after the agreement. Sent in the X-Partner-Key header.

Privacy by design

A card is checked with its number and the last 4 digits of the member’s phone. You never get the phone number.

Simple JSON

Three calls: verify a member, report a sale, void a sale.

1. Verify a member

Ask the member for their DIWAN card number (in the app under Card) and the last 4 digits of their phone.

POST https://api.diwan.so/partner-api/v1/members/verify
X-Partner-Key: dwn_live_…
Content-Type: application/json

{ "cardNumber": "8252 1234 5678 9012", "phoneLast4": "4567" }

200 OK
{ "valid": true, "status": "ACTIVE", "member": "Amina A.", "tier": "STANDARD",
  "familyCard": false, "expiresAt": "2027-11-04T00:00:00.000Z", "partner": "Your company" }

A wrong card number or wrong phone digits both return 404 MEMBER_NOT_FOUND, so card numbers cannot be guessed.

2. Report a sale with the DIWAN discount

Send it once the member has paid you. externalRef is your own unique reference; sending the same one again returns the first result (safe to retry).

POST https://api.diwan.so/partner-api/v1/transactions
X-Partner-Key: dwn_live_…

{ "cardNumber": "8252 1234 5678 9012", "phoneLast4": "4567",
  "externalRef": "INV-10023", "amount": 40.00, "discountAmount": 4.00,
  "description": "Lab test" }

201 Created
{ "id": "…", "externalRef": "INV-10023", "amount": "40", "discountAmount": "4",
  "commissionAmount": "1.8", "status": "RECORDED", "createdAt": "…" }

3. Void a sale · list your sales

POST https://api.diwan.so/partner-api/v1/transactions/INV-10023/void
GET  https://api.diwan.so/partner-api/v1/transactions?from=2026-11-01&to=2026-11-30

Get access

Contact DIWAN to agree the member benefit and commission. We create your partner profile (it also appears under Services in the app and on this website) and send you a key securely. Limits: 120 requests per minute from one IP address.

Talk to DIWAN