latestOpenAPI 3.1.02026-08-108094177.6 KB

087dcf516ce2

Managed Custody KYC

Hand off a Sumsub share token

Submits a single-use Sumsub share token minted in your tenant for UR's clientId. UR copies the applicant into its own Sumsub tenant, validates the copied data, and returns a conclusive verdict synchronously; UR does not re-run the KYC checks. Requires an onboarding session created by create-account and a GREEN applicant in your tenant. The envelope code is authoritative: passed maps to 0, incomplete to 20004, and terminal verdicts to eligibility codes 30010 to 30012.

post/api/fma/v1/kyc/reuse-share-token

Headers

X-Ur-Idstring

The user's URID. Send at least one of X-Ur-Id or X-External-User-Id.

X-External-User-Idstring

Your partner-side user id. Send at least one of X-Ur-Id or X-External-User-Id.

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

shareTokenstring required

Single-use Sumsub share token minted in your tenant with forClientId set to UR's clientId, valid for about 20 minutes. Mint a fresh token for every handoff attempt.

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.