Brand eSense API

Gifting and rewards infrastructure.

Brand eSense is not only an app. Connect your own systems and turn points, miles, bonuses or vouchers into value someone can spend on anything — delivered with a Gift Story, redeemable in one wallet.

Authentication

Every request carries a bearer key. Keys are scoped, and only a hash is stored — the plaintext is shown once, when you create it.

curl -X POST https://YOUR-DOMAIN/api/v1/value \
  -H "Authorization: Bearer zk_live_3f9a2c81_xK7…" \
  -H "Content-Type: application/json" \
  -d '{"recipient":"sara@example.ae","amount":50000}'

Brand keys Corporate keys

Endpoints

POST/api/v1/valuevalue.issue

Issue Gift Value to anyone — the recipient chooses what it becomes.

Banks converting points, airlines converting miles, employers sending rewards.

Request

{
  "recipient": "sara@example.ae",
  "amount": 50000,
  "message": "Thanks for ten great years.",
  "occasion": "Work anniversary",
  "giverName": "Meridian Group"
}

Response

{
  "id": "gift-8f2k…",
  "code": "GIFT-7K2P4M",
  "amount": 50000,
  "currency": "AED",
  "recipientIsZenoUser": true,
  "revealUrl": "https://YOUR-DOMAIN/gift/GIFT-7K2P4M",
  "status": "sent"
}

POST/api/v1/pointspoints.issue

Credit Points to an existing user's wallet (100 points = AED 1).

Loyalty programmes moving their currency into Brand eSense.

Request

{
  "recipient": "sara@example.ae",
  "points": 2500,
  "provenance": "Skywards miles conversion"
}

Response

{ "recipient": "sara@example.ae", "points": 2500, "status": "credited" }

POST/api/v1/gift-cardsgiftcards.create

Mint a gift card against one of your published offers.

Hotels, retailers and telcos issuing from their own systems.

Request

{
  "offerId": "gco-spa",
  "amount": 30000,
  "recipient": "sara@example.ae"
}

Response

{
  "id": "gc-2p9x…",
  "brand": "Spa Serenity",
  "code": "SPA-4M2K-9X7T",
  "amount": 30000,
  "assigned": true,
  "status": "active"
}

GET/api/v1/redemptions/{code}redemption.read

Check whether a gift or gift card has been opened or redeemed.

Anyone reconciling liability at month end.

Response

{
  "type": "gift_card",
  "code": "SPA-4M2K-9X7T",
  "brand": "Spa Serenity",
  "amount": 30000,
  "status": "redeemed",
  "claimed": true
}

Webhooks

Register an endpoint to hear about gift.opened, gift.accepted, giftcard.redeemed and value.issued. In this build delivery is stubbed — attempts are recorded, no outbound request is made.

Errors

400

Malformed body, or an amount below the minimum.

401

Missing, malformed, unknown or revoked key.

403

Key is missing the required scope, or the resource belongs to another partner.

404

No such offer, user or code.

409

The offer is paused.

Issuing stored value and transferring it between people are regulated activities in the UAE. Production access requires a licensed issuing partner and KYC/AML checks on both sides of a transfer.