billing

POST `/v1/payment-methods`

Begin adding a payment method (on-session).

Аутентификация

Отправьте ключ API в качестве токена носителя (bearer token). Ключ должен иметь разрешение billing.payment.manage; ключ без него отклоняется с кодом 403, а не 404.

Идентификатор вашей организации

Этот эндпоинт принимает org_id в качестве поля в теле JSON.

Идентификатор вашей организации находится на экране ключей API в вашей панели управления, рядом с самим ключом. Это один и тот же идентификатор для каждого вашего запроса.

Попробовать

Замените всё в угловых скобках на собственные значения, а плейсхолдер ключа — на ключ из вашей панели управления.

curl -X POST https://api.zinndigital.com/v1/payment-methods \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

Вошли в систему? Консоль API в вашей панели управления автоматически подставляет реальный идентификатор вашей организации и ваш собственный ключ, а также выполняет запрос к работающему API, чтобы вы могли увидеть актуальный ответ. Откройте эту конечную точку в API-консоли

Подробнее

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.

Тело запроса

Имя	Тип	Обязательно	Что это
`org_id`	`string`	Нет	Organization to attach the mandate to. The caller must hold `billing.payment.manage` in that organization.

Ответ

Имя	Тип	Обязательно	Что это
`setup_intent_id`	`string`	Да	—
`client_secret`	`string`	Да	—

Ошибки, которые может возвращать этот эндпоинт

401 · 403 · 422 · 429