HandyPay
HandyPay
Developer API

Accept payments with
a few lines of code

Integrate HandyPay into your app, website, or platform. Accept card payments, create payment links, and get paid across 17 countries.

// Create a payment intent
const response = await fetch('https://api.tryhandypay.com/v1/payments', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer hp_live_xxxxxxxxxxxxxxxx',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: 5000, // $50.00 in cents
    currency: 'usd',
    description: 'Order #1234',
    customer_email: 'customer@example.com'
  })
});

const payment = await response.json();
// Redirect customer to payment.checkout_url

Everything you need to accept payments

A complete API toolkit for accepting payments in the Caribbean, Africa, and beyond.

Accept Card Payments

Accept Visa, Mastercard, Amex, and Discover. Plus Apple Pay and Google Pay.

QR Code Payments

Generate QR codes for in-person payments. Customers scan and pay instantly.

Payment Links

Create shareable payment links for invoices, products, or services.

Real-time Webhooks

Get instant notifications when payments succeed, fail, or require action.

17 Countries

Accept payments and get payouts across the Caribbean and Africa.

Bank-grade Security

PCI DSS compliant with end-to-end encryption and fraud detection.

Simple, transparent pricing

Pay only for successful transactions. No monthly fees, no setup costs.

Same as App

Starter

Same rates as the mobile app

4.9% + $0.40

per successful transaction

  • Unlimited transactions
  • Payment links
  • QR code payments
  • Email support
  • Basic webhooks
  • 17 countries
Get Started

Growth

For high volume businesses

4.5% + $0.35

per successful transaction

  • $50,000+/month volume
  • Everything in Starter
  • Priority support
  • Advanced webhooks
  • Custom branding
  • Dedicated account manager
Contact Sales

Enterprise

For large scale operations

Custom

volume-based pricing

  • $500,000+/month volume
  • Everything in Growth
  • 24/7 dedicated support
  • Custom integrations
  • SLA guarantee
  • White-label options
Contact Sales

Developer-friendly documentation

Comprehensive guides, API references, and code examples to get you up and running in minutes.

Quick Start Guide

Get your first payment in 5 minutes

API Reference

Complete endpoint documentation

Webhooks

Real-time event notifications

SDKs & Libraries

Node.js, Python, PHP, and more

api-reference.md
## Endpoints

### Payments
POST   /v1/payments
GET    /v1/payments/:id
POST   /v1/payments/:id/refund

### Payment Links
POST   /v1/payment-links
GET    /v1/payment-links/:id
DELETE /v1/payment-links/:id

### Customers
POST   /v1/customers
GET    /v1/customers/:id
PUT    /v1/customers/:id

### Webhooks
POST   /v1/webhooks
GET    /v1/webhooks
DELETE /v1/webhooks/:id

Get early access to the API

Join the waitlist to be among the first developers to integrate HandyPay. We're rolling out API access in early 2025.

Already have API access? Go to Dashboard →