ZYKAY Integration

Choose your v4 integration mode.

Compliance rails

RailFor whomResultCallback
STANDARDConsumer apps, e-commercegrant_codePOST /v1/exchangeYes (HMAC)
ADULT_BLINDAdult sites (double anonymization)attestation JWS → local verificationNo

Approaches

Architecture

1. Script tag loads https://widget-app.zykay.com/v4/loader.min.js
2. Widget creates verify-request
3. User validates in the ZYKAY app (mobile) or via QR (desktop)
4. Widget poll verify-status
5. Redirect to data-success-path#grant_code=...
6. Frontend sends grant_code to backend
7. Backend exchanges via POST /v1/exchange

Next steps