Agent skill

Payram Webhook Integration

by PayRam in PayRam/payram-mcp

Integrate PayRam webhook handlers for real-time payment and payout event notifications.

No licenceAuto-check: notesBackend & APIs

Install Payram Webhook Integration

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

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

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

At a glance

Integrate PayRam webhook handlers for real-time payment and payout event notifications.

  • Works in 3 steps: In the PayRam dashboard, open Project →… → Add your endpoint URL:… → Store the project API key (Project → API…
  • Setting up payment confirmation callbacks
  • SKILL.md covers Webhook Flow, Configuring Webhooks in PayRam, Webhook Authentication and Webhook Payload, plus 10 more sections
  • Calls curl and openssl; needs PAYRAM_API_KEY

What it does

Payram Webhook Integration is an agent skill from PayRam/payram-mcp. Integrate PayRam webhook handlers for real-time payment and payout event notifications. Self-hosted, no-KYC crypto payment gateway webhooks. Implement X-Payram-Signature (HMAC-SHA256) verification, event routing, and idempotent processing. Generate handlers for Express, Next.js, FastAPI, Gin, Laravel, Spring Boot. Use when setting up payment confirmation callbacks, handling payout status updates, building event-driven payment flows, or integrating PayRam events into existing systems.

Its SKILL.md is about 5.2k 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 Webhooks and Backend development. It works with Next.js, FastAPI, Laravel and Spring Boot. The repository describes itself as: Connect to hosted payram helper at: https://mcp.payram.com.

When your agent uses it

  • Setting up payment confirmation callbacks
  • Handling payout status updates
  • Building event-driven payment flows
  • Integrating PayRam events into existing systems

Example prompts

  • “/payram-webhook-integration”

Requirements

  • Python 3
  • A credential in PAYRAM_API_KEY

Workflow steps

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

  1. In the PayRam dashboard, open Project → Webhooks
  2. Add your endpoint URL: https://your-app.com/api/payram/webhook
  3. Store the project API key (Project → API keys) as PAYRAM_API_KEY in your server's .env

What it can do on your machine

Read from SKILL.md and the folder at commit e460a40. 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:

    • curl
    • openssl

    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 Webhook Integration loads about 5.2k tokens when it runs. Until then it costs about 129 tokens; SKILL.md has 662 words of instructions outside code blocks.

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

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:26
    s) as `PAYRAM_API_KEY` in your server's `.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 662 words (~5,155 tokens).

“Receive real-time notifications when payments confirm, fail, or payouts complete. Webhooks eliminate polling and enable event-driven architectures.”

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

Read the full SKILL.md on GitHub

Files

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

Open the folder on GitHubat commit e460a40

Compare with similar skills

Payram Webhook 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 Webhook Integration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Payram Webhook Integration this skillPayRam/payram-mcp158—~5.2kAutomated safety check: NotesNone
App Buildersoftspark/ai-toolkit179—~2.2kAutomated safety check: PassApache-2.0
Htmxericrisco/rsc-harness167—~3.4kAutomated safety check: PassMIT
Cashier Stripe Developmentluadotsh/lua3431 repos~1.2kAutomated safety check: PassMIT
Andrej Karpathy Perspectivenazarli-shabnam/clevis1703 repos~3.8kAutomated safety check: PassMIT
Arch Wikiahmedemad3/arch-wiki249—~5.1kAutomated safety check: PassNone

Similar skills

  • App Builder

    softspark/ai-toolkit

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

    179 GitHub stars~2.2k tokensUpdated yesterday
    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…

    167 GitHub stars~3.4k tokensUpdated today
    Backend & APIsAuto-check passed
  • 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
  • Andrej Karpathy Perspective

    nazarli-shabnam/clevis

    Andrej Karpathy的思维框架与表达方式。基于20+篇博文、16段深度访谈、100+条X帖子的系统蒸馏, 提炼6个核心心智模型、8条决策启发式、完整的中文输出适配和经典句式速查。

    170 GitHub starsUsed in 3 repos~3.8k tokens
    Backend & APIsAuto-check passed
  • Arch Wiki

    ahmedemad3/arch-wiki

    Scans any project codebase for new/changed modules, endpoints, middleware, infrastructure, Docker topologies, SQL queries, or permissions and updates docs/architecture/architecture.json.

    249 GitHub stars~5.1k tokensUpdated 19 days ago
    Backend & APIsAuto-check passed
  • Holm Web

    volfpeter/holm

    A skill your agent uses when working on web apps built with holm, or to answer questions about holm.

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

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

Categories

Questions about Payram Webhook Integration

What does Payram Webhook Integration do?

Integrate PayRam webhook handlers for real-time payment and payout event notifications. Payram Webhook Integration is an agent skill from PayRam/payram-mcp. Integrate PayRam webhook handlers for real-time payment and payout event notifications.

When should I use Payram Webhook Integration?

Payram Webhook Integration fits situations like: setting up payment confirmation callbacks; handling payout status updates; building event-driven payment flows; integrating PayRam events into existing systems.

How do I install Payram Webhook Integration in Claude Code?

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

How do I install Payram Webhook Integration in Codex?

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

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

What does Payram Webhook Integration need to run?

Going by SKILL.md and its folder, Payram Webhook Integration needs the command-line tools its instructions call (curl and openssl) and credentials named PAYRAM_API_KEY. Our summary lists: Python 3; A credential in PAYRAM_API_KEY.

Does Payram Webhook 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 Webhook 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 Webhook Integration use?

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

How many tokens does Payram Webhook Integration use?

About 5.2k tokens (SKILL.md is roughly 21k 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 Webhook Integration?

Skills that share tags, products or a category with Payram Webhook Integration: App Builder (softspark/ai-toolkit, 179 stars), Htmx (ericrisco/rsc-harness, 167 stars), Cashier Stripe Development (luadotsh/lua, 343 stars) and Andrej Karpathy Perspective (nazarli-shabnam/clevis, 170 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Payram Webhook 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 7, 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.