platform-transfers

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

Pay for a transfer and queue it for a specialist.

Tüm platform-transfers uç noktaları

Tüm geliştirici belgeleri

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: the remedy is to choose a payment method (getPaymentOptions lists the rails this account can use) rather than to fix 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