Wink Developers
Sign in Get keys
Home › Playground › WinkPay Portal
Playground · WinkPay

WinkPay Portal

Interactive playground for developers integrating the WinkPay SDK — biometric checkout, payment intents, and wallet operations against a live merchant.

Environment stage Mode scaffold
i

Scaffold — under construction. The WinkPay SDK is an Android library that wraps Wink Core APIs and layers POS-specific UX. This playground exposes the same Wink Core ops the SDK calls underneath, but organized as a POS-checkout flow — so devs can see what each startPayment / startCheckin call does on the wire. The center column will hold one card per flow step.

WinkPay checkout flow cards will appear here

The SDK calls Wink Core APIs underneath. We curate + reorder the existing ops as POS-checkout steps so developers can run the sequence and inspect each call's wire shape. This is not a new API surface — it's a flow-oriented overlay on what's already on /playground/core/api/.

TODO for contributors — POS-checkout flow steps:
  • Step 1 · Mint session — call POST /wink/v1/session (Core API). Card shows merchant clientId + secret reuse from the signed-in dev's saved creds.
  • Step 2 · Recognize face — call recognize_face with a captured face frame (drop-zone in the right rail). Returns winkTag + access token. This is what the SDK's startCheckin drives under the hood.
  • Step 3 · Get user wallet — call recognize_face_cards with the same access token. Returns saved cards. The SDK shows this list as its card-picker UI.
  • Step 4 · Prepare checkout — call prepare_inline_checkout with amount + tenderId + selected card. Returns a payment intent.
  • Step 5 · Confirm / capture — call wait_for_checkout to finalize. This is the wire-level equivalent of EmbeddedPaymentResult.transactionId.
  • Right rail · Biometric capture panel — face/voice slots + "Reset testing session" button. Mirror the structure from /playground/core/api/.

Reference implementations to crib from:

  • playground/core/api/index.html — operation-list pattern with OPERATIONS = [...], formFields, bodyExample. Pull individual op definitions from here and reorder as flow steps.
  • /winkpay/sdk/ — the SDK reference. Each flow step here corresponds to a specific Kotlin SDK call (startCheckin, startPayment) documented there.