v1

latestOpenAPI 3.1.02026-07-26165182724.7 KB

SCA Transactions

Start passkey approval ceremony for a pending transaction

Issues a WebAuthn assertion challenge bound to an existing transaction challengeId (returned by an initiate endpoint). Required only when the partner picked verificationMethod: passkey on the initiate call — run this before submitting the signed credential to /wallets/transaction/confirm.

post/wallets/passkey/approval/start

Request body

userIdstring required

challengeIdstring required

Transaction challenge id returned by an initiate endpoint.

Example request

{
  "userId": "550e8400-e29b-41d4-a716-446655440000",
  "challengeId": "7a3f1c2e-9b8d-4c2a-8e5f-1234567890ab"
}

Response

WebAuthn assertion options bound to the transaction challenge.

challengeIdstring required

dateExpiresstring

verificationMethod'passkey' required

allowedOriginsstring[] required

relyingPartyIdstring required

Example response

{
  "challengeId": "7a3f1c2e-9b8d-4c2a-8e5f-1234567890ab",
  "dateExpires": "2026-05-25T12:34:56.000Z",
  "verificationMethod": "passkey",
  "options": {
    "challenge": "M0fO5_TvKnE8nKf8sZpTzg",
    "timeout": 60000,
    "rpId": "app.example.com",
    "allowCredentials": [
      {
        "type": "public-key",
        "id": "YWJjZGVmZ2g"
      }
    ],
    "userVerification": "preferred"
  },
  "allowedOrigins": [
    "https://app.example.com"
  ],
  "relyingPartyId": "app.example.com"
}