platform-transfers

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

Pay for a transfer and queue it for a specialist.

Ҳамаи нуқтаҳои ниҳоии platform-transfers

Ҳамаи ҳуҷҷатҳои таҳиякунандагон

Санҷиши ҳаққоният

Kaliti API-ро ҳамчун рамзи доранда (bearer token) фиристед. Калит бояд дорои иҷозати billing.payment.manage бошад; калиди бидуни он бо хатои 403 рад карда мешавад, на 404.

Ин нуқтаи поёнӣ ягон рақами мушаххаси созмонро талаб намекунад. Калиди шумо аллакай созмонеро, ки ба он тааллуқ дорад, муайян мекунад ва ҷавоб ба он маҳдуд карда мешавад.

Санҷидан

Ҳар чизро дар қаavски кунҷӣ бо қиматҳои худ ва ҷойи нигоҳдорандаи калидро бо калима аз панели идоракунии худ иваз кунед.

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

Воarid шудаед? Консоли API дар панели идоракунии шумо рақами мушаххаси ташкилоти воқеӣ ва калиди худро пур мекунад ва дархостро бар зидди API-и фаъол иҷро мекунад, то шумо посухи воқеиро бубинед. Ин нуқтаи ниҳоиро дар консоли API кушоед

Тафсилот

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

Параметрҳо

НомНамудТалаб карда мешавадИн чӣ аст
transferId (path)stringБале

Ҷисми дархост

НомНамудТалаб карда мешавадИн чӣ аст
currencyobjectНе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.

Ҷавоб

НомНамудТалаб карда мешавадИн чӣ аст
idUuidБалеUUIDv7 identifier — sortable by creation time (docs/02 §8).
source_platformstringБале
source_platform_namestringНе
target_platformstringБале
target_platform_namestringНе
source_urlstringБале
target_site_idobjectНе
tier_codestringБале
tier_namestringНе
entity_count_estimateintegerНе
statusPlatformTransferStatusБале
status_labelstringНе
price_amount_minorintegerБале
price_currencystringБале
redirects_mappedbooleanНе
redirect_countintegerНе
canonicals_verifiedbooleanНе
sitemap_submittedbooleanНе
structured_data_preservedbooleanНе
seo_checks_completebooleanНе
customer_notestringНе
sla_due_atobjectНе
created_atstringБале
completed_atobjectНе
eventsPlatformTransferEvent[]НеThe customer-visible trail only. Staff notes name vendors and what a job cost us, and never appear here.

Хатоҳое, ки ин нуқтаи ниҳоӣ метавонад баргардонад

401 · 403 · 404 · 422 · 429