MyPay - Payment Skill

This skill handles payment workflows using the mypay-bot CLI tool.

System Requirements

• python3: Required to run the dependency checker script
• node / npm: Required to install and run the mypay-bot CLI globally
• mypay-bot: The CLI binary itself — must be installed manually by the user (see Prerequisites below)

Authentication

mypay-bot requires two credentials to operate. These must be configured before the first payment:

• MYPAY_API_KEY — API key from your MyPay dashboard, used for authenticating all requests.
• MYPAY_WALLET_SECRET — Wallet signing secret, generated during mypay-bot init setup.

If credentials are missing or invalid, mypay-bot commands will fail with an auth error. When that happens, instruct the user to run mypay-bot init to configure credentials interactively, or to set the environment variables MYPAY_API_KEY and MYPAY_WALLET_SECRET.

Prerequisites Check (MUST run first)

Before doing anything else, run the dependency checker script:

python3 "{{SKILL_DIR}}/scripts/install_mypay.py"

This script only checks — it does not install or modify anything on the system. It verifies:

1. Whether mypay-bot is installed globally
2. Whether the installed version matches the pinned version (1.0.0)

Exit codes:

• 0 — Ready to proceed.
• 1 — mypay-bot is not installed. Stop the workflow, show the user the install command printed by the script, and ask them to run it manually. Do NOT run npm install yourself.
• 2 — Installed but version mismatch. Inform the user an update is available and show the command. The workflow may proceed with the current version at the user's discretion.

The script never runs npm install or modifies global packages. Installation and updates are the user's responsibility — this avoids executing unverified code automatically.

Payment Workflow

Follow these steps in order. Do NOT skip any step.

Step 0: Capture Payment Intent

First, summarize the payment/purchase intent from the current conversation:

mypay-bot payment-intent

Review the output carefully. Then cache the summary:

mypay-bot payment-intent --summary

Step 1: Check Wallet Status

Verify the user's wallet is ready:

mypay-bot check-wallet

Review the wallet status output. If there are any issues (insufficient funds, locked wallet, etc.), inform the user before proceeding.

Step 2: Submit Payment

Execute the payment using the payment link from the previous steps:

mypay-bot submit-payment --payment-link "<payment_link>"

Replace <payment_link> with the actual payment link obtained from the workflow.

Critical Rules

• Preserve all links and images exactly: Every URL, link, and image reference that appears in the output of any mypay-bot command MUST be copied in full — character for character, with no truncation, no summarization, no reformatting. This includes query parameters, tokens, hashes, and any other URL components. Display them to the user exactly as received.

• Follow the step order strictly: Step 0 -> Step 1 -> Step 2. Do not skip or reorder.

• Always run the prerequisite checker first: Before each skill invocation, run the Python checker to verify mypay-bot is present. Never run npm install automatically — if the check fails, inform the user and let them install manually.