Credit

Servers, disks and renewals are paid in advance from your personal credit. You have separate USD and IDR balances; a purchase uses one of them and they are never combined or converted. See Credit and billing.

layerbeat credit                  # your balances, and what is held for orders in progress
layerbeat transactions            # top-ups, purchases, renewals, holds and refunds
layerbeat transactions --all      # every page

Add creditCopy Anchor Link

layerbeat payment-methods                      # what you can pay with right now
layerbeat topup 25                             # USD with USDC on Solana (the default)
layerbeat topup 400000 --method doit --payment-option qris    # IDR with QRIS
layerbeat topup 400000 --method doit --payment-option va:bca  # IDR by bank transfer

topup prints exact payment instructions: the address and amount to send, or the QRIS code or account number to pay. Credit is added once the payment is confirmed:

layerbeat payments                 # your top-ups
layerbeat payment pay_...          # one top-up
layerbeat payment pay_... --refresh   # ask the payment provider again

Top-ups started with an API key need the billing:write scope and add to the personal credit of the key's creator.

Let an agent payCopy Anchor Link

With --pay, the top-up is paid right away from an agent wallet on this computer, instead of printing instructions:

layerbeat topup 25 --pay x402 --yes   # USDC on Solana, paid with pay (pay.sh)
layerbeat topup 25 --pay mpp --yes    # USDC.e on Tempo, paid with mppx

Install the payer first: brew install pay then pay setup, or npm install -g mppx with a Tempo wallet (mppx account create, or MPPX_PRIVATE_KEY). Use --payer PATH if it isn't on your PATH.

• Your key stays in the CLI. The payer never receives your Layerbeat key. It talks to a one-time relay on 127.0.0.1, which adds the key inside the CLI and forwards only this top-up.
• The amount is capped. Before any wallet is involved, the CLI reads the offer and refuses one above the amount you asked for, plus the identifying suffix of under one cent.
• It asks first. In a terminal it asks before paying. Scripts and agents pass --yes.
• It never pays twice. Rerun with the same --idempotency-key to check on a payment that is still confirming.

The command waits for the payment to be confirmed, then prints it. See Agent payments for the protocols and for paying from your own code.