platform-transfers

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

Pay for a transfer and queue it for a specialist.

Tüm platform-transfers uç noktaları

Kimlik Doğrulama

Bearer token olarak bir API anahtarı gönderin. Anahtar billing.payment.manage iznine sahip olmalıdır; bu izne sahip olmayan bir anahtar 404 ile değil, 403 ile reddedilir.

Bu uç nokta hiçbir organizasyon kimliği almaz. Anahtarınız zaten ait olduğu organizasyonu tanımlar ve yanıt bu organizasyonla sınırlandırılır.

Dene

Köşeli parantez içindeki her şeyi kendi değerlerinizle ve anahtar yer tutucusunu panonuzdan bir anahtarla değiştirin.

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

Oturum açtınız mı? Panonuzdaki API konsolu, gerçek organizasyon kimliğinizi ve kendi anahtarınızı otomatik olarak doldurur ve isteği canlı API üzerinde çalıştırarak gerçek yanıtı görmenizi sağlar. Bu uç noktayı API konsolunda açın

Ayrıntılar

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

Parametreler

AdTürZorunluNe olduğu
transferId (path)stringEvet

İstek gövdesi

AdTürZorunluNe olduğu
currencyobjectHayırThe 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.

Yanıt

AdTürZorunluNe olduğu
idUuidEvetUUIDv7 identifier — sortable by creation time (docs/02 §8).
source_platformstringEvet
source_platform_namestringHayır
target_platformstringEvet
target_platform_namestringHayır
source_urlstringEvet
target_site_idobjectHayır
tier_codestringEvet
tier_namestringHayır
entity_count_estimateintegerHayır
statusPlatformTransferStatusEvet
status_labelstringHayır
price_amount_minorintegerEvet
price_currencystringEvet
redirects_mappedbooleanHayır
redirect_countintegerHayır
canonicals_verifiedbooleanHayır
sitemap_submittedbooleanHayır
structured_data_preservedbooleanHayır
seo_checks_completebooleanHayır
customer_notestringHayır
sla_due_atobjectHayır
created_atstringEvet
completed_atobjectHayır
eventsPlatformTransferEvent[]HayırThe customer-visible trail only. Staff notes name vendors and what a job cost us, and never appear here.

Bu uç noktanın dönderebileceği hatalar

401 · 403 · 404 · 422 · 429