v1

latestOpenAPI 3.1.02026-08-042453938.9 KB

Customers

Provision smart account

Deploy an ERC-4337 smart account for a customer and deposit USDC into the BillingModule.

On testnet (Base Sepolia), this automatically mints and deposits test USDC. On mainnet, the customer must deposit USDC separately after deployment.

The smart account is owned by the billing authority for server-side management. Requires a secret key (sk_*).

post/v1/customers/{id}/provision

idstring required

Customer ID

deposit_amount_usdcstring

USDC amount to deposit into BillingModule (testnet only, default: "100")

Smart account provisioned

smart_account_addressstring

already_deployedboolean

deploy_tx_hashstring nullable

fund_tx_hashstring nullable

billing_deposit_tx_hashstring nullable

billing_balance_usdcstring

funding_requiredboolean

True when the customer must fund their account via checkout (mainnet)