snaplii-cli

Command-line client for Snaplii Agent-to-Merchant (A2M) payments. It lets AI agents and scripts buy gift cards from 500+ brands, pay bills, and send P2P transfers — all from a prepaid Snaplii Cash balance, with cashback on every purchase and no checkout or card sharing.

Every command prints JSON, so any agent that can run a shell command can use it.

Requirements

• Python 3.9+
• A Snaplii account and API key. In the Snaplii app (iOS / Android) go to More → Payment Methods → AI Payment Management → + New API Key, choose a scope, and set a hard spending limit. The key is shown once.

Install

From PyPI, isolated with pipx (recommended):

pipx install snaplii-cli

From a checkout of the repository:

pipx install -e ./snaplii-cli

Plain pip install snaplii-cli also works. OS-specific pipx setup and troubleshooting are in the repository README.

Authenticate

snaplii init

Prompts for your API key with hidden input. The key is exchanged for a session token and never stored; the token is kept in your OS keychain when one is available.

Usage

# Gift cards
snaplii browse tags                                  # categories and brands for your account's country
snaplii browse brand --id CB...                      # denominations and cashback
snaplii balance --country CA                         # spendable Snaplii Cash (CA=CAD, US=USD)
snaplii quote --item-id CB...-CT... --price 50       # price after voucher/cashback
snaplii purchase --item-id CB...-CT... --price 50    # buy; pays from Snaplii Cash
snaplii giftcard list                                # owned cards

# Bill pay
snaplii billpay payees
snaplii billpay save --payee-code PE... --first-name Alex --last-name Chen --amount 75.25 --account 1234567890
snaplii billpay quote --pay-code PC... --price 75.25
snaplii billpay pay --pay-code PC... --price 75.25

# P2P transfer (API key scope P2P or ALL)
snaplii transfer create --to-phone 4165550006 --amount 12.50
snaplii transfer status --order-no ZZ... --wait --timeout 330
snaplii transfer list

• --item-id is {cardBrandId}-{cardTemplateId}; both come from snaplii browse brand.
• Bill pay flow: payees → detail → save (returns payCode) → quote → pay → result.
• A new transfer stays cancellable (transfer cancel) for about 5 minutes, then sends automatically; transfer finish sends it immediately. transfer status --wait polls for the outcome, but its --timeout defaults to 120s — pass a larger value (e.g. --timeout 330) to poll through the whole cancellable window.
• snaplii help and snaplii <command> --help list every flag.

Commands

Safety model

Spending draws only from the prepaid Snaplii Cash balance and is capped by the per-key limit set in the app. Keys are scoped and can be revoked at any time from the app.

More

• Full documentation, MCP server, and agent skills: https://github.com/Snaplii-Inc/agent-to-merchant-payments
• Changelog: https://github.com/Snaplii-Inc/agent-to-merchant-payments/blob/main/CHANGELOG.md
• Issues: https://github.com/Snaplii-Inc/agent-to-merchant-payments/issues

License

Apache License 2.0