REST API v2

Build with the MyroPay API

Powerful, reliable, and easy-to-use APIs to integrate seamless payments into your products and services.

View Documentation API Playground

API Capabilities

A Complete Toolkit for Modern Payments

Everything you need to build a world-class payment experience.

Accept Payments

Integrate cards, bank transfers, USSD, and more with a single API endpoint.

Manage Subscriptions

Create and manage recurring billing for your subscription-based services.

Handle Payouts

Send single or bulk payments to bank accounts across Africa and beyond.

Create Payment Links

Generate unique links to collect payments without a website.

Verify Customers

Programmatically verify customer identity using BVN and other KYC checks.

Manage Refunds

Process full or partial refunds for transactions directly via the API.

SDKs & Libraries

Integrate Faster with Our Libraries

Official libraries and community-built SDKs to speed up your development.

API Request Try It!

// npm install myropay-node
const myropay = require('myropay-node')('YOUR_SECRET_KEY');

myropay.charges.create({
  email: "customer@email.com",
  amount: 500000,
});

Response 200 OK

{
  "status": "success",
  "message": "Charge created",
  "data": { ... }
}

API Request Try It!

# pip install myropay
import myropay
myropay.api_key = 'YOUR_SECRET_KEY'

charge = myropay.Charge.create(
    email="customer@email.com",
    amount=500000
)

Response 200 OK

{
  "status": "success",
  "message": "Charge created",
  "data": { ... }
}

API Request Try It!

// composer require myropay/myropay-php
require_once('vendor/autoload.php');
\Myropay\Myropay::setApiKey('YOUR_SECRET_KEY');

$charge = \Myropay\Charge::create([
    'email' => 'customer@email.com',
    'amount' => 500000
]);

Response 200 OK

{
  "status": "success",
  "message": "Charge created",
  "data": { ... }
}

API Request Try It!

# gem install myropay
require 'myropay'
Myropay.api_key = 'YOUR_SECRET_KEY'

charge = Myropay::Charge.create(
    email: 'customer@email.com',
    amount: 500000
)

Response 200 OK

{
  "status": "success",
  "message": "Charge created",
  "data": { ... }
}

API Request Try It!

// Add dependency to pom.xml or build.gradle
import com.myropay.Myropay;
import com.myropay.model.Charge;
import java.util.HashMap;
import java.util.Map;

Myropay.apiKey = "YOUR_SECRET_KEY";

Map<String, Object> params = new HashMap<>();
params.put("email", "customer@email.com");
params.put("amount", 500000);

Charge charge = Charge.create(params);

Response 200 OK

{
  "status": "success",
  "message": "Charge created",
  "data": { ... }
}

Webhooks

Real-time Notifications with Webhooks

Set up webhooks to receive real-time notifications for events like successful payments, failed transactions, and chargebacks. This allows you to automate your workflows and keep your systems in sync.

HMAC-SHA256 5 retries Exponential backoff

                            webhook-handler.js
                            Example
                        

              app.post('/myropay-webhook', (req, res) => {
  const event = req.body;

  switch (event.event) {
    case 'charge.success':
      const session = event.data;
      // Fulfill the purchase...
      break;
    default:
      console.log(`Unhandled event type ${event.event}`);
  }

  res.json({ received: true });
});
                        

Use Cases

Built for Your Use Case

E-commerce Checkout

Create a seamless checkout experience for your online store with our customisable payment gateway.

Subscription Billing

Easily manage recurring payments for your SaaS, content, or membership business.

Marketplace Payouts

Automate payouts to vendors and sellers on your marketplace platform with bulk disbursements.

Social Payments via Link

Generate simple payment links to get paid on social media, messaging apps, or anywhere online.

Secure Escrow Payments

Build trust with your customers by offering secure escrow services for high-value transactions.

Get started in minutes

Ready to start building?

Get free API keys Read the docs

REST API · Webhooks · SDKs · Sandbox environment · 99.97% uptime