EidKit Android SDK/ro.eidkit.sdk/EidKit/relay

relay

suspend fun relay(isoDep: IsoDep, can: String, pin: String, wsUrl: String, transport: NfcRelayTransport, onEvent: (ReadEvent) -> Unit? = null, onUnknownFrame: (type: String, frame: JSONObject) -> Unit? = null)

Run a v3 SSO relay session. The server drives all APDU exchanges; the app is a dumb pipe.

Requires the session WebSocket URL from the deep link (wss param), a caller-provided NfcRelayTransport (e.g. OkHttp WebSocket), and the user's CAN + auth PIN.

Parameters

isoDep
can

Card Access Number (6 digits)

pin

Auth PIN (4 digits)

wsUrl

WebSocket URL from deep link, e.g. wss://idp.eidkit.ro/v3/nfc-relay?session=<token>

transport

Caller-provided WebSocket implementation

onEvent

Optional progress callback

onUnknownFrame

Optional callback invoked for any frame type the SDK does not handle natively (e.g. email_request, email_otp_sent). The callback receives the frame type and the raw org.json.JSONObject. Use transport's NfcRelayTransport.sendFrame to send a reply. If null, unknown frames are silently ignored.

Throws

if configure has not been called.