Quickstart

This guide takes you from nothing to a working test payment on your website. No real money moves, and you can go live later.

Create your account

Sign up at merchant.afarapartners.com and verify your email address with the 5-digit code we send you. Full steps are in Create your account.

Copy your test public key

Click the gear icon, open API Keys, and copy your Test Public Key. It starts with TPK_. See Get your API keys.

Add the widget to your page

Paste this into your website, replacing the key with yours.

<form id="paymentForm">
  <input type="email" id="email-address" placeholder="Email" required />
  <input type="number" id="amount" placeholder="Amount in Naira" required />
  <button type="submit">Pay now</button>
</form>

<script src="https://sdk.afarapartners.com/omni-payment-gateway-sdk"></script>
<script>
  document.getElementById("paymentForm").addEventListener("submit", function (e) {
    e.preventDefault();
    AfaraPayPop.setup({
      key: "TPK_your_test_public_key",
      email: document.getElementById("email-address").value,
      amount: Math.round(Number(document.getElementById("amount").value) * 100),
      currency: "NGN",
      callback: function (response) {
        alert("Payment complete. Reference: " + response.reference);
      }
    }).openIframe();
  });
</script>

Need it for React or Angular? See Add the payment widget.

Pay with a test card

Open your page, enter an email and an amount, and click Pay now. Choose card and use a test card.

See it in your dashboard

Open Transactions in the merchant portal. Your test payment is listed there.

You have taken a test payment. Next, make your site confirm payments properly, then go live.

Verify a payment

Confirm payments on your server before delivering orders.

Go-live checklist

Everything to check before taking real payments.

Get started

Payment widget

Accept payments

Test and go live

Verify a payment

Go-live checklist