Hermos API

Start a card update for one subscription (customer billing session)

Customer sessions with the update_payment_method flow only. Creates a processor card-entry Session for this subscription; nothing is charged. A 409 setup_attempt_superseded means a newer attempt exists; its details name the newest attempt and whether this sheet made it.

POST/subscriptions/{subscription}/payment_method_setups

Customer sessions with the update_payment_method flow only. Creates a processor card-entry Session for this subscription; nothing is charged. A 409 setup_attempt_superseded means a newer attempt exists; its details name the newest attempt and whether this sheet made it.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

subscription*string

Opaque subscription ID.

Match^sbs_[0-7][0-9abcdefghjkmnpqrstvwxyz]{25}$(?![\s\S])

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/subscriptions/string/payment_method_setups" \  -H "Content-Type: application/json" \  -d '{    "seen_attempt": 0,    "sheet_id": "90db66ec-6a25-4d34-a966-efba30db59e0"  }'
{  "request_id": "266ea41d-adf5-480b-af50-15b940c2b846",  "livemode": true,  "id": "string",  "attempt": 1,  "client_secret": "string",  "stripe_account": "string",  "expires_at": "string",  "overdue": true}