Skip to main content

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​

EnvironmentBase URL
UAThttps://pos-partner-api.uat.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.

OpenAPI Docs​

Interactive OpenAPI docs are available from UAT when POS_PARTNER_API_DOCS_ENABLED is set to true:

  • UAT: https://pos-partner-api.uat.digiwedge.com/api/docs
  • JSON: /api/docs-json
  • YAML: /api/docs-yaml

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