billing

POST `/v1/payment-methods`

Begin adding a payment method (on-session).

Autentizace

Zašlete API klíč jako nosný token (bearer token). Klíč musí mít oprávnění billing.payment.manage; klíč bez něj je odmítnut s kódem 403, nikoli 404.

Sem patří ID vaší organizace

Tento koncový bod přijímá org_id jako pole v těle JSON.

ID vaší organizace najdete na obrazovce API klíčů ve vašem přehledu, hned vedle samotného klíče. Je to stále stejné ID v každém volání, které provedete.

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/payment-methods \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

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

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.

Tělo požadavku

Název	Typ	Požadováno	Co to je
`org_id`	`string`	Ne	Organization to attach the mandate to. The caller must hold `billing.payment.manage` in that organization.

Odpověď

Název	Typ	Požadováno	Co to je
`setup_intent_id`	`string`	Ano	—
`client_secret`	`string`	Ano	—

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

401 · 403 · 422 · 429