Mandate API
Create Setup Session
Create a session to authorize a new Intent Mandate.
POST
When a user wants to enable payments for an AI agent, your backend creates a setup session. This endpoint returns a
setupUrl where the user will securely connect their payment method and confirm spending limits.
Headers
string
required
Your merchant identifier.
string
required
Your merchant API key.
Body
integer
required
The maximum amount the agent can spend in a single transaction, in cents (USD).
integer
required
The maximum amount the agent can spend per calendar month, in cents (USD).
string
default:"both"
The preferred settlement rail. Options are
"stripe", "base", or "both".Response
string
The unique token for this setup session.
string
The URL to redirect the user to complete the setup process.