Agent skill

Payram Topup Wallet Integration

by PayRam in PayRam/payram-mcp

Integrate PayRam into an EXISTING app using the recommended top-up wallet pattern — credit crypto payments to a user's in-app wallet balance first, then debit invoices from that balance.

No licenceAuto-check passedBackend & APIs

Install Payram Topup Wallet Integration

skills CLI
$ npx skills add PayRam/payram-mcp --skill payram-topup-wallet-integration -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install PayRam/payram-mcp payram-topup-wallet-integration --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/PayRam/payram-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/payram-topup-wallet-integration .claude/skills/payram-topup-wallet-integration && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
payram-topup-wallet-integration
GitHub stars
158
Token cost
~3k tokens
SKILL.md length
917 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
None found

At a glance

Integrate PayRam into an EXISTING app using the recommended top-up wallet pattern — credit crypto payments to a user's in-app wallet balance first, then debit invoices from that balance.

  • Works in 3 steps: Ping: if the request carries… → Verify: check the X-Payram-Signature:… → Credit: parse the body, run the…
  • Adding PayRam to an app that has its own users/invoices/orders
  • SKILL.md covers Why top-up-first, not…, Architecture: the ledger, The critical PayRam semantic:… and The flows, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Payram Topup Wallet Integration is an agent skill from PayRam/payram-mcp. Integrate PayRam into an EXISTING app using the recommended top-up wallet pattern — credit crypto payments to a user's in-app wallet balance first, then debit invoices from that balance. Handles every crypto payment reality (overpayment, underpayment, multiple sends, late payments, duplicate webhooks) as balance states instead of payment exceptions. Covers the ledger schema, the credit/debit flows, idempotency, concurrency, reconciliation, and PayRam's cumulative filledamountinusd semantics. Use when adding…

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Forms and invoices and Webhooks. The repository describes itself as: Connect to hosted payram helper at: https://mcp.payram.com.

When your agent uses it

  • Adding PayRam to an app that has its own users/invoices/orders
  • Payments may not exactly match invoice amounts
  • Building credits
  • Prepaid balances

Example prompts

  • “/payram-topup-wallet-integration”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Ping: if the request carries X-Webhook-Test: true, it is an unsigned payout ping. Answer 200 and stop.
  2. Verify: check the X-Payram-Signature: sha256= header, keyed with your project API key (the newest active one; there is no separate webhook…
  3. Credit: parse the body, run the cumulative-credit logic above, then re-attempt Flow A for any awaiting_funds invoices of that user.

What it can do on your machine

Read from SKILL.md and the folder at commit fbeab44. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are sql).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Payram Topup Wallet Integration loads about 3k tokens when it runs. Until then it costs about 184 tokens; SKILL.md has 917 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~184
When it runs · the whole SKILL.md, loaded when a task matches
~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 917 words (~3,001 tokens).

“Crypto payments are approximate by nature. A customer paying a $50 invoice may send $49.20 (gas mental-math), $60 (round number), $50 in two transfers, or the right amount two hours after the link "expired" — the funds still arrive on-chain…”

— opening of SKILL.md by PayRam
name
payram-topup-wallet-integration

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/payram-topup-wallet-integration of PayRam/payram-mcp.

Open the folder on GitHubat commit fbeab44

Compare with similar skills

Payram Topup Wallet Integration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Payram Topup Wallet Integration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Payram Topup Wallet Integration this skillPayRam/payram-mcp158—~3kAutomated safety check: PassNone
Cashier Stripe Developmentluadotsh/lua3431 repos~1.2kAutomated safety check: PassMIT
Plaid Fintechsickn33/agentic-awesome-skills47k2 repos~467Automated safety check: PassMIT
Stripe Patternsbybren-llc/safe-agentic-workflow423—~1.2kAutomated safety check: PassMIT
Billingtrycompai/comp2k—~824Automated safety check: PassAGPL-3.0
Signalsalsk1992/CloddsBot3k—~720Automated safety check: PassMIT

Similar skills

  • Handles Laravel Cashier Stripe integration including subscriptions, webhooks, Stripe Checkout, invoices, charges, refunds, trials, coupons, metered billing, and payment failure handling.

    343 GitHub starsUsed in 1 repo~1.2k tokens
    Backend & APIsAuto-check passed
  • Plaid Fintech

    sickn33/agentic-awesome-skills

    Expert patterns for Plaid API integration including Link token flows, transactions sync, identity verification, Auth for ACH, balance checks, webhook handling, and fintech compliance best practices.

    47k GitHub starsUsed in 2 repos~467 tokens
    Backend & APIsAuto-check passed
  • Stripe Patterns

    bybren-llc/safe-agentic-workflow

    Stripe payment integration patterns for checkout flows, webhooks, and subscriptions.

    423 GitHub stars~1.2k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Billing

    trycompai/comp

    A skill your agent uses when changing Comp AI billing, Stripe products/prices, subscription checkout, org payment methods, entitlements, usage ledgers, invoices, or billing webhooks.

    2k GitHub stars~824 tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Signals

    alsk1992/CloddsBot

    Signal trading - RSS, Twitter, Telegram triggers to trades. An agent skill from alsk1992/CloddsBot.

    3k GitHub stars~720 tokensUpdated 8 days ago
    Backend & APIsAuto-check passed
  • Int Omie

    evolution-foundation/evo-nexus

    Omie ERP integration via API. An agent skill from evolution-foundation/evo-nexus.

    545 GitHub stars~590 tokensUpdated 5 mo ago
    Backend & APIsAuto-check passed

More from PayRam/payram-mcp

All 12 skills in this repo
  • PayRam Payment Analytics

    PayRam/payram-mcp

    Queries a PayRam server's dashboard data through its REST APIs with a Bearer token: payment search, daily volume, unswept balances, sweep history and on-ramp metrics.

    158 GitHub stars~4.1k tokensUpdated 2 days ago
    Auto-check passed
  • Payram Auth

    PayRam/payram-mcp

    Authenticate with a PayRam instance to access merchant dashboard APIs.

    158 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed
  • PayRam Bitcoin Payments

    PayRam/payram-mcp

    Explains accepting on-chain Bitcoin with PayRam's self-hosted setup: HD wallet deposit addresses, mobile app signing for sweeps, and the same payment API as other coins.

    158 GitHub stars~2.1k tokensUpdated 2 days ago
    Auto-check passed
  • Adds crypto checkout to a web app with PayRam: create a payment from your backend, send the customer to the payment page, then confirm the result.

    158 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check: notes
  • Payram Crypto Payments

    PayRam/payram-mcp

    Self-hosted crypto and stablecoin payment gateway. An agent skill from PayRam/payram-mcp.

    158 GitHub stars~2k tokensUpdated 2 days ago
    Auto-check: notes
  • Integrate crypto payments into any web application with PayRam.

    158 GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check passed

Questions about Payram Topup Wallet Integration

What does Payram Topup Wallet Integration do?

Integrate PayRam into an EXISTING app using the recommended top-up wallet pattern — credit crypto payments to a user's in-app wallet balance first, then debit invoices from that balance. Payram Topup Wallet Integration is an agent skill from PayRam/payram-mcp. Integrate PayRam into an EXISTING app using the recommended top-up wallet pattern — credit crypto payments to a user's in-app wallet balance first, then debit invoices from that balance.

When should I use Payram Topup Wallet Integration?

Payram Topup Wallet Integration fits situations like: adding PayRam to an app that has its own users/invoices/orders; payments may not exactly match invoice amounts; building credits; prepaid balances.

How do I install Payram Topup Wallet Integration in Claude Code?

Run `npx skills add PayRam/payram-mcp --skill payram-topup-wallet-integration -a claude-code`. Or copy the skill folder (skills/payram-topup-wallet-integration in PayRam/payram-mcp) into .claude/skills/payram-topup-wallet-integration in your project. Claude Code loads it when a task matches its description.

How do I install Payram Topup Wallet Integration in Codex?

Run `npx skills add PayRam/payram-mcp --skill payram-topup-wallet-integration -a codex`. Or copy the skill folder (skills/payram-topup-wallet-integration in PayRam/payram-mcp) into .agents/skills/payram-topup-wallet-integration in your project. Codex loads it when a task matches its description.

Can I use Payram Topup Wallet Integration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add PayRam/payram-mcp --skill payram-topup-wallet-integration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/payram-topup-wallet-integration, .gemini/skills/payram-topup-wallet-integration, .github/skills/payram-topup-wallet-integration and .opencode/skills/payram-topup-wallet-integration in your project.

What does Payram Topup Wallet Integration need to run?

SKILL.md names no scripts, command-line tools or credentials: Payram Topup Wallet Integration is instructions for the agent only.

Does Payram Topup Wallet Integration access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Payram Topup Wallet Integration safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Payram Topup Wallet Integration use?

No licence was found for Payram Topup Wallet Integration or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Payram Topup Wallet Integration use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Payram Topup Wallet Integration?

Skills that share tags, products or a category with Payram Topup Wallet Integration: Cashier Stripe Development (luadotsh/lua, 343 stars), Plaid Fintech (sickn33/agentic-awesome-skills, 47k stars), Stripe Patterns (bybren-llc/safe-agentic-workflow, 423 stars) and Billing (trycompai/comp, 2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Payram Topup Wallet Integration?

PayRam (a GitHub organization) maintains it in PayRam/payram-mcp, which has 158 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 8, 2026.

Source: PayRam/payram-mcp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.