Submit optional reusable identity evidence
Treasury resource management
Submit optional reusable identity evidence
Validates a single-use Sumsub share token and binds the reusable accepted evidence result to one beneficiary.
POST
Submit optional reusable identity evidence
What this endpoint does
Validates a single-use Sumsub share token and binds the reusable accepted evidence result to one beneficiary.When to use it
Use it only to add evidence to an existing beneficiary. The normal flow submits the token insumsub.shareToken while creating the beneficiary, never on a payout.
Before you call
Use a secret API key withtreasury:write. The beneficiary must belong to this tenant account and the fresh single-use token must match that beneficiary.
Money and balance effect
Evidence validation does not reserve or move wallet money.States and completion
Accepted evidence can later satisfy payout policy until it expires. Invalid, mismatched, rejected, or unavailable evidence is never silently ignored.Safe retries
The share token is single-use. Send oneIdempotency-Key, then retry the exact request with the same key after a lost response so Wayex replays the result rather than validating the token again.
Read Beneficiaries and payouts for the complete workflow.Authorizations
Send the same Wayex API key as Authorization: Bearer <key>.
Headers
A unique key for this logical action. Reuse the same key and identical payload when retrying after an unknown response.
Required string length:
8 - 255Body
application/json
Response
201 - application/json
Minimum string length:
1Minimum string length:
1Minimum string length:
1Minimum string length:
1Minimum string length:
1Minimum string length:
1Available options:
accepted, pending, manual_review, rejected, expired 
