API Overview

Welcome to the HooPay Partner API. This guide will help you integrate pay-user and collect-from-user operations into your platform.

Base URL

Production & Sandbox

https://hoopaywallet.com/api/v1/partner

Note: Use sandbox API keys (hpk_sandbox_...) for testing, production keys (hpk_prod_...) for live transactions.

Core APIs

Pay User API

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

POST /pay-user

Collect From User API

Partner collects money from user HooPay wallets. Great for trading platforms and service funding.

POST /collect-from-user

Additional APIs

Refunds API

Reverse completed transactions

Fees API

Calculate fees before transactions

Quick Example

Here's how to pay a user:

cURL

curl -X POST https://hoopaywallet.com/api/v1/partner/pay-user \
  -H "Content-Type: application/json" \
  -H "X-API-Key: hpk_sandbox_your_key" \
  -H "X-Signature: your_hmac_signature" \
  -d '{
    "reference_id": "DEP-001",
    "user_wallet_id": "310146",
    "amount": "100.00",
    "currency": "USD",
    "description": "Partner payout"
  }'

Response

JSON Response

{
  "success": true,
  "data": {
    "payment_id": "pay_abc123xyz",
    "reference_id": "DEP-001",
    "status": "pending_settlement",
    "amount": "100.00",
    "currency": "USD",
    "created_at": "2025-11-27T10:30:00Z"
  }
}

Next Steps

1 Set up authentication with API keys and HMAC signatures
2 Choose an API: Pay User or Collect From User
3 Implement webhooks to receive real-time notifications

Next Authentication