v1

latestOpenAPI 3.1.02026-07-26165182724.7 KB
Trusted Beneficiary

Initiate marking an IBAN as Trusted Beneficiary

Issues the SCA challenge for the chosen factor (default sms). Confirm with /wallets/beneficiary/confirm-trust.

post/wallets/beneficiary/iban/trust

Request body

userIdstring required
whitelistedIbanIdstring required
verificationMethod'sms' | 'totp' | 'passkey'

Defaults to sms when omitted.

Response

Challenge issued. The response always carries verificationMethod plus the factor-specific fields: sms adds challengeId and dateExpires; passkey adds options, allowedOrigins, and relyingPartyId; totp adds ok.

verificationMethod'sms' | 'totp' | 'passkey' required
okboolean

Present for totp.

challengeIdstring

Present for sms.

dateExpiresstring

Present for sms.

allowedOriginsstring[]

Present for passkey.

relyingPartyIdstring

Present for passkey.