Agent skill

PayRam Checkout Integration

by PayRam in PayRam/payram-mcp

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.

No licenceAuto-check: notesBackend & APIs

Install PayRam Checkout Integration

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

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

GitHub CLI
$ gh skill install PayRam/payram-mcp payram-checkout-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-checkout-integration .claude/skills/payram-checkout-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-checkout-integration
GitHub stars
158
Token cost
~3.4k tokens
SKILL.md length
379 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
None found

At a glance

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.

  • Adding a crypto payment option to an e-commerce checkout
  • SKILL.md covers Payment Flow Overview, Payment States, SDK Integration… and HTTP Integration (Python, Go,…, plus 8 more sections
  • Calls npm; needs PAYRAM_API_KEY
  • Building a deposit flow that redirects users to a hosted payment page

What it does

The skill describes PayRam's payment flow: your backend posts to `/api/v1/payment` on your PayRam server, receives a URL, a reference ID and a host, and redirects the customer to that URL. It documents the payment states (open, filled, partially filled, over filled, cancelled and undefined) so your code can react to underpaid and overpaid transfers.

For Node.js and TypeScript it shows the `payram` npm SDK, including required fields `customerEmail`, `customerId` and `amountInUSD` and optional `settlementCurrency`, `memo` and `redirectUrl`, plus a status check. For Python, Go, PHP and Java it shows plain HTTP calls and stresses that PayRam expects an `API-Key` header, not a Bearer token. Setup of the server, keys and wallets is covered by a separate PayRam setup skill.

When your agent uses it

  • Adding a crypto payment option to an e-commerce checkout
  • Building a deposit flow that redirects users to a hosted payment page
  • Handling partial payments and overpayments in an existing payment backend
  • Polling or checking a PayRam payment's status after the redirect

Example prompts

  • “Add a PayRam checkout button to our Next.js store that creates a payment and redirects the customer.”
  • “Write a FastAPI route that creates a PayRam payment for the cart total in USD.”
  • “Show me how to check a PayRam payment by reference ID in our Laravel app.”
  • “Our code treats every non-filled payment as failed. Handle PayRam's partially filled and over filled states.”

Requirements

  • A running PayRam server with an API key and wallets configured
  • Node.js and the `payram` npm package for the SDK route

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

    Shell commands in SKILL.md call:

    • npm

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

  • Network

    Links to these hosts (documentation or services it may open):

    • t.me
    • payram.com
    • github.com

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • PAYRAM_API_KEY

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

Context cost

PayRam Checkout Integration loads about 3.4k tokens when it runs. Until then it costs about 99 tokens; SKILL.md has 379 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:369
    # .env

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 379 words (~3,355 tokens).

“Implement payment acceptance flows using PayRam's API. Create payments, redirect users, and confirm transactions.”

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

Read the full SKILL.md on GitHub

Files

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

Open the folder on GitHubat commit fbeab44

Compare with similar skills

PayRam Checkout 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 Checkout Integration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PayRam Checkout Integration this skillPayRam/payram-mcp158—~3.4kAutomated safety check: NotesNone
Implementing API Patternsancoleman/ai-design-components525—~3kAutomated safety check: PassMIT
API Designericrisco/rsc-harness180—~3.1kAutomated safety check: PassMIT
Sentry Node SDKgetsentry/sentry-for-ai268—~8.4kAutomated safety check: PassApache-2.0
Developmentaiskillstore/marketplace4333 repos~1.8kAutomated safety check: PassNone
App Buildersoftspark/ai-toolkit179—~2.2kAutomated safety check: PassApache-2.0

Similar skills

  • Implementing API Patterns

    ancoleman/ai-design-components

    API design and implementation across REST, GraphQL, gRPC, and tRPC patterns.

    525 GitHub stars~3k tokensUpdated 10 mo ago
    Backend & APIsAuto-check passed
  • API Design

    ericrisco/rsc-harness

    A skill your agent uses when settling the contract of an API you expose, before implementation: resources/URLs, REST vs GraphQL, versioning, one RFC 9457 error envelope, pagination, idempotency —…

    180 GitHub stars~3.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Sentry Node SDK

    getsentry/sentry-for-ai

    Official

    Full Sentry SDK setup for Node.js, Bun, and Deno. An agent skill from getsentry/sentry-for-ai.

    268 GitHub stars~8.4k tokensUpdated today
    Backend & APIsAuto-check passed
  • Development

    aiskillstore/marketplace

    Comprehensive web, mobile, and backend development workflow bundling frontend, backend, full-stack, and mobile development skills for end-to-end application delivery.

    433 GitHub starsUsed in 3 repos~1.8k tokens
    Backend & APIsAuto-check passed
  • App Builder

    softspark/ai-toolkit

    App scaffolding: Next.js, Vite, Nuxt, Astro, FastAPI, Django, Laravel, RN, Flutter.

    179 GitHub stars~2.2k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Htmx

    ericrisco/rsc-harness

    A skill your agent uses when adding interactivity to a server-rendered app (FastAPI/Jinja, Django, Rails, Laravel, Go templates, Express) without adopting a JS framework — hx-get/post/put/delete…

    180 GitHub stars~3.4k tokensUpdated today
    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 yesterday
    Auto-check passed
  • Payram Auth

    PayRam/payram-mcp

    Authenticate with a PayRam instance to access merchant dashboard APIs.

    158 GitHub stars~2.2k tokensUpdated yesterday
    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 yesterday
    Auto-check passed
  • 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 yesterday
    Auto-check: notes
  • Integrate crypto payments into any web application with PayRam.

    158 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Payram Payouts

    PayRam/payram-mcp

    Send crypto payouts and manage referral programs with PayRam.

    158 GitHub stars~4.2k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about PayRam Checkout Integration

What does PayRam Checkout Integration do?

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. The skill describes PayRam's payment flow: your backend posts to `/api/v1/payment` on your PayRam server, receives a URL, a reference ID and a host, and redirects the customer to that URL. It documents the payment states (open, filled, partially filled, over filled, cancelled and undefined) so your code can react to underpaid and overpaid transfers.

When should I use PayRam Checkout Integration?

PayRam Checkout Integration fits situations like: adding a crypto payment option to an e-commerce checkout; building a deposit flow that redirects users to a hosted payment page; handling partial payments and overpayments in an existing payment backend; polling or checking a PayRam payment's status after the redirect.

How do I install PayRam Checkout Integration in Claude Code?

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

How do I install PayRam Checkout Integration in Codex?

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

Can I use PayRam Checkout 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-checkout-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-checkout-integration, .gemini/skills/payram-checkout-integration, .github/skills/payram-checkout-integration and .opencode/skills/payram-checkout-integration in your project.

What does PayRam Checkout Integration need to run?

Going by SKILL.md and its folder, PayRam Checkout Integration needs the command-line tools its instructions call (npm) and credentials named PAYRAM_API_KEY. Our summary lists: A running PayRam server with an API key and wallets configured; Node.js and the `payram` npm package for the SDK route.

Does PayRam Checkout Integration access the network?

SKILL.md names 3 domains. As links in the text: t.me, payram.com and github.com. This is read from the text; nothing was executed.

Is PayRam Checkout Integration safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does PayRam Checkout Integration use?

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

How many tokens does PayRam Checkout Integration use?

About 3.4k tokens (SKILL.md is roughly 13k 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 Checkout Integration?

Skills that share tags, products or a category with PayRam Checkout Integration: Implementing API Patterns (ancoleman/ai-design-components, 525 stars), API Design (ericrisco/rsc-harness, 180 stars), Sentry Node SDK (getsentry/sentry-for-ai, 268 stars) and Development (aiskillstore/marketplace, 433 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PayRam Checkout 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.