Skip to main content
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 in sumsub.shareToken while creating the beneficiary, never on a payout.

Before you call

Use a secret API key with treasury: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 one Idempotency-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

Authorization
string
header
required

Send the same Wayex API key as Authorization: Bearer <key>.

Headers

Idempotency-Key
string
required

A unique key for this logical action. Reuse the same key and identical payload when retrying after an unknown response.

Required string length: 8 - 255

Body

application/json
beneficiaryId
string
required
Minimum string length: 1
externalReference
string
required
Minimum string length: 1
shareToken
string
required
Required string length: 1 - 1024

Response

201 - application/json
id
string
required
Minimum string length: 1
clientId
string
required
Minimum string length: 1
beneficiaryId
string
required
Minimum string length: 1
applicantId
string
required
Minimum string length: 1
levelName
string
required
Minimum string length: 1
externalReference
string
required
Minimum string length: 1
status
enum<string>
required
Available options:
accepted,
pending,
manual_review,
rejected,
expired
checkedAt
string<date-time>
required
expiresAt
string<date-time>