commerce

GET `/v1/payment-options`

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

Wszystkie dokumentacje dla programistów →

Uwierzytelnianie

Wyślij klucz API jako token bearer. Ten punkt końcowy nie określa konkretnego uprawnienia w specyfikacji, więc nadaj swojemu kluczowi minimum potrzebnych uprawnień i sprawdź odpowiedź zamiast zakładać.

Miejsce na identyfikator organizacji

Ten punkt końcowy przyjmuje org_id jako parametr zapytania. Pomiń go, a wywołanie obejmie całe drzewo dzierżawy; prześlij go, aby ograniczyć wywołanie do jednej organizacji.

Identyfikator Twojej organizacji znajduje się na ekranie kluczy API w Twoim panelu, obok samego klucza. Jest to ten sam identyfikator w każdym wywołaniu, które wykonujesz.

Wypróbuj

Zastąp wszystko w nawiasach ostrych własnymi wartościami, a zastępczy znacznik klucza kluczem ze swojego pulpitu nawigacyjnego.

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

Zalogowany? Konsola API w Twoim panelu uzupełnia rzeczywiste identyfikator organizacji oraz Twój własny klucz i wykonuje żądanie względem aktywnego API, dzięki czemu możesz zobaczyć rzeczywistą odpowiedź. Otwórz ten punkt końcowy w konsoli API

Szczegóły

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.

Parametry

Nazwa	Typ	Wymagane	Co to jest
`currency (query)`	`CurrencyCode`	Tak	ISO 4217 code the purchase is priced in.
`org_id (query)`	`Uuid`	Nie	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…

Odpowiedź

Nazwa	Typ	Wymagane	Co to jest
`gateways`	`string[]`	Tak	Provider codes (`stripe`, `paypal`, `nowpayments`). Never empty — `stripe` is always present, because an unreadable provider registry must not be reported as "nothing is enabled".

Błędy, które ten punkt końcowy może zwrócić

401 · 403 · 404 · 422 · 429