Skip to main content
Integrate HitPay into your application faster using AI coding assistants like Claude Code, Cursor, GitHub Copilot, and other AI-powered development tools.

​
What are Agent Skills?

Agent Skills are pre-packaged instructions that teach AI coding assistants how to integrate HitPay. Instead of reading through documentation, your AI assistant already knows:
  • How to create payment requests
  • When to use redirect vs. embedded QR checkout
  • How to handle webhooks securely
  • How to process refunds
This means you can simply tell your AI assistant “Add HitPay payments to my app” and it will generate the correct implementation.

​
Installation

Install the HitPay skill in your project: 
npx skills add hit-pay/agent-skills
Installing HitPay Agent Skills
This works with:
  • Claude Code (Anthropic)
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Other AI coding assistants that support the Agent Skills format

​
Usage

Once installed, just describe what you want in natural language.

​
Examples

TaskPrompt
Add a checkout flow”Add HitPay payment integration to my Next.js app”
Create QR code payments”Create a PayNow QR code checkout for my React app”
Handle webhooks”Set up HitPay webhook handling with signature verification”
Process refunds”Add a refund endpoint for HitPay payments”
The AI assistant will generate production-ready code following HitPay best practices.

​
What’s Included

The skill covers:
FeatureDescription
Payment RequestsCreate payments via redirect or embedded QR
Frontend OptionsRedirect checkout, embedded QR, payment method selector
Webhook HandlingSignature verification, event processing
RefundsFull and partial refund implementation
Code ExamplesNext.js, Express.js, and vanilla TypeScript

​
How It Works

1

Install the skill

Run npx skills add hit-pay/agent-skills in your project
2

Describe your task

Tell your AI assistant what you want to build
3

Review generated code

The AI creates implementation following HitPay best practices
4

Customize as needed

Modify the generated code for your specific requirements

​
Prerequisites

Before using the skill, ensure you have:
  1. HitPay Account - Create an account or use the sandbox environment
  2. API Key - Found in Settings → Payment Gateway → API Keys
  3. Webhook Salt - Found in Settings → Developers → Webhook Endpoints

​
Environment Variables

The generated code expects these environment variables: 
HITPAY_API_KEY=your_api_key
HITPAY_SALT=your_webhook_salt
NEXT_PUBLIC_APP_URL=http://localhost:3000

​
Resources

GitHub Repository

View source and contribute

Create Payment Request

API Reference

Webhook Events

Handle payment notifications

Sandbox Guide

Test your integration

​
Feedback

Have suggestions for the HitPay AI skill? Open an issue on GitHub.