marketplace

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

Show that the destination belongs to you.

المصادقة

أرسل مفتاح واجهة برمجة التطبيقات (API) كرمز حامل (bearer token). لا يحدد نقطة النهاية هذه إذنًا محددًا في المواصفات، لذا امنح مفتاحك الحد الأدنى الذي محتاجه وتحقق من الاستجابة بدلاً من الافتراض.

لا يقبل هذا الطرف أي معرف للمؤسسة. يحدد مفتاحك بالفعل المؤسسة التي ينتمي إليها، وتكون الاستجابة محصورة في نطاقها.

جربه الآن

استبدل أي شيء بين أقواس زاوية بقيمك الخاصة، والعنصر النائب للمفتاح بمفتاح من لوحة تحكمك.

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> }'

هل سجلت الدخول؟ تقوم وحدة تحكم واجهة برمجة التطبيقات في لوحة التحكم الخاصة بك بربط معرف مؤسستك الحقيقي ومفتاحك الخاص، وتنفذ الطلب مقابل واجهة برمجة التطبيقات المباشرة لتتمكن من رؤية الاستجابة الفعلية. افتح هذه النهاية الطرفية في وحدة تحكم API

التفاصيل

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.

المعلمات

الاسم	النوع	مطلوب	ما هو هذا
`method_id (path)`	`string`	نعم	—

جسم الطلب

الاسم	النوع	مطلوب	ما هو هذا
`proof_kind`	`MarketplacePayoutProofKind`	نعم	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`	لا	Required when the proof is a document.
`proof_reference`	`string`	لا	Required for every non-document proof — the signed message, the transaction, or the account to check.

الاستجابة

الاسم	النوع	مطلوب	ما هو هذا
`id`	`string`	نعم	—
`rail`	`string`	نعم	—
`rail_name`	`string`	نعم	—
`destination`	`string`	نعم	⛔ 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`	نعم	⛔ 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`	نعم	—
`state`	`MarketplacePayoutMethodState`	نعم	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`	نعم	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`	لا	—
`is_default`	`boolean`	نعم	—
`verified_at`	`string`	لا	—
`hold_until`	`string`	لا	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[]`	نعم	—

الأخطاء التي يمكن أن تُرجعها نقطة النهاية هذه

401 · 404 · 422

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