Payall CLI

A terminal tool for managing crypto debit cards funded with USDT and sending crypto on-chain. Run payall <command> from anywhere.

Setup

• - Install: npm install -g payall-cli or INLINECODE2
• Credentials: Stored encrypted at INLINECODE3

If payall is not found, install it first with the command above.

Auth Commands

Authentication uses EVM wallet private key signing. A single login call handles both registration (new wallets auto-register) and login for existing users.

CODEBLOCK0

The private key is signed locally and never sent to the server. When --key is passed, the key is automatically saved (AES-256-GCM encrypted) so subsequent wallet commands work without re-entering it.

All CLI requests include source: "payall-cli" automatically for backend analytics tracking.

Card Commands

Browsing (no auth required)

CODEBLOCK1

User Cards (auth required)

CODEBLOCK2

The --reveal --json output returns all fields an agent needs to fill payment forms:

CODEBLOCK3

The binding_id comes from the ID column in payall cards my (this is different from the card catalog ID in payall cards list).

Topping Up a Card (auth required)

CODEBLOCK4

Non-interactive flags (use all three to skip all prompts):

• - --amount <amount> / -a — USDT amount
• INLINECODE13 / -c — Deposit network: tron, bsc, INLINECODE17
• INLINECODE18 / -y — Skip confirmation

The command returns a deposit address. Send USDT to that address and the card balance updates automatically after confirmation.

Applying for a Card (auth required)

CODEBLOCK5

Non-interactive flags (use --auto-fill --chain <chain> --yes to skip all prompts):

• - --bin <card_bin> / -b — Card BIN (auto-selected if only one)
• INLINECODE23 — USD, EUR, etc. (auto-selected if only one)
• INLINECODE24 — Auto-generate cardholder info
• INLINECODE25, --last-name, --email, --phone-prefix, --phone — Manual cardholder info (all 5 required together; overrides --auto-fill)
• INLINECODE31 / -c — Deposit chain: tron, bsc, INLINECODE35
• INLINECODE36 / -y — Skip all confirmations

Temporarily Unavailable Cards

Do NOT proceed with applying for MiPay or Bit2Go HK/UK cards. If a user requests to open any of these cards, inform them: "This service is temporarily not working. Please try again later." Do not attempt the apply command or suggest workarounds.

Cards that support API application:

• - 23 = Bit2Go (Visa/Mastercard, multi-currency, no KYC) — TEMPORARILY UNAVAILABLE
• 39 = MiPay Universal Card (USD only, no KYC) — TEMPORARILY UNAVAILABLE

Before applying, always run payall cards apply <card_id> which checks eligibility first. If can_apply = 0, the card can only be opened via its website — direct the user there and provide the URL. Don't retry or attempt workarounds. When mentioning this, frame it positively: "You can apply for cards 23 and 39 directly here, and for other cards you can sign up on their website."

Withdrawing from a Card (auth + wallet key required)

Withdraw card balance to USDT in your wallet. Only Bit2Go cards (card_id=23) support withdrawal.

CODEBLOCK6

Non-interactive flags:

• - --amount <amount> / -a — USDT amount (must be > 2)
• INLINECODE42 / -c — Payout network: tron, bsc, INLINECODE46
• INLINECODE47 — Destination wallet (defaults to user's own wallet)
• INLINECODE48 / -y — Skip confirmation
• INLINECODE50 — JSON output (for agents)

The command requires a saved wallet key (uses it to sign the withdrawal confirmation). Network fees: $1.50 for TRON, $1.00 for BSC/ETH.

Wallet Commands (auth required)

On-chain wallet operations. The same private key derives addresses on all chains (BSC/ETH share the same 0x address; TRON derives a T... address).

If no saved key is found, wallet commands prompt for the private key interactively and offer to save it. For agents, ensure the key is saved first via payall auth login --key <key>.

CODEBLOCK7

Flags for wallet send:

• - --to <address> — 0x... (40 hex chars) for EVM, T... (34 chars, Base58) for TRON
• INLINECODE56 — USDT amount
• INLINECODE57 — bsc, eth, or INLINECODE60
• INLINECODE61 — Skip confirmation

TRON transfers require TRX for energy/bandwidth fees. The CLI checks for non-zero TRX balance before sending and sets a 15 TRX fee limit. If a send fails, the CLI prints manual transfer instructions.

Agent Workflows

Automated Topup

This is the most common agent task — topping up a user's card by sending USDT from their wallet to a deposit address.

CODEBLOCK8

Chain selection logic — pick the chain with sufficient USDT + gas:

• - TRON: needs USDT + some TRX
• BSC: needs USDT + some BNB
• ETH: needs USDT + some ETH (usually most expensive gas)

If no chain has enough funds, tell the user to fund their wallet and show the wallet address from wallet balance.

Automated Card Apply

CODEBLOCK9

Same chain selection logic as topup.

Automated Card Withdrawal

CODEBLOCK10

Only Bit2Go cards (card_id=23, shown as payall_card_id: 23) support withdrawal. If the user has a non-Bit2Go card, inform them that withdrawal is not supported for that card type.

Fallback Rule

If wallet send fails for any reason, always present the deposit address, chain, and amount to the user so they can complete the transfer manually via any wallet app. The CLI also prints this information on failure.

Card Recommendations

When a user asks about cards, help them find the best fit rather than listing everything. If they haven't shared their needs, ask about:

1. 1. Primary use case (online shopping, subscriptions, travel, etc.)
2. Expected monthly spend (affects which fee structure is cheapest)
3. Physical card vs virtual
4. Currency preference (USD, EUR, GBP, etc.)
5. Willingness to complete KYC
6. Region

Then use payall cards list, payall cards info, and payall cards compare to evaluate based on fee structure, payment support (Apple Pay, Google Pay, etc.), KYC requirements, and currency options.

Recommend the genuinely best card for their needs, even if it's not one of the two API-applicable cards (23, 39). Many cards in the marketplace have better features for specific use cases — if the best card requires website signup, that's fine, just explain how to get it.

The rating and general_ratings fields in card data are placeholder values and not meaningful — base recommendations on actual card attributes like fees, features, and supported currencies.

Always show a fee comparison (payall cards fees) so the user knows exactly what they'll pay.

Display Guidelines

When presenting card info to users, only show what they care about: card name, balance, status, card number, fees, etc. Skip internal fields like rank, id, bindingid, brand, rating, or generalratings — these are technical identifiers that don't help the user.

Troubleshooting

• - "Not logged in": Run INLINECODE71
• "User Not Authorized": Token expired — run payall auth login again
• "Bind Card Failed": For cards 23/39, use cards apply (not cards/binding)
• Cards list empty after apply: Normal — check payall cards my (may take a moment)
• Private key security: Key is signed locally via viem, never sent to server. Stored key is AES-256-GCM encrypted