commerce

GET `/v1/payment-options`

The payment rails a purchase in this currency may be settled on.

Hitelesítés

Küldjön egy API-kulcsot bearer tokenként. Ez a végpont nem határoz meg konkrét jogosultságot a specifikációban, ezért adja meg a kulcsnak a legkevesebbet, amire szüksége van, és a feltételezés helyett ellenőrizze a választ.

A szervezet azonosítójának helye

Ez a végpont a(z) org_id paramétert lekérdezési paraméterként várja. Hagyja ki, ha a hívás az Ön teljes bérlői részfáját lefedje; küldje el a hívás egyetlen szervezetre történő szűkítéséhez.

A szervezeted azonosítója a vezérlőpult API-kulcsok képernyőjén található, közvetlenül a kulcs mellett. Ez ugyanaz az azonosító minden indított hívásban.

Próbálja ki

Cserélje ki a hegyes zárójelek közötti részt a saját értékeivel, a kulcshelyőrzőt pedig a vezérlőpultján található kulccsal.

curl -X GET https://api.zinndigital.com/v1/payment-options?currency=<currency> \
  -H "Authorization: Bearer zdk_live_…"

Be van jelentkezve? A vezérlőpultban lévő API-konzol kitölti a valós szervezetazonosítóját és a saját kulcsát, és a kérést az éles API-n futtatja, hogy láthassa a tényleges választ. Nyissa meg ezt a végpontot az API konzolban

Részletek

What the checkout screen offers before anything is bought, so a customer picks how to pay instead of discovering after the fact that only a card was tried. Filtered exactly as getOrderPaymentOptions is, by the same function: a rail the operator has switched off is absent; a rail that cannot present currency is absent (PayPal presents 24 currencies and Indonesian rupiah is not among them); and a reseller's client receives exactly one entry — their reseller's connected gateway — because that is the only merchant account their money may land in. A customer who is suspended or overdue is deliberately not filtered: paying us is how an account stops being suspended. checkoutCart refuses any gateway that is not in this list, so the picker and the charge path read one source.

Paraméterek

Név	Típus	Kötelező	Mi ez
`currency (query)`	`CurrencyCode`	Igen	ISO 4217 code the purchase is priced in.
`org_id (query)`	`Uuid`	Nem	The organization buying. Omit it and the engine uses the one organization where you hold `billing.payment.manage`, and refuses when you hold it in more than one — guessing which…

Válasz

Név	Típus	Kötelező	Mi ez
`gateways`	`string[]`	Igen	Provider codes (`stripe`, `paypal`, `nowpayments`). Never empty — `stripe` is always present, because an unreadable provider registry must not be reported as "nothing is enabled".

Hibák, amelyeket ez a végpont visszaadhattatlan

401 · 403 · 404 · 422 · 429