Overview

Maplerad's Transfers API empowers your business to make transfers to different financial institutions and payment methods via a single call.

Supported Transfer Methods

We currently support:

Naira Bank Transfer
Nigerian Domiciliary (USD) Transfer
Nigerian Cash Pickup (USD) Transfer
Francophone Mobile Money Transfer
Maplerad Wallet Transfer (Transfer from one business wallet to another)

{
    "bank_code":"059",
    "account_number":"0690000000",
    "amount": 55000,
    "currency": "NGN"
}

{
	"bank_code": "111",
	"account_number": "0123456789", // counterparty DOM account number
	"amount": 1000,
	"reason": "enjoy",
	"currency": "USD",
	"reference": "maplerad_reference000007637621364", // set your reference
	"meta": {
		"scheme": "DOM",
		"sender": {
			"first_name": "John",
			"last_name": "Doe",
			"phone_number": "08202020202",
			"address": "Lagos, Nigeria",
			"country": "NG"
		},
		"counterparty": {
			"first_name": "Jane",
			"last_name": "Doe",
			"address": "Ibadan, Nigeria",
			"phone_number": "+2348000000000",
			"identity_type": "",  // optional
			"country": "NG"
		}
	}
}

{
	"bank_code": "111",
	"account_number": "0000000000", // default account number. Should always be this
	"amount": 1000,
	"reason": "enjoy",
	"currency": "USD",
	"reference": "maplerad_reference000007637621364", // your transfer reference
	"meta": {
		"scheme": "CASHPICKUP",
		"sender": {
			"first_name": "John",
			"last_name": "Doe",
			"phone_number": "08202020202",
			"address": "Lagos, Nigeria",
			"country": "NG"
		},
		"counterparty": {
			"first_name": "Jane",
			"last_name": "Doe",
			"address": "Ibadan, Nigeria",
			"phone_number": "+2348000000000",
			"identity_type": "", // optional
			"country": "NG"
		}
	}
}

{
	"bank_code": "531",
	"account_number": "237000000000",
	"amount": 50000,
	"reason": "enjoy",
	"currency": "XAF",
	"reference": "mapleruad_refer777",
	"meta": {
		"scheme": "MOBILEMONEY",
		"counterparty": {
			"name": "John Snow"
		}
	}
}

📘
Kindly ensure you configure your Webhook URL to receive the status of a transfer.

{
  "event": "transfer.successful",
  "id": "8da60fd7-473b-4a02-bc12-12a9d136147e",
  "reference": null,
  "status": "SUCCESS",
  "created_at": "2022-07-02 00:49:34.8221 -0500 CDT",
  "updated_at": "2022-07-02 00:49:34.8221 -0500 CDT"
}

{
  "event": "transfer.failed",
  "id": "8da60fd7-473b-4a02-bc12-12a9d136147e",
  "reference": null,
  "status": "FAILED",
  "created_at": "2022-07-02 00:49:34.8221 -0500 CDT",
  "updated_at": "2022-07-02 00:49:34.8221 -0500 CDT"
}