latestOpenAPI 3.1.02026-08-108094177.6 KB

087dcf516ce2

External Wallet Access KYC

Create a Sumsub access token by network

Creates a Sumsub access token for External Wallet Access Mode users whose URID NFT lives on an external network. UR issues the token only after an on-chain ownership check: walletProvider(tokenId) on the account contract of the requested network must equal the calling partner's id. The token TTL is fixed at 20 minutes server-side.

post/v1/create-access-token-by-network

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

tokenIdstring required

URID NFT token id.

networkstring required

Network or chain identifier, for example 5000 or 11155111.

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.