marketplace

POST `/v1/marketplace/vendor/payout-methods/{method_id}`

Show that the destination belongs to you.

Pengesahan

Hantar kunci API sebagai token pembawa. Titik akhir ini tidak menyatakan kebenaran tertentu dalam spesifikasi, jadi berikan kunci anda kebenaran minimum yang diperlukan dan semak respons tersebut daripada membuat andaian.

Titik akhir ini tidak memerlukan id organisasi. Kunci anda telah mengenal pasti organisasi kepunyaannya, dan respons dis skopkan kepadanya.

Cuba

Gantikan apa sahaja di dalam kurungan sudut dengan nilai anda sendiri, dan pemegang tempat kunci dengan kunci dari papan pemuka anda.

curl -X POST https://api.zinndigital.com/v1/marketplace/vendor/payout-methods/{method_id} \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "proof_kind": <MarketplacePayoutProofKind> }'

Sudah log masuk? Konsol API dalam papan pemuka anda mengisi id organisasi sebenar dan kunci anda sendiri, serta menjalankan permintaan terhadap API langsung supaya anda boleh melihat respons sebenar. Buka penamat ini dalam konsol API

Butiran

docs/82 §7c's proof table, as data. What is accepted depends on the rail: a statement or letter for a bank or Payoneer, the verified account email for PayPal, and for crypto a signed message, a micro-transaction, or a self-declared address — *"No document can prove wallet ownership"*, so which one was used is **recorded** rather than assumed.

Parameter

Nama	Jenis	Diperlukan	Apakah ia
`method_id (path)`	`string`	Ya	—

Badan permintaan

Nama	Jenis	Diperlukan	Apakah ia
`proof_kind`	`MarketplacePayoutProofKind`	Ya	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 signe…
`proof_document_id`	`string`	Tidak	Required when the proof is a document.
`proof_reference`	`string`	Tidak	Required for every non-document proof — the signed message, the transaction, or the account to check.

Respons

Nama	Jenis	Diperlukan	Apakah ia
`id`	`string`	Ya	—
`rail`	`string`	Ya	—
`rail_name`	`string`	Ya	—
`destination`	`string`	Ya	⛔ 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`	Ya	⛔ 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 id…
`label`	`string`	Ya	—
`state`	`MarketplacePayoutMethodState`	Ya	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.
`proof_kind`	`MarketplacePayoutProofKind`	Ya	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 signe…
`rejection_reason`	`string`	Tidak	—
`is_default`	`boolean`	Ya	—
`verified_at`	`string`	Tidak	—
`hold_until`	`string`	Tidak	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[]`	Ya	—

Ralat yang boleh dikembalikan oleh titik akhir ini

401 · 404 · 422

POST /v1/marketplace/vendor/payout-methods/{method_id}