Skip to content

Start adding a payment method​

POST
/me/payment-methods/setup-intent

A Stripe SetupIntent client secret for adding a card or a US bank
account from the profile, or for connecting Link (type link: a
card-only SetupIntent the page confirms from Stripe's Link button, so
the card Link pays with is saved as a link method). Collect the method in the browser with
Stripe.js confirmSetup using clientSecret, then call
POST /me/payment-methods/sync with the SetupIntent's id. The method
is kept for later off-session payments (monthly gifts). A US bank
account is verified instantly through the donor's bank sign-in; there
are no micro-deposits.

The caller's own signed-in session only. Limited to 10 an hour per
account, on top of the per-account 100 a minute.

Authorizations​

BearerAuth

In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.

Type
HTTP (bearer)

Request Body​

application/json
JSON
{
"type": "card"
}

Responses​

The SetupIntent's client secret.

application/json
JSON
{
"data": {
"clientSecret": "seti_1Example0000_secret_Example"
}
}

Playground​

Server
Authorization
Body

Samples​

Powered by VitePress OpenAPI

Built with VitePress