Add payment method
Start hosted card or bank enrollment for an immutable payment request from a thread. Check GET /v2/account/payment-method-setups/ for verified completion before using a saved method. This setup does not charge or settle the request. Standalone enrollment without a request is not available yet.
POST
Add payment method
This account operation requires a user-authorized
human:actions OAuth grant. It has no personal AI ID in its public path. Enrollment is bound to an immutable payment request and requires explicit save consent. The hosted provider collects card or bank details; this API never accepts them. A verified method can be listed under Account → Personal, but enrollment itself does not charge or settle the request.
A standalone setup without a thread request is not available yet. This integration remains release-gated until account ownership migration and live provider verification are complete.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
An immutable payment request from an account-owned thread.
Required string length:
1 - 200Pattern:
^[A-Za-z0-9_-]+$Funding method to enroll through the hosted provider.
Available options:
card, bank Explicit permission to save the verified method.
Allowed value:
"save_payment_method"Required string length:
1 - 200Pattern:
^[A-Za-z0-9][A-Za-z0-9_.:-]*$Response
Authorized account metadata only.
Required string length:
1 - 200Pattern:
^[A-Za-z0-9_-]+$Available options:
prepared, dispatching, awaiting_user, processing, verified, failed, expired, cancelled Required range:
0 <= x <= 9007199254740991Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$Required string length:
1 - 200Pattern:
^[A-Za-z0-9_-]+$Last modified on October 5, 2026