Endpoints for managing Stripe payment methods on an affiliate's Telegra billing profile. Billing here is affiliate-to-Telegra (powered by Telegra's global Stripe account), not the affiliate's own Stripe account.
Two payment method types are supported:
| Type | Stripe type | Notes |
|---|---|---|
| Credit / debit card | card | Attach via Stripe.js confirmCardSetup or createPaymentMethod |
| US bank account (ACH) | us_bank_account | Requires the ACH SetupIntent flow (see below) |
ACH bank account flow
ACH accounts cannot be directly attached with a paymentMethodId alone. Follow these steps:
- Create a SetupIntent — call
POST /v2/affiliatePaymentMethods/ach-setup-intentto get aclientSecret - Collect bank details — on the frontend, call
stripe.collectBankAccountForSetup()with theclientSecretand confirm the SetupIntent - Register with Telegra — after the SetupIntent is confirmed, call
POST /v2/affiliatePaymentMethodswith the resultingpaymentMethodIdandpaymentMethodType: "us_bank_account"
Required role
All endpoints require one of: affiliate_super_admin, affiliate_admin, affiliate_agent