Single USD Payout

Disburse into Nigeria in USD

To send money to a single bank account, you need a single API. This process requires an active balance where the funds are debited then sent.

Setup an Active Balance for your payouts here

Disburse USD - Single

POST https://staging.moneywaveapp.com/v1/disburse

Destination and transfer details are passed for processing

Headers

Name	Type	Description
Authorization	string	Authorization Token

Request Body

Name	Type	Description
x_purpose	string	Payment reason or purpose
x_sender_name	string	Sender Name
x_answer	string	Required for CASHPICKUP
x_secret	string	Required for CASHPICKUP
x_transfer_type	string	ACCOUNT or CASHPICKUP
x_sender_location	string	Sender Country
x_sender_address	string	Sender Address
x_sender_phone	string	Sender Phone Number
x_sender_email	string	Sender Name
x_routing_number	string	Routing Number
x_recipient_address	string	Beneficiary address
x_recipient_email	string	Beneficiary Email
x_recipient_phone	string	Beneficiary Phone Number
x_recipient_name	string	Beneficiary Name
walletUref	string	Specify the source balance
narration	string	Description to appear in bank Statement
ref	string	Unique transaction tracking reference
amount	number	Amount to send
currency	string	Currency of amount to send i.e USD
bankcode	string	Destination Bank
accountNumber	string	Beneficiary account number. For CASHPICKUP pass 0
senderName	string	Sender/Business Name to appear in the bank statement
lock	string	Password required to access active wallet

200

{
  "status": "success",
  "data": {
    "data": {
      "responsecode": "00",
      "responsemessage": "Approved Or Completed Successfully",
      "uniquereference": "TMW000000319"
    },
    "status": "success"
  } 
}

Sample Code

Select a Language above ...

NODE.JS

var unirest = require("unirest");
var base_url = "https://staging.moneywaveapp.com";
var req = unirest("POST", `${base_url}/v1/disburse`);

req.headers({
  "Authorization": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MSwibmFtZSI6IlRocml2ZSIsImFjY291bnROdW1iZXIiOiIwNjkwMDAwMDAiLCJiYW5rQ29kZSI6IjMwNyIsImlzQWN0aXZlIjp0cnVlLCJlbnZpcm9ubWVudCI6ImxpdmUiLCJjYW5fZ29saXZlIjp0cnVlLCJjb3VudGRvd24iOm51bGwsImNvbXBsaWFuY2UiOjgsImNvZGUiOiJNTDU4MCIsInBvc0lkIjoiMTE0NjMiLCJlYmlsbElkIjoiTVRGVyIsImlwIjpudWxsLCJjcmVhdGVkQXQiOiIyMDE2LTA5LTE2VDEzOjQ5OjIzLjAwMFoiLCJ1cGRhdGVkQXQiOiIyMDE3LTA3LTE5VDE0OjA2OjM2LjAwMFoiLCJkZWxldGVkQXQiOm51bGwsImlhdCI6MTUzMDIxMTc4MiwiZXhwIjoxNTMwMjE4OTgyfQ.gQDK03I9Jc0dO21RxsZjG0k4Px0NzTk4tRnkbV5VciU",
  "Content-Type": "application/json"
});
req.type("json");
req.send({
	"ref": "SD252849857",
	"amount": "50",
	"currency": "USD",
	"bankcode": "057",
	"accountNumber": "0600000004",
	"senderName": "ABCompany",
	"lock": "walpassword",
	"narration": "Equipments",
	"x_recipient_name": "OLUWAFEMI DAYO",
	"x_recipient_phone": "[phone]",
	"x_recipient_email": "[e-mail]",
	"x_recipient_address": "99, ABC DRIVE",
	"x_purpose": "Family support",
	"x_routing_number": "057",
	"x_sender_name": "ABC JOHN",
	"x_sender_email": "[e-mail]",
	"x_sender_phone": "[phone]",
	"x_sender_address": "10 ABC DRIVE, N/A, N/A, UNITED KINGDOM",
	"x_sender_location": "GB",
	"x_transfer_type": "ACCOUNT",
});

req.end(function (res) {
  if (res.error) console.log(res.code, res.body);
  else console.log(res.body);
});

PHP

<?php

$curl = curl_init();
$base_url = "https://staging.moneywaveapp.com";
$header = array(
  "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MSwibmFtZSI6IlRocml2ZSIsImFjY291bnROdW1iZXIiOiIwNjkwMDAwMDAiLCJiYW5rQ29kZSI6IjMwNyIsImlzQWN0aXZlIjp0cnVlLCJlbnZpcm9ubWVudCI6ImxpdmUiLCJjYW5fZ29saXZlIjp0cnVlLCJjb3VudGRvd24iOm51bGwsImNvbXBsaWFuY2UiOjgsImNvZGUiOiJNTDU4MCIsInBvc0lkIjoiMTE0NjMiLCJlYmlsbElkIjoiTVRGVyIsImlwIjpudWxsLCJjcmVhdGVkQXQiOiIyMDE2LTA5LTE2VDEzOjQ5OjIzLjAwMFoiLCJ1cGRhdGVkQXQiOiIyMDE3LTA3LTE5VDE0OjA2OjM2LjAwMFoiLCJkZWxldGVkQXQiOm51bGwsImlhdCI6MTUzMDIxMDY4MywiZXhwIjoxNTMwMjE3ODgzfQ.IO4iX_estdWbe2dHey27bj5xsZC0skXHGdFUMTQSJfI",
  "Content-Type: application/json",
);

$body = array(
  "ref" => "SD252849857",
  "amount" => "50",
  "currency" => "USD",
  "bankcode" => "044",
  "accountNumber" => "0600000004",
  "senderName" => "ABCompany",
  "lock" => "walpassword",
  "narration" => "Equipments",
  "x_recipient_name" => "OLUWAFEMI DAYO",
	"x_recipient_phone" => "[phone]",
	"x_recipient_email" => "[e-mail]",
	"x_recipient_address" => "99, ABC DRIVE",
	"x_purpose" => "Family support",
	"x_routing_number" => "057",
	"x_sender_name" => "ABC JOHN",
	"x_sender_email" => "[e-mail]",
	"x_sender_phone" => "[phone]",
	"x_sender_address" => "10 ABC DRIVE, N/A, N/A, UNITED KINGDOM",
	"x_sender_location" => "GB",
	"x_transfer_type" => "ACCOUNT",
);

curl_setopt_array($curl, array(
  CURLOPT_URL => $base_url . "/v1/disburse",
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 180,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_POSTFIELDS => json_encode($body),
  CURLOPT_HTTPHEADER => $header,
));

$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);


if ($err) {
  echo "cURL Error #:" . $err;
} else {
  $decodedResponse = json_decode($response, true);

  echo "<pre>"; print_r($decodedResponse);
}

Please note additional parameters may be required by specific banks. For example payouts to FCMB require the following parameters - recipientRelationship, recipientOccupataion, senderOccupation and purpose

The ref passed must be unique to prevent double disbursements to the same beneficiary. Preferably the ref used should match a unique customer action, for example a loan ID, settlement ID or charge / payment reference.

Increase timeout settings in your http client to 180 seconds. This ensures you receive an expected response for payouts with long processing times.

Confirming Success

After a disburse request is received via API, it is submitted for processing. When completed a response is returned. See the example response in the API snippet above.

A disbursement is successful only when the disburse API response has the value below.

"responsecode" : "00"

Some USD payouts are asynchronous and would return a response code of 02 indicating Transaction Processing. To receive notification when completed see here