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 bun install -g payall-cli
• Credentials: Stored encrypted at ~/.payall/

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.

payall auth login                              # Interactive login (prompts for private key)
payall auth login --save-key                   # Interactive login + save key for wallet commands
payall auth login --key <private_key>          # Non-interactive login — key auto-saved (use this for agents)
payall auth login --invite XYZ                 # Include referral code (first-time only)
payall auth status                             # Show current session info
payall auth logout                             # Clear session, credentials, and saved key

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)

payall cards list                        # List all marketplace cards
payall cards list --search "bit"         # Search by card name
payall cards list --sort general         # Sort by: general, benefit, privacy, fees
payall cards list --sort-dir asc         # Sort direction: asc, desc
payall cards list --skip-kyc             # Only cards without KYC requirement
payall cards list --kyc-only             # Only cards requiring KYC
payall cards info <card_id>              # Full card details + fees
payall cards compare <id1> <id2>         # Side-by-side comparison
payall cards fees                        # Fee quote (defaults to card 23, OPEN_CARD)
payall cards fees --card-id 39           # Fee quote for specific card
payall cards fees --type CARD_CHARGE     # Types: OPEN_CARD, CARD_CHARGE, CARD_WITHDRAW
payall cards fees --type CARD_CHARGE --amount 100  # card_bin auto-resolved
payall cards fees --amount 100           # With specific amount
payall cards fees --currency EUR         # With specific currency
payall cards fees --card-bin 44742000    # Explicit BIN override (optional)

User Cards (auth required)