API v1.0 • Sandbox Available

Build Payment Solutions
with HooPay API

Integrate payments and collections into your platform with our secure, well-documented REST API. Start building in minutes.

Pay User
# Partner pays money to user wallet
curl -X POST https://hoopaywallet.com/api/v1/partner/pay-user \
  -H "Content-Type: application/json" \
  -H "X-API-Key: hpk_your_api_key" \
  -H "X-Signature: your_hmac_signature" \
  -d '{
    "reference_id": "DEP-001",
    "user_wallet_id": "123456",
    "amount": "100.00",
    "currency": "USD",
    "description": "Trading payout"
  }'

Core APIs

Everything you need to pay users, collect from users, and manage transactions.

Pay User API

Partner pays money to user wallets. Perfect for payouts, rewards, and fund transfers from your platform.

Instant Idempotent Webhooks
View Documentation

Collect From User API

Partner collects money from user HooPay wallets with secure user authorization. Great for trading platforms.

User Auth Redirect Flow Webhooks
View Documentation

Additional APIs

Supporting APIs for complete integration

Wallet Verification

Verify wallet IDs before transactions

Learn More →

Refunds API

Reverse payments or failed collections

Learn More →

Fees API

Get fee schedules and calculate fees

Learn More →

Webhooks

Real-time event notifications

Learn More →

Get Started in Minutes

Follow these simple steps to integrate HooPay into your platform.

1

Get Your API Credentials

Register as a partner and receive your sandbox API key and secret.

# Your credentials
API_KEY="hpk_sandbox_..."
API_SECRET="hps_sandbox_..."
2

Generate HMAC Signature

Sign your requests with HMAC-SHA256 using your API secret.

# Python example
import hmac, hashlib, json

def sign_request(payload, secret):
    canonical = json.dumps(payload, separators=(',', ':'), sort_keys=True)
    return hmac.new(
        secret.encode(),
        canonical.encode(),
        hashlib.sha256
    ).hexdigest()
3

Make Your First API Call

Pay money to a user wallet.

# Response
{
  "success": true,
  "data": {
    "payment_id": "pay_abc123xyz789",
    "reference_id": "DEP-001",
    "status": "completed",
    "amount": 100.00
  }
}
4

Handle Webhooks

Receive real-time notifications when transactions complete.

# Webhook payload
{
  "event": "payment.completed",
  "data": {
    "payment_id": "pay_abc123xyz789",
    "amount": 100.00,
    "status": "completed"
  }
}

Developer Tools

Resources to help you build faster.

Complete API Documentation (PDF)

Comprehensive guide covering all APIs, authentication, webhooks, and best practices

Download PDF