Sign in
latestOpenAPI 3.1.02026-08-108094177.6 KB

087dcf516ce2

Managed Custody KYC

Sign Form A

UR's TurnKey wallet signs Form A on the user's behalf after the user consented in your UI; you prove that authorization by echoing the textHash from form-a-info. Returns FORMA_TEXT_MISMATCH (code 20005) if the stored text changed since the last render; re-call form-a-info and resign with the new hash. The returned state stays SignFormA; only submit advances the session.

post/api/fma/v1/kyc/sign-form

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

sessionIdstring required

The onboarding session UUID returned by create-account.

textHashstring required

The textHash from the latest form-a-info render. Must match the current render or the call fails with FORMA_TEXT_MISMATCH (code 20005).

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.