commerce

POST /v1/orders/{orderId}/paypal/capture

Capture a PayPal order the buyer completed.

Všechny koncové body commerce

Autentizace

Odešlete klíč API jako bearer token. Tento koncový bod ve specifikaci uvádí specifické oprávnění, takže svému klíči udělte to nejmenší možné a místo předpokladů zkontrolujte odpověď.

Tento koncový bod nevyžaduje žádné ID organizace. Váš klíč již identifikuje organizaci, ke které patří, a odpověď je na ni omezena.

Vyzvednout

Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.

curl -X POST https://api.zinndigital.com/v1/orders/{orderId}/paypal/capture \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "paypal_order_id": <string> }'

Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API

Podrobnosti

Settles the order against a PayPal order the buyer has approved (wallet) or paid by card (including any 3-D Secure step). ⛔ **The browser is not believed.** It reports that the buyer finished; only PayPal's capture response says money moved, and only the engine writes a payment. Posting an invented `paypal_order_id` produces a gateway error, never a paid order. A **declined card answers 200** with the order `payment_failed`, for the same reason `payOrder` does — the attempt was processed exactly as asked.

Parametry

NázevTypPožadovánoCo to je
orderId (path)UuidAnoThe order's id.

Tělo požadavku

NázevTypPožadovánoCo to je
paypal_order_idstringAnoThe id returned by `openPayPalOrder` and completed in the browser.

Odpověď

NázevTypPožadovánoCo to je
idUuidAnoUUIDv7 identifier — sortable by creation time (docs/02 §8).
org_idUuidAnoUUIDv7 identifier — sortable by creation time (docs/02 §8).
human_refstringAnoHuman-friendly order reference.
statusOrderStatusAnoAn order's lifecycle state (docs/31 §4.3).
currencyCurrencyCodeAnoISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8).
subtotal_minorintegerAno
tax_minorintegerAno
discount_minorintegerAno
total_minorintegerAno
billing_countryobjectNe
placed_atobjectNe
created_atstringAno
updated_atstringNe
linesOrderLine[]Ano
paymentsPayment[]Ano

Chyby, které může tento koncový bod vrátit

401 · 403 · 404 · 422 · 429 · 503