v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB
Organization Billing

Confirm Payment Method

Confirm payment method after frontend collects it.

After Stripe Elements confirms the SetupIntent, call this endpoint to attach the payment method to the customer and enable auto-billing.

Requirements:

  • Admin permission
  • Must have called setup-payment-method first

Example:

# After Stripe Elements confirms setup
response = await client.post(
    "/v1/organizations/billing/confirm-payment-method",
    json={"payment_method_id": "pm_1ABC2DEF3GHI"}
)
post/v1/organizations/billing/confirm-payment-method

Request body

payment_method_idstring required

Stripe PaymentMethod ID from frontend

Example request

{
  "payment_method_id": "pm_1ABC2DEF3GHI456"
}

Response

Successful Response

successboolean

Whether payment method was successfully confirmed

auto_billing_enabledboolean required

Whether auto-billing is now enabled

billing_period_startstring date-time required

When the current billing period started

Example response

{
  "payment_method": {
    "type": "card",
    "card_last4": "4242",
    "card_brand": "visa"
  }
}