Nigeria FCMB Domiciliary Account

Quote an FCMB domiciliary account payout.

Method	POST
URL	/api/m1/initiate-transfer
Auth	Bearer ZMPRO-… (live) or ZMDEV-… (test)

Headers

Header	Value
Authorization	Bearer ZMPRO-your-live-api-key
Content-Type	application/json

Request

cURL

curl -X POST 'https://api.vizo.app/api/m1/initiate-transfer' \
  -H 'Authorization: Bearer ZMPRO-your-live-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
  "which_balance": "NGN",
  "account": "0690000040",
  "account_bank": "044",
  "account_name": "John Doe",
  "amount": "1000",
  "transfer_mode": "bank",
  "currency": "USD",
  "narration": "food",
  "callback_url": "https://dev.zupago.app:8086/test-dev/ccccc",
  "reference": "MCH-11011",
  "meta": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "email": "John@John.com",
      "beneficiary_country": "NG",
      "mobile_number": "234812345678",
      "merchant_name": "GG Computer",
      "beneficiary_occupation": "It",
      "recipient_address": "19, Iv, VGC",
      "sender": "Dayo John",
      "sender_country": "NG",
      "sender_id_number": "00000000000",
      "sender_id_type": "drivers license",
      "sender_id_expiry": "12-2023",
      "sender_mobile_number": "2348000000000",
      "sender_address": "10, comupter village, Ikeja",
      "sender_occupation": "Engineer",
      "sender_beneficiary_relationship": "supplier",
      "transfer_purpose": "payment"
    }
  ]
}'

TypeScript

const response = await fetch('https://api.vizo.app/api/m1/initiate-transfer', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ZMPRO-your-live-api-key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "which_balance": "NGN",
  "account": "0690000040",
  "account_bank": "044",
  "account_name": "John Doe",
  "amount": "1000",
  "transfer_mode": "bank",
  "currency": "USD",
  "narration": "food",
  "callback_url": "https://dev.zupago.app:8086/test-dev/ccccc",
  "reference": "MCH-11011",
  "meta": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "email": "John@John.com",
      "beneficiary_country": "NG",
      "mobile_number": "234812345678",
      "merchant_name": "GG Computer",
      "beneficiary_occupation": "It",
      "recipient_address": "19, Iv, VGC",
      "sender": "Dayo John",
      "sender_country": "NG",
      "sender_id_number": "00000000000",
      "sender_id_type": "drivers license",
      "sender_id_expiry": "12-2023",
      "sender_mobile_number": "2348000000000",
      "sender_address": "10, comupter village, Ikeja",
      "sender_occupation": "Engineer",
      "sender_beneficiary_relationship": "supplier",
      "transfer_purpose": "payment"
    }
  ]
}),
});

const data = await response.json();
console.log(data);

Python

import requests

url = "https://api.vizo.app/api/m1/initiate-transfer"
headers = {
    "Authorization": "Bearer ZMPRO-your-live-api-key",
    "Content-Type": "application/json",
}
payload = {
  "which_balance": "NGN",
  "account": "0690000040",
  "account_bank": "044",
  "account_name": "John Doe",
  "amount": "1000",
  "transfer_mode": "bank",
  "currency": "USD",
  "narration": "food",
  "callback_url": "https://dev.zupago.app:8086/test-dev/ccccc",
  "reference": "MCH-11011",
  "meta": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "email": "John@John.com",
      "beneficiary_country": "NG",
      "mobile_number": "234812345678",
      "merchant_name": "GG Computer",
      "beneficiary_occupation": "It",
      "recipient_address": "19, Iv, VGC",
      "sender": "Dayo John",
      "sender_country": "NG",
      "sender_id_number": "00000000000",
      "sender_id_type": "drivers license",
      "sender_id_expiry": "12-2023",
      "sender_mobile_number": "2348000000000",
      "sender_address": "10, comupter village, Ikeja",
      "sender_occupation": "Engineer",
      "sender_beneficiary_relationship": "supplier",
      "transfer_purpose": "payment"
    }
  ]
}

response = requests.request("POST", url, headers=headers, json=payload)
print(response.status_code)
print(response.json())

PHP

<?php

$ch = curl_init('https://api.vizo.app/api/m1/initiate-transfer');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ZMPRO-your-live-api-key',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'which_balance' => 'NGN',
        'account' => '0690000040',
        'account_bank' => '044',
        'account_name' => 'John Doe',
        'amount' => '1000',
        'transfer_mode' => 'bank',
        'currency' => 'USD',
        'narration' => 'food',
        'callback_url' => 'https://dev.zupago.app:8086/test-dev/ccccc',
        'reference' => 'MCH-11011',
        'meta' => [
            [
                'first_name' => 'John',
                'last_name' => 'Doe',
                'email' => 'John@John.com',
                'beneficiary_country' => 'NG',
                'mobile_number' => '234812345678',
                'merchant_name' => 'GG Computer',
                'beneficiary_occupation' => 'It',
                'recipient_address' => '19, Iv, VGC',
                'sender' => 'Dayo John',
                'sender_country' => 'NG',
                'sender_id_number' => '00000000000',
                'sender_id_type' => 'drivers license',
                'sender_id_expiry' => '12-2023',
                'sender_mobile_number' => '2348000000000',
                'sender_address' => '10, comupter village, Ikeja',
                'sender_occupation' => 'Engineer',
                'sender_beneficiary_relationship' => 'supplier',
                'transfer_purpose' => 'payment'
            ]
        ]
    ], JSON_UNESCAPED_SLASHES),
]);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo $status, PHP_EOL, $response, PHP_EOL;

Response envelope

{
  "status": "SUCCESS",
  "data": {},
  "message": "Success"
}