AjePay — Blockchain Payment Gateway

Overview

Create a business to start accepting AjeCoin payments.

🏢

No businesses yet

Add your first business to generate API keys and a merchant wallet address for accepting AJE payments.

Transactions

All incoming AJE payments to your merchant wallet address.

Date & Time	From Address	Amount	Type	Status
Select a business to view transactions.

Settings

Manage your business profile, API keys, webhooks, and payout account.

Business Profile

This information represents your business to customers during checkout.

Business Name

Website URL

Description

API Keys

Use these keys to authenticate your integration with AjePay.

📌 Where to find your keys

Keys are automatically generated when you create a business on AjePay — no manual setup needed.
Your Public Key goes in your frontend HTML/JS code and the AjePay widget script tag.
Your Secret Key goes in your backend server only (PHP, Node.js, Python). It authorises invoice creation.
Your Merchant Address is the on-chain AJE wallet address customers send payments to.
To get keys for a different project, simply add another business from the sidebar.

Public Key — Safe to use in frontend

—

Secret Key — Server-side only, never expose publicly

sk_live_••••••••••••••••••

Merchant Wallet Address — Customers send AJE here

—

Webhook Endpoint

AjePay sends a POST request to your endpoint when a payment is confirmed on-chain. Use this to grant access, activate subscriptions, or update your database.

Webhook URL Must be a publicly accessible HTTPS URL.

Redirect / Success URL Where to redirect the customer after a successful payment.

Webhook Secret

Use this to verify that webhook calls originate from AjePay. Compare it with the x-ajepay-signature header on incoming requests.

Webhook Signing Secret

whsec_••••••••••••••••••

Events

Choose which events trigger a webhook notification.

payment.confirmed — fired when AJE payment is verified on-chain payment.expired — invoice expired without payment

Bank Payout Account

Link your Nigerian bank account to withdraw AJE earnings to NGN. Withdrawals are processed as bank transfers.

Bank Name

Account Number

Account Name

AJE Merchant Wallet

Your AjeChain wallet address where all customer payments are received. This is a non-custodial wallet — AjePay never holds your funds.

Wallet Address (Public — Share with customers)

—

Public Key

—

🔐 Private Key & Recovery Phrase

Your private key was shown once during registration via the recovery phrase (12 words). To import your wallet into any AjeChain-compatible app, use that phrase. AjePay does not store your private key in a recoverable form.

Integration Guide

Add AjePay checkout to any website or app in minutes.

⚡ How the Payment Flow Works

AjePay uses the AjeChain ledger for settlement. The flow is:

1. Your server creates an invoice (using your Secret Key) → gets an invoiceId.
2. You launch the AjePay checkout modal in the customer's browser with the invoiceId.
3. The modal shows your Merchant Address and the amount. The customer transfers AJE from their wallet to your address.
4. AjePay polls the AjeChain ledger, detects the transaction, and fires your webhook.
5. Your server receives the webhook → grants the customer access.

Step 1 — Store your credentials

<?php
// config.php — keep this file server-side only
define('AJEPAY_SECRET',   'sk_live_YOUR_SECRET_KEY');
define('AJEPAY_GATEWAY',  'http://localhost:3005');   // your AjePay gateway URL
define('MERCHANT_ADDRESS','AJE_YOUR_MERCHANT_ADDRESS');
?>

Step 2 — Create an invoice (server-side)

Call the AjePay gateway from your backend. Never call it from JavaScript in the browser with your secret key.

<?php
require 'config.php';

function createInvoice(string $userId, string $amount, string $item): array {
    $ch = curl_init(AJEPAY_GATEWAY . '/gateway/invoice/create');
    curl_setopt_array($ch, [
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => json_encode([
            'merchantAddress' => MERCHANT_ADDRESS,
            'amount'          => $amount,
            'item'            => $item,
        ]),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER     => [
            'Content-Type: application/json',
            'x-ajepay-key: ' . AJEPAY_SECRET,
        ],
    ]);
    $data = json_decode(curl_exec($ch), true);
    curl_close($ch);
    return $data; // contains invoiceId, amount, merchantAddress
}

// Usage in your checkout route:
$invoice = createInvoice($_SESSION['user_id'], '5.00', 'Premium Subscription');
echo json_encode(['invoiceId' => $invoice['invoiceId']]);
?>

Step 3 — Show the checkout modal (frontend)

Add the AjePay widget to any HTML page. Pass the invoiceId from Step 2.

<!-- Add widget script to your page -->
<script src="http://localhost:3005/ajepay-widget.js"></script>

<!-- Trigger checkout -->
<button onclick="AjePay.openCheckout('{{ $invoiceId }}')">
  Pay with AJE ⚡
</button>

Step 4 — Receive the webhook

When the customer sends AJE to your merchant address, AjePay confirms it on-chain and calls your webhook URL.

<?php
// webhook.php
$raw     = file_get_contents('php://input');
$payload = json_decode($raw, true);

if ($payload['event'] === 'payment.confirmed') {
    $invoice = $payload['invoice'];
    $userId  = $invoice['userId'];
    $amount  = $invoice['amount']; // AJE amount received

    // Grant access in your database
    grantUserAccess($userId);

    http_response_code(200);
    echo 'OK';
}

function grantUserAccess(string $userId): void {
    // e.g. UPDATE users SET is_premium = 1 WHERE id = ?
}
?>

Step 1 — Get the invoice from your backend

Your backend creates the invoice using the Secret Key, then returns just the invoiceId to the browser.

// Your backend endpoint (Node/PHP/Python) creates the invoice
// and returns: { invoiceId: 'INV-XXXXXXXX', amount: '5.00', ... }
const res     = await fetch('/api/create-invoice', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ item: 'Premium Plan', amount: '5.00' }),
});
const { invoiceId } = await res.json();

Step 2 — Open the checkout modal

<!DOCTYPE html>
<html>
<head>
  <script src="http://localhost:3005/ajepay-widget.js"></script>
</head>
<body>
  <button id="pay-btn">⚡ Pay with AjeCoin</button>

  <script>
    document.getElementById('pay-btn').addEventListener('click', async () => {
      const { invoiceId } = await getInvoiceFromBackend();

      AjePay.openCheckout(invoiceId, {
        onSuccess(invoice) {
          console.log('Payment confirmed!', invoice.paymentTxId);
          window.location.href = '/dashboard'; // redirect on success
        },
        onClose() { console.log('User dismissed checkout'); }
      });
    });
  </script>
</body>
</html>

Step 1 — Environment setup

# .env
AJEPAY_SECRET=sk_live_YOUR_SECRET_KEY
AJEPAY_GATEWAY=http://localhost:3005
MERCHANT_ADDRESS=AJE_YOUR_MERCHANT_ADDRESS

Step 2 — Create invoice & webhook handler (Express)

const express = require('express');
require('dotenv').config();
const app = express();
app.use(express.json());

// POST /api/create-invoice
app.post('/api/create-invoice', async (req, res) => {
  const { item, amount } = req.body;

  const response = await fetch(`${process.env.AJEPAY_GATEWAY}/gateway/invoice/create`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-ajepay-key': process.env.AJEPAY_SECRET,
    },
    body: JSON.stringify({
      merchantAddress: process.env.MERCHANT_ADDRESS,
      amount,
      item,
    }),
  });
  const invoice = await response.json();
  res.json({ invoiceId: invoice.invoiceId });
});

// POST /webhook/ajepay
app.post('/webhook/ajepay', (req, res) => {
  const { event, invoice } = req.body;
  if (event === 'payment.confirmed') {
    console.log(`✅ ${invoice.amount} AJE received | TxID: ${invoice.paymentTxId}`);
    // Grant access: db.grantAccess(invoice.userId)
  }
  res.sendStatus(200);
});

app.listen(4000);

Step 1 — Configuration

import os, requests

AJEPAY_SECRET   = os.environ['AJEPAY_SECRET']    # sk_live_...
AJEPAY_GATEWAY  = os.environ['AJEPAY_GATEWAY']   # http://localhost:3005
MERCHANT_ADDRESS = os.environ['MERCHANT_ADDRESS'] # AJE_...

Step 2 — Create invoice

def create_invoice(amount: str, item: str) -> dict:
    resp = requests.post(
        f"{AJEPAY_GATEWAY}/gateway/invoice/create",
        json={"merchantAddress": MERCHANT_ADDRESS, "amount": amount, "item": item},
        headers={"x-ajepay-key": AJEPAY_SECRET},
        timeout=10,
    )
    resp.raise_for_status()
    return resp.json()  # { invoiceId, amount, merchantAddress, ... }

Step 3 — Django / Flask webhook

# Flask
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/webhook/ajepay', methods=['POST'])
def ajepay_webhook():
    data    = request.get_json()
    if data.get('event') == 'payment.confirmed':
        invoice = data['invoice']
        amount  = invoice['amount']
        tx_id   = invoice['paymentTxId']
        print(f"✅ {amount} AJE received — TxID: {tx_id}")
        # grant_user_access(invoice['userId'])
    return jsonify(ok=True), 200

Your Secret Recovery Phrase

No businesses yet

🔑 API Keys & Merchant Address

🚰 Developer Faucet

Business Profile

API Keys

Webhook Endpoint

Webhook Secret

Events

Bank Payout Account

AJE Merchant Wallet

Step 1 — Store your credentials

Step 2 — Create an invoice (server-side)

Step 3 — Show the checkout modal (frontend)

Step 4 — Receive the webhook

Step 1 — Get the invoice from your backend

Step 2 — Open the checkout modal

Step 1 — Environment setup

Step 2 — Create invoice & webhook handler (Express)

Step 1 — Configuration

Step 2 — Create invoice

Step 3 — Django / Flask webhook

Your Secret Recovery Phrase

No businesses yet

🔑 API Keys & Merchant Address

🚰 Developer Faucet

Business Profile

API Keys

Webhook Endpoint

Webhook Secret

Events

Bank Payout Account

AJE Merchant Wallet

Step 1 — Store your credentials

Step 2 — Create an invoice (server-side)

Step 3 — Show the checkout modal (frontend)

Step 4 — Receive the webhook

Step 1 — Get the invoice from your backend

Step 2 — Open the checkout modal

Step 1 — Environment setup

Step 2 — Create invoice & webhook handler (Express)

Step 1 — Configuration

Step 2 — Create invoice

Step 3 — Django / Flask webhook

Add New Business

Premium Access

Verify Your Email