billing

POST `/v1/payment-methods`

Begin adding a payment method (on-session).

Hitelesítés

Küldjön egy API-kulcsot bearer tokenként. A kulcsnak rendelkeznie kell a(z) billing.payment.manage jogosultsággal; az ezzel nem rendelkező kulcsok esetén a rendszer 403-as hibát ad vissza 404 helyett.

A szervezet azonosítójának helye

Ez a végpont a org_id mezőt várja a JSON törzsben.

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 POST https://api.zinndigital.com/v1/payment-methods \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

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

Opens a gateway SetupIntent and returns its short-lived client_secret for the browser SDK to confirm, completing 3-D Secure there. No payment method is created by this call — a mandate is consent, and the row is written only when the gateway confirms it on its webhook (ADR 0011 §3). Requires billing.payment.manage in the target organization.

Kérés törzse

Név	Típus	Kötelező	Mi ez
`org_id`	`string`	Nem	Organization to attach the mandate to. The caller must hold `billing.payment.manage` in that organization.

Válasz

Név	Típus	Kötelező	Mi ez
`setup_intent_id`	`string`	Igen	—
`client_secret`	`string`	Igen	—

Hibák, amelyeket ez a végpont visszaadhattatlan

401 · 403 · 422 · 429