Quickstart - LuminPay Docs

This guide takes you from signing up to creating your first live charge.

Prerequisites

A LuminPay merchant account (sign up here)
Your organization must have completed email verification

Get started

Get your API key

Sign in to your LuminPay dashboard, navigate to API Keys, and generate a new key.Keep this key secret — treat it the same way you would a password.

Create a charge

Make a request to create a charge, authenticating with your API key as a Bearer token.

    curl -X POST https://api.luminpay.co/charges \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "amount": 5000,
        "currency": "NGN"
      }'

Check the charge status

Poll the charge, or configure a webhook endpoint to be notified automatically when it’s paid.

    curl https://api.luminpay.co/charges/{id} \
      -H "Authorization: Bearer YOUR_API_KEY"

Fees and settlement

LuminPay charges a flat 1% per transaction, with no setup or monthly fees. Stablecoin payments settle to your bank account once daily; Bitcoin payments are swept every 5 minutes and settle on the same daily cycle. New accounts start with a ₦50,000 daily limit. Complete identity verification to raise this to ₦500,000/day, or full business verification for unlimited daily volume.

Need help? Reach out to us at support@luminpay.co.

​Prerequisites

​Get started

​Fees and settlement

Prerequisites

Get started

Fees and settlement