Docs/Billing/Build the payment transaction

Build the payment transaction

POST/v1/billing/pay-tx🔑 API key required

Returns an UNSIGNED USDC-transfer transaction for your plan's amount, tagged with a tenant-bound reference. Your wallet signs and sends it.

Body

FieldTypeDescription
walletrequiredstringThe Solana wallet that will pay (base58).

Response fields

FieldTypeDescription
txstringBase64 unsigned VersionedTransaction — deserialize and signAndSend with your wallet.
amountUsdcnumberUSDC the transfer moves to the treasury.
referencestringSolana-Pay reference key embedded in the transfer (how /confirm finds it).
treasurystringThe USDC receiver.
alreadyPaidbooleanIf a prior payment already landed, true — you're activated, no need to pay again.
503 billing_not_configured if on-chain billing isn't set up on this instance. Re-calling reuses a still-pending reference so an in-flight transfer is never orphaned.