platform-transfers

POST `/v1/platform-transfers/{transferId}/pay`

Pay for a transfer and queue it for a specialist.

Doğrulama

API açarını bearer token kimi göndərin. Açar billing.payment.manage icazəsinə malik olmalıdır; bu icazəsi olmayan açar 404 deyil, 403 xətası ilə rədd edilir.

Bu endpoint heç bir təşkilat ID-si tələb etmir. Sizin açarınız artıq aid olduğu təşkilatı müəyyən edir və cavab həmin təşkilat üçün məhdudlaşdırılır.

Sınaqdan keçir

Bucaqlı mötərizələrdə olan hór şeyi öz qiymətlərinizlə, açar yertutucusunu isə idarə panelinizdən bir açarla əvəz edin.

curl -X POST https://api.zinndigital.com/v1/platform-transfers/{transferId}/pay \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

Sistemə daxil olmusunuz? İdarə panelinizdəki API konsolu real təşkilatınızın identifikatorunu və öz açarınızı avtomatik doldurur, sorğunu canlı API-yə qarşı icra edir ki, siz faktiki cavabı görə biləsiniz. Bu son nöqtəni API konsolunda açın

Təfərrüatlar

Charges the tier through the extras rails — wallet first, then the gateway — and moves the transfer to `queued` with its SLA set. Requires `billing.payment.manage`, because it moves money; creating the draft needs only `billing.view`. A decline returns `422` and leaves the transfer in `payment_failed`; nothing is charged and the same transfer can be paid again with another method. An organization with **no** chargeable payment method gets `422` `PAYMENT_METHOD_REQUIRED` instead — nothing was presented to a gateway, so it is not a decline and the remedy is to add a card (`docs/491` §7).

Parametrlər

Ad	Tip	Tələb olunur	Nədir
`transferId (path)`	`string`	Bəli	—

Sorğu gövdəsi

Ad	Tip	Tələb olunur	Nədir
`currency`	`object`	Xeyr	The currency the customer was quoted in. Refused if no gateway can charge it — silently substituting the base currency would bill a different number from the one on the screen.

Cavab

Ad	Tip	Tələb olunur	Nədir
`id`	`Uuid`	Bəli	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`source_platform`	`string`	Bəli	—
`source_platform_name`	`string`	Xeyr	—
`target_platform`	`string`	Bəli	—
`target_platform_name`	`string`	Xeyr	—
`source_url`	`string`	Bəli	—
`target_site_id`	`object`	Xeyr	—
`tier_code`	`string`	Bəli	—
`tier_name`	`string`	Xeyr	—
`entity_count_estimate`	`integer`	Xeyr	—
`status`	`PlatformTransferStatus`	Bəli	—
`status_label`	`string`	Xeyr	—
`price_amount_minor`	`integer`	Bəli	—
`price_currency`	`string`	Bəli	—
`redirects_mapped`	`boolean`	Xeyr	—
`redirect_count`	`integer`	Xeyr	—
`canonicals_verified`	`boolean`	Xeyr	—
`sitemap_submitted`	`boolean`	Xeyr	—
`structured_data_preserved`	`boolean`	Xeyr	—
`seo_checks_complete`	`boolean`	Xeyr	—
`customer_note`	`string`	Xeyr	—
`sla_due_at`	`object`	Xeyr	—
`created_at`	`string`	Bəli	—
`completed_at`	`object`	Xeyr	—
`events`	`PlatformTransferEvent[]`	Xeyr	The customer-visible trail only. Staff notes name vendors and what a job cost us, and never appear here.

Bu son nöqtənin qaytara biləcəyi xətalar

401 · 403 · 404 · 422 · 429

POST /v1/platform-transfers/{transferId}/pay