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-30Get 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