latestOpenAPI 3.1.02026-08-108094177.6 KB
087dcf516ce2
Managed Custody Mode
Verify reference
Validate a new payment reference for an existing recent contact and get a fresh refId and purposeId to use in the payout submission.
post/api/fma/v1/verify-reference
Headers
X-Api-Signaturestring required
0x-prefixed 65-byte hex EIP-191 signature over the Partner Auth message. See the Signature and verify guide.
X-Api-Deadlinestring required
Unix seconds. UR rejects the request when the current time is past the deadline. Keep the validity window at or under 5 minutes.
X-Api-PublicKeystring required
0x-prefixed partner signer address registered with UR.
X-Ur-Idstring
Send at least one of X-Ur-Id or X-External-User-Id. When both are present, UR resolves the user by X-Ur-Id first.
X-External-User-Idstring
Send at least one of X-Ur-Id or X-External-User-Id. When both are present, UR resolves the user by X-Ur-Id first.
Request body
Response
Standard envelope. Business errors return HTTP 200 with a non-zero code.