platform-transfers

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

Pay for a transfer and queue it for a specialist.

Authenticatie

Stuur een API-sleutel mee als bearer token. De sleutel moet over de permissie billing.payment.manage beschikken; een sleutel zonder deze permissie wordt geweigerd met een 403 in plaats van een 404.

Dit eindpunt vereist geen organisatie-id. Uw sleutel identificeert al de organisatie waartoe deze behoort, en het antwoord is hierop afgestemd.

Probeer het

Vervang alles tussen punthaakjes door uw eigen waarden en de sleutelplaatsvervanger door een sleutel uit uw dashboard.

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

Ingelogd? De API-console in je dashboard vult je echte organisatie-id en je eigen sleutel in, en voert het verzoek uit tegen de live API zodat je de daadwerkelijke respons kunt zien. Open dit eindpunt in de API-console

Details

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).

Parameters

Naam	Type	Verplicht	Wat dit is
`transferId (path)`	`string`	Ja	—

Aanvraaglichaam

Naam	Type	Verplicht	Wat dit is
`currency`	`object`	Nee	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.

Reactie

Naam	Type	Verplicht	Wat dit is
`id`	`Uuid`	Ja	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`source_platform`	`string`	Ja	—
`source_platform_name`	`string`	Nee	—
`target_platform`	`string`	Ja	—
`target_platform_name`	`string`	Nee	—
`source_url`	`string`	Ja	—
`target_site_id`	`object`	Nee	—
`tier_code`	`string`	Ja	—
`tier_name`	`string`	Nee	—
`entity_count_estimate`	`integer`	Nee	—
`status`	`PlatformTransferStatus`	Ja	—
`status_label`	`string`	Nee	—
`price_amount_minor`	`integer`	Ja	—
`price_currency`	`string`	Ja	—
`redirects_mapped`	`boolean`	Nee	—
`redirect_count`	`integer`	Nee	—
`canonicals_verified`	`boolean`	Nee	—
`sitemap_submitted`	`boolean`	Nee	—
`structured_data_preserved`	`boolean`	Nee	—
`seo_checks_complete`	`boolean`	Nee	—
`customer_note`	`string`	Nee	—
`sla_due_at`	`object`	Nee	—
`created_at`	`string`	Ja	—
`completed_at`	`object`	Nee	—
`events`	`PlatformTransferEvent[]`	Nee	The customer-visible trail only. Staff notes name vendors and what a job cost us, and never appear here.

Fouten die dit eindpunt kan retourneren

401 · 403 · 404 · 422 · 429

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