payall-cli

Payall CLI

A terminal tool for managing crypto debit cards on the Payall platform. Browse a card marketplace, apply for cards funded with USDT, top up balances, check card details, and more — all from your terminal.

⚠️ Security Disclaimer: Payall CLI and Payall Skills are under active development. Do not use with wallets holding significant assets. Use at your own risk.

Install

npm install -g payall-cli

Or with Bun:

bun install -g payall-cli

Then run from anywhere:

payall <command>

Development

git clone https://github.com/user/payall-cli.git
cd payall-cli
bun install
bun run build
bun link

Run directly from source without building:

bun run src/cli.ts <command>

Quick Start

# 1. Login with your EVM wallet
payall auth login

# 2. Browse available cards
payall cards list

# 3. Check card details and fees
payall cards info 23
payall cards fees --card-id 23

# 4. Apply for a card (interactive)
payall cards apply 23

# 5. Check your cards
payall cards my

# 6. Top up a card
payall cards topup <binding_id>

Commands

Authentication

Command	Description
payall auth login	Sign in with EVM private key (auto-registers new wallets)
payall auth login --save-key	Sign in and save encrypted key for future sessions
payall auth login --key <key>	Non-interactive login (for agents) — key auto-saved
payall auth login --invite CODE	Sign in with referral code (first login only)
payall auth status	Show current session info
payall auth logout	Clear session, credentials, and saved key

Your private key is signed locally and never sent to the server. Saved keys are encrypted with AES-256-GCM.

Card Marketplace (no auth required)

Command	Description
payall cards list	Browse all cards
payall cards list --search "bit"	Search by name
payall cards list --sort fees --skip-kyc	Sort and filter
payall cards info <card_id>	Card details and fee breakdown
payall cards compare <id1> <id2>	Side-by-side comparison
payall cards fees --card-id 23 --type OPEN_CARD	Fee quote

Your Cards (auth required)

Command	Description
payall cards my	List your bound cards with balances
payall cards detail <binding_id>	Masked card number, CVV, billing address
payall cards detail <binding_id> --reveal	Full card number and CVV
payall cards detail <binding_id> --reveal --json	JSON output for programmatic use
payall cards apply <card_id>	Apply for a new card (interactive)
payall cards apply <card_id> --auto-fill --chain tron --yes	Non-interactive apply (for agents)
payall cards topup <binding_id>	Top up card balance with crypto (interactive)
payall cards topup <binding_id> --amount 50 --chain tron --yes	Non-interactive topup (for agents)
payall cards collections	List favorited cards
payall cards favorite <card_id>	Toggle favorite

Wallet

Command	Description
payall wallet balance	USDT + gas token balances on BSC, ETH, TRON
payall wallet send --to 0x... --amount 50 --chain bsc	Send USDT on BSC
payall wallet send --to 0x... --amount 50 --chain eth	Send USDT on Ethereum
payall wallet send --to T... --amount 50 --chain tron	Send USDT on TRON (TRC-20)

Add --yes / -y to skip the confirmation prompt. If no saved wallet key is found, the CLI will prompt for it interactively and offer to save it.

Other

Command	Description
payall chat	AI assistant chat
payall referrals	Referral program info
payall referrals details	Referral earnings breakdown
payall transfer create	Create a fiat transfer
payall transfer list	List transfers
payall transfer status <id>	Check transfer status

Card Topup Flow

$ payall cards topup 515

  Loading card info...
  Bit2Go (****1114) - USD - active

? Amount (USDT): 50

  Fee quote:
    You send:       50 USDT
    Fee (1.5%):     0.75 USDT
    Card receives:  49.25 USD

? Select deposit network: TRON (TRC20)
? Confirm topup? Yes
  Topup order created!
  Getting deposit address...

  Deposit Address (TRON):
  TXyz...abc
  Minimum deposit: 0.5 USDT
  Expires: 2026-09-08

  Send 50 USDT to the address above.
  Balance will update after confirmation.
  Check status with: payall cards my

Using with AI Agents

The CLI is designed to work with AI agents (Claude, etc.) via the skill file at .claude/skills/payall-cli/SKILL.md. To give your agent access:

For Claude Code users

The skill is auto-discovered. Just ask Claude to manage your cards:

"Top up my Bit2Go card with 50 USDT" "Show me my card balances" "Apply for a new card with no KYC"

For other agents

Point your agent at the skill file or include these instructions in its system prompt:

Key patterns your agent needs to know:

• Run payall <command> from anywhere (globally linked)
• Get card data as JSON with payall cards detail <binding_id> --reveal --json
• The binding ID (from payall cards my) is different from the card catalog ID (from payall cards list)
• Auth is required for cards my, cards detail, cards apply, cards topup, wallet *, transfer *
• Two response envelopes: standard (code/data/message) and path-style (resCode/resMsg/data) — the CLI handles both

Agent workflow example — topping up a card:

1. Run: payall cards my                                             -> get the binding_id
2. Run: payall cards topup <id> --amount 50 --chain tron --yes      -> get deposit address
3. Run: payall wallet balance                                       -> check which chain has funds
4. Run: payall wallet send --to <deposit_addr> --amount 50 --chain tron --yes  -> send USDT

The --amount, --chain, and --yes flags bypass all interactive prompts, making it safe for AI agents to call directly. If wallet send fails, the CLI prints the deposit address for manual transfer.

API

• Base URL: https://api.payall.pro/v1/api
• Auth: JWT Bearer token (180-day expiry)
• Credentials: Stored encrypted at ~/.payall/