TagVomo developer platform: early access.

Partner Promo API

Approved marketing partners can create TagVomo promo codes from their own systems to bring new agency holders and buyers onto the platform. Each partner gets a private API key with limits set by TagVomo.

• Access: keys are issued by TagVomo on request. Ask through the form below or at support@bidua.in.
• Limits per key: maximum discount %, which purchases codes may discount, number of active codes, uses per code, code validity and requests per minute.
• Security: HTTPS only, server-to-server (no browser CORS), key stored by TagVomo only as a hash, optional IP allowlist, every action audit-logged, revocation switches off all of a partner’s codes instantly.
• Code format: every partner code starts with the partner’s prefix, e.g. GROW-DIWALI.

Authentication

Send the key in the Authorization header. Never put it in a website, app or URL.

Authorization: Bearer tvp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Endpoints

appliesTo values: franchise_fee (new agency launch pack), agency_inventory (agency QR inventory), shop (shop orders) — only those your key allows.

Example

curl -X POST https://tagvomo.com/api/partner-api/v1/promo-codes \
  -H "Authorization: Bearer $TAGVOMO_PROMO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: diwali-2026-batch-1" \
  -d '{"percent": 30, "code": "DIWALI", "maxRedemptions": 50, "expiresAt": "2026-11-15T23:59:59Z", "label": "Diwali agency drive"}'

# 201 Created
{"promo": {"code": "GROW-DIWALI", "percent": 30, "appliesTo": ["franchise_fee"], "maxRedemptions": 50,
            "used": 0, "remaining": 50, "status": "active", "expiresAt": "2026-11-15T23:59:59.000Z"}}

Errors: 401 bad or revoked key · 403 above your limits or IP not allowed · 409 code already exists · 429 rate limit (see Retry-After). Buyers type the code at checkout; the discount is always calculated by TagVomo from the real price.

Register interest

Your details are sent securely to the TagVomo team; you can also write to support@bidua.in. Please do not include passwords, OTPs or medical details. Details are used only to reply about this programme; see the privacy policy.