HitPay Product Guide and API docs.

Integrate HitPay into your application using AI coding assistants like Claude Code, Cursor, GitHub Copilot, and Windsurf.

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

You can tell your AI assistant “Add HitPay payments to my app” and it will generate the implementation.

Installation

Install the HitPay skill in your project:

npx skills add hit-pay/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

Task	Prompt
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 generates the code following the patterns in the skill (auth headers, webhook signature verification, error handling).

What’s Included

The skill covers:

Feature	Description
Payment Requests	Create payments via redirect or embedded QR
Frontend Options	Redirect checkout, embedded QR, payment method selector
Webhook Handling	Signature verification, event processing
Refunds	Full and partial refund implementation
Code Examples	Next.js, Express.js, and vanilla TypeScript

How It Works

Install the skill

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

Describe your task

Tell your AI assistant what you want to build

Review generated code

The AI creates implementation following HitPay best practices

Customize as needed

Modify the generated code for your specific requirements

Prerequisites

Before using the skill, ensure you have:

HitPay Account - Create an account or use the sandbox environment
API Key - Found in Settings → Payment Gateway → API Keys
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

Claude Code Plugin

Live API access from inside Claude Code

HitPay MCP Server

Query your business data from an AI assistant

Feedback

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

Getting Started

Developers

Point of Sale

Online Store

Tools

Manage Payments

Integrations

Appendix

AI Agent Skills

What are Agent Skills?

Installation

Usage

Examples

What’s Included

How It Works

Prerequisites

Environment Variables

Resources

GitHub Repository

Create Payment Request

Webhook Events

Sandbox Guide

Claude Code Plugin

HitPay MCP Server

Feedback

​What are Agent Skills?

​Installation

​Usage

​Examples

​What’s Included

​How It Works

​Prerequisites

​Environment Variables

​Resources

GitHub Repository

Create Payment Request

Webhook Events

Sandbox Guide

Claude Code Plugin

HitPay MCP Server

​Feedback

What are Agent Skills?

Installation

Usage

Examples

What’s Included

How It Works

Prerequisites

Environment Variables

Resources

Feedback