Quickstart

The POS Partner API allows third-party POS systems to integrate with DigiWedge member wallets for member lookup, balance checks, table linking, top-ups, and settlement.

Getting started

1. Contact DigiWedge to receive your partner API key and club configuration
2. Integrate using the endpoints documented in this guide
3. Test against the UAT environment before going live

Environments

Environment	Base URL
UAT	https://pos-partner-api.uat.digiwedge.com
Production	https://pos-partner-api.digiwedge.com

Authentication

All partner contract endpoints under /api/v1/pos/partners/* require an x-partner-key header with the partner API key provided during onboarding. Health endpoints do not require authentication.

Available capabilities

• Member lookup — POST /api/v1/pos/partners/members/lookup
• Wallet balance — GET /api/v1/pos/partners/balance
• Table link — POST /api/v1/pos/partners/tables/link
• Wallet top-up — POST /api/v1/pos/partners/topups
• Settlement — POST /api/v1/pos/partners/settlements

Health Checks

• GET /api/health/ready
• GET /api/health/live

Gateway Smoke

You can validate a live environment with the repeatable smoke script:

POS_BASE_URL=https://pos-partner-api.uat.digiwedge.com \
POS_PARTNER_KEY=<key> \
bash tools/scripts/smoke/pos-partner-api.sh