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-idis{cardBrandId}-{cardTemplateId}; both come fromsnaplii 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 finishsends it immediately.transfer status --waitpolls for the outcome, but its--timeoutdefaults to 120s — pass a larger value (e.g.--timeout 330) to poll through the whole cancellable window. snaplii helpandsnaplii <command> --helplist every flag.
Commands
| Group | Commands |
|---|---|
| Auth & config | init, config show, config set --base-url URL, config clear |
| Catalog | browse tags, browse brand --id ID |
| Balance & quotes | balance [--country CA|US], quote --item-id ID --price P |
| Purchases | purchase --item-id ID --price P, giftcard list, giftcard detail --card-no NO |
| Smart | smart cashback --brand-id ID --amount A, smart dashboard |
| Bill pay | billpay payees, billpay detail, billpay save, billpay vouchers, billpay quote, billpay pay, billpay result, billpay history |
| Transfers | transfer create, transfer cancel, transfer finish, transfer status [--wait] [--timeout S], transfer list |
| Maintenance | update, help |
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
1 maintainer
Metadata
1 maintainer
Release files for snaplii-cli 0.16.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| snaplii_cli-0.16.0.tar.gz | 31.0 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| snaplii_cli-0.16.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 70.3 kB
Release files / snaplii_cli-0.16.0.tar.gz
| Download URL | snaplii_cli-0.16.0.tar.gz |
|---|---|
| Size | 31.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1e284357fbcb1048e9b9884fb6042750b78d35e67d1828eae6216180ea4f6c8e
|
|
BLAKE2b-256 checksum How to use checksums |
85110a2d5377ea24c0356c22799b38a3cb0c6f3333ca2642cab84ca0f17ec321
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.
Transparency logRelease files / snaplii_cli-0.16.0-py3-none-any.whl
| Download URL | snaplii_cli-0.16.0-py3-none-any.whl |
|---|---|
| Size | 39.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
787a49bb6f459258bbb6f0acef5288c902f41873d0fbd904f19e20fea09196f3
|
|
BLAKE2b-256 checksum How to use checksums |
69f712185cbb7891a26bf00bbf4c779894d95031e2e223f2991b4b3a74683240
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.
Transparency logSecurity for snaplii-cli 0.16.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for snaplii_cli-0.16.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
