Live API Docs

Developer Hub

Build with RESTful APIs, webhooks, SDKs and a full sandbox environment.

API Overview

BytePay exposes REST APIs for payments, payouts, wallet operations and merchant integrations. All requests use JSON and HTTPS.

Base URL: https://bytepay.online/api

Authentication
Authorization: Bearer sk_live_xxxxxxxx
Content-Type: application/json
X-Environment: production | sandbox

Webhooks

Receive real-time notifications for payment success, payout completion and refunds. Verify signatures using your webhook secret.

Webhook payload example
{
  "event": "payment.success",
  "trx_id": "TXNXXXXXXXX",
  "amount": 5000,
  "currency": "NGN",
  "status": "completed"
}

API Documentation

Full reference with examples and error codes.

View Docs

Payment initiation example

POST /api/initiate-payment
curl -X POST https://bytepay.online/api/initiate-payment \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "payment_amount": 10000,
    "currency_code": "NGN",
    "ref_trx": "order_001",
    "customer_email": "buyer@example.com",
    "ipn_url": "https://yoursite.com/webhook"
  }'