💎 ReyPub API Documentation

Overview

ReyPub is a modern wallet and internal debit card payment system. Businesses can accept payments from ReyPub users through two methods:

Base URL

https://reypub.pages.dev/api

All API endpoints are relative to this base URL.

Authentication

All payment API calls require your business API keys sent as request headers:

Getting API Keys

Quick Start

Example: Card Payment (cURL)

curl -X POST https://reypub.pages.dev/api/payment/card \
  -H "Content-Type: application/json" \
  -H "X-ReyPub-Key: rpub_pk_your_public_key" \
  -H "X-ReyPub-Secret: rpub_sk_your_secret_key" \
  -d '{
    "card_number": "4532XXXXXXXXXXXX",
    "cvv": "123",
    "expiry_month": 12,
    "expiry_year": 2028,
    "amount": 29.99,
    "order_id": "ORD-001",
    "description": "Premium Plan"
  }'

Example: Wallet Payment (JavaScript)

const response = await fetch('https://reypub.pages.dev/api/payment/wallet', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-ReyPub-Key': 'rpub_pk_your_public_key',
    'X-ReyPub-Secret': 'rpub_sk_your_secret_key'
  },
  body: JSON.stringify({
    user_account_id: '2045678901',  // User's account number
    amount: 49.99,
    order_id: 'ORD-002',
    description: 'Monthly subscription'
  })
});
const data = await response.json();
console.log(data.data.transaction_id); // "pay_xxxx_xxxx"

Wallet Payment

Request payment from a user's wallet. The user receives a notification and has 5 minutes to approve or reject.

Request Body

Success Response

{
  "success": true,
  "data": {
    "transaction_id": "pay_m4x3k_a1b2c3d4",
    "status": "pending",
    "expires_at": "2026-03-19T12:05:00.000Z",
    "message": "Payment request sent to user. Awaiting approval (5 minute window)."
  },
  "message": "Payment request created"
}

Payment Flow

Card Payment

Process an instant payment using the user's ReyPub debit card. No email or account ID needed - just the card details. Balance is verified first, then deducted.

Request Body

Success Response

{
  "success": true,
  "data": {
    "transaction_id": "cpay_m4x3k_a1b2c3d4",
    "status": "completed",
    "amount": 29.99,
    "fee": 0.75,
    "net_amount": 29.24,
    "currency": "USD",
    "order_id": "ORD-001",
    "card_last_four": "4521"
  },
  "message": "Card payment processed successfully"
}

Verification Steps (automatic)

Payment Status

Possible Statuses

Refunds

Request Body

curl -X POST https://reypub.pages.dev/api/payment/refund \
  -H "Content-Type: application/json" \
  -H "X-ReyPub-Key: rpub_pk_your_key" \
  -H "X-ReyPub-Secret: rpub_sk_your_secret" \
  -d '{
    "transaction_id": "cpay_m4x3k_a1b2c3d4",
    "amount": 10.00,
    "reason": "Customer request"
  }'

Account Numbers

Every ReyPub user has a unique 10-digit account number assigned at registration. This is used for:

• Wallet Payments: Identify the payer in /api/payment/wallet
• P2P Transfers: Users send money to each other using account numbers
• Account Identification: Displayed in the client dashboard for easy sharing

Card PIN System

Every ReyPub debit card is protected by a 6-digit PIN. Users must set a PIN after card issuance and enter it to view their card details in the dashboard.

How it works:

Webhooks

Set your webhook URL in the Business Portal settings. ReyPub will send POST requests for payment events.

Events

Webhook Payload

{
  "event": "payment.success",
  "transaction_id": "cpay_m4x3k_a1b2c3d4",
  "order_id": "ORD-001",
  "amount": 29.99,
  "currency": "USD",
  "status": "completed",
  "timestamp": "2026-03-19T12:00:00.000Z",
  "signature": "hmac_sha256_signature"
}

Verify the X-ReyPub-Signature header using HMAC-SHA256 of the request body with your secret key.

Error Codes

Error Response Format

{
  "success": false,
  "error": "Insufficient funds. Available balance: $150.00"
}

Rate Limits

API requests are limited to 120 requests per minute per IP address. If exceeded, you'll receive a 429 Too Many Requests response.

Integration Examples

Python

import requests

headers = {
    "Content-Type": "application/json",
    "X-ReyPub-Key": "rpub_pk_your_key",
    "X-ReyPub-Secret": "rpub_sk_your_secret"
}

# Card Payment
resp = requests.post("https://reypub.pages.dev/api/payment/card", json={
    "card_number": "4532XXXXXXXXXXXX",
    "cvv": "123",
    "expiry_month": 12,
    "expiry_year": 2028,
    "amount": 29.99,
    "order_id": "ORD-001"
}, headers=headers)

print(resp.json())

PHP

$ch = curl_init('https://reypub.pages.dev/api/payment/card');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'X-ReyPub-Key: rpub_pk_your_key',
        'X-ReyPub-Secret: rpub_sk_your_secret',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'card_number' => '4532XXXXXXXXXXXX',
        'cvv' => '123',
        'expiry_month' => 12,
        'expiry_year' => 2028,
        'amount' => 29.99,
        'order_id' => 'ORD-001',
    ])
]);
$response = json_decode(curl_exec($ch), true);

Node.js

const response = await fetch('https://reypub.pages.dev/api/payment/card', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-ReyPub-Key': 'rpub_pk_your_key',
    'X-ReyPub-Secret': 'rpub_sk_your_secret'
  },
  body: JSON.stringify({
    card_number: '4532XXXXXXXXXXXX',
    cvv: '123',
    expiry_month: 12,
    expiry_year: 2028,
    amount: 29.99,
    order_id: 'ORD-001'
  })
});
const data = await response.json();