latestOpenAPI 3.1.02026-08-108094177.6 KB

087dcf516ce2

External Wallet Access KYC

Submit KYC for an external wallet user

Advances the flow to register after the handoff verdict is passed and the user signed Form A with their own wallet; there is no custodial signer in this mode. UR registers the account asynchronously and delivers the fma.account.result webhook when the account activates.

post/api/v1/sumsub/kyc-submit

Headers

X-Api-Signaturestring required

Partner Auth EIP-191 signature over the canonical message plus the deadline.

X-Api-Deadlinestring required

Unix timestamp in seconds after which the signature is no longer valid.

X-Api-PublicKeystring required

Partner public key used to verify the signature.

Request body

urIdinteger required

The user's URID (NFT token id).

Response

Business result envelope. code 0 means success; business rejections return HTTP 200 with a non-zero code.

codeinteger

Business result code. 0 means success; business rejections return HTTP 200 with a non-zero code.

messagestring

Human-readable diagnostic for non-zero codes.