marketplace
POST /v1/marketplace/vendor/payout-methods/confirm
Confirm a PayPal or crypto payout e-mail from the link we sent to it.
Authentication
Send an API key as a bearer token. This endpoint checks no specific permission, so any key for your organisation can call it.
This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.
Try it
Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.
curl -X POST https://api.zinndigital.com/v1/marketplace/vendor/payout-methods/confirm \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "token": <string> }'Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console
Details
The seller page calls this with the payout_confirm token from the e-mailed link. Verifies the destination and starts its cooling-off (48 hours; 72 for crypto). Scoped to the signed-in seller — a forwarded link confirms nothing on another account. The link expires after 48 hours (LINK_EXPIRED).
Request body
| Name | Type | Required | What it is |
|---|---|---|---|
token | string | Yes | — |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
id | string | Yes | — |
rail | string | Yes | — |
rail_name | string | Yes | — |
destination | string | Yes | ⛔ Masked, always. Enough to recognise which account this is, never enough to reproduce it. The whole value never leaves the engine on a read path. |
network | string | Yes | ⛔ Its own field, never folded into the address. Sending USDT TRC20 to a BEP20 address loses the money irrecoverably (docs/82 §7b), so the network is part of the destination's… |
label | string | Yes | — |
state | MarketplacePayoutMethodState | Yes | Where one destination is in its own verification (docs/82 §7c). retired rows are kept rather than deleted — a payout that went there is explained by them. unsupported is a… |
proof_kind | MarketplacePayoutProofKind | Yes | How ownership of the destination was shown. ⛔ Crypto is the honest exception and is recorded as one: docs/82 §7c states that no document can prove wallet ownership, so a signed… |
rejection_reason | string | No | — |
is_default | boolean | Yes | — |
verified_at | string | No | — |
hold_until | string | No | docs/82 §7c's 48-hour cooling-off on the first payout to this destination — long enough for the change notice to land, short enough that a seller who genuinely changed bank… |
permitted_proof_kinds | MarketplacePayoutProofKind[] | Yes | — |
country | string | No | The bank account's country (bank destinations set up through Stripe). |
awaiting_email_link | boolean | No | True when the seller's next step is opening the link we e-mailed. |
Errors this endpoint can return
401 · 404 · 422