Skip to main content
POST
Payment intents
Payment intent routes are used by gateway surfaces that reserve a budget before work and settle the final metered amount after work. Amounts are USDC atomic units with 6 decimals.

Routes

Prepare body

string
required
Service namespace, such as agent, workflow, or inference.
string
required
Action name within the service.
string
required
Resource URL or identifier being paid for.
string
required
HTTP method being paid for.
string
Maximum authorized USDC atomic amount.
object
Metered settlement shape: subject plus lineItems.
string
Optional caller run ID.
string
Optional caller idempotency key.

Headers

string
required
Bearer compose-....
number
required
Chain ID used for the payment intent.

Meter body

string
required
Public catalog model ID.
string
Optional provider override for exact provider billing resolution.
string
required
Output modality to bill.
object
Token or provider usage metadata.
object
Media evidence for image, audio, video, or other non-token billing.