Post Execute a Transfer

https://api.magmasend.com/v1/transfer

This allow you to send money to any operator available on Magmasend

Magma Corridors

Country Code	Country Name	Supports Mobile Wallet?	Supports Account Transfer?	Currency
BJ	Benin	Yes	Yes	XOF
CI	Côte d'Ivoire	Yes	Yes	XOF
TG	Togo	Yes	Yes	XOF
SN	Senegal	Yes	Yes	XOF
ML	Mali	Yes	Yes	XOF
BF	Burkina Faso	Yes	Yes	XOF
CM	Cameroun	Yes	Yes	XAF
GH	Ghana	Yes	Yes	GHS
GN	Guinée (Conakry)	Yes	Yes	GNF
SL	Sierra Léone	Yes	No	SLE
KE	Kenya	Yes	No	KES
RDC	Republique Démocratique du Congo	Yes	No	CDF
UG	Ouganda	Yes	No	UGX
GW	Guinée Bissau	No	Yes	GNF
NE	Niger	No	Yes	XOF
CF	Central African Republic	No	Yes	XAF
TD	Chad	No	Yes	XAF
CG	Congo	No	Yes	XAF
GQ	Equatorial Guinea	No	Yes	XAF
GA	Gabon	No	Yes	XAF

Operator Available

Country Name	Opearator	Min amount	Max amount
Côte d'Ivoire	ORANGE_CI, MTN_CI, MOOV_CI, Wave_CI	500	1500000
Togo	MOOV_TG, TMONEY_TG	500	1500000
Senegal	ORANGE_SN, FREE_SN, EXPRESSO_SN, Wave_SN	500	1500000
Mali	ORANGE_ML, MOOV_ML	500	1500000
Burkina Faso	ORANGE_BF, MOOV_BF	500	1500000
Guinée (Conakry)	ORANGE_GN, MTN_GN	500	1500000
Sierra Leone	ORANGE_SL	500	1500000
Cameroun	ORANGE_CM, MTN_CM	500	1500000
Republique Démocratique du Congo	ORANGE_CD	500	1500000
Ghana	AIRTEL_GH, VODAFONE_GH, MTN_GH	500	1500000
Uganda	MTN_UG, AIRTEL_UG	500	1500000
Kenya	AIRTEL_KE	500	1500000

List Bank Short code Supported of Ghana

Short Name	Bank Name	Supported ?
SCB	STANDARD CHARTERED BANK	Yes
BPSL	BESTPOINT SAVINGS AND LOANS	Yes
ABS	ABSA BANK GHANA LIMITED	Yes
GCB	GCB BANK LIMITED	Yes
NIB	NATIONAL INVESTMENT BANK	Yes
ADB	AGRICULTURAL DEVELOPMENT BANK	Yes
UMB	UNIVERSAL MERCHANT BANK	Yes
RPB	REPUBLIC BANK LIMITED	Yes
ZEB	ZENITH BANK GHANA LTD	Yes
ECO	ECOBANK	Yes
CAL	CAL BANK LIMITED	Yes
PBL	PRUDENTIAL BANK LTD	Yes
STB	STANBIC	Yes
GTB	GUARANTY TRUST BANK	Yes
UBA	UNITED BANK OF AFRICA	Yes
ACB	ACCESS BANK LTD	Yes
FNB	FIRST NATIONAL BANK	Yes
FIB	FIDELITY BANK LIMITED	Yes
SISL	SERVICES INTEGRITY SAVINGS & LOANS	Yes
BOA	BANK OF AFRICA	Yes
DFLC	DALEX FINANCE AND LEASING COMPANY	Yes
FBN	FIRST BANK OF NIGERIA	Yes
GHLB	GHL Bank	Yes
BOG	BANK OF GHANA	Yes
FAB	FIRST ATLANTIC BANK	Yes
BSIC	SAHEL - SAHARA BANK (BSIC)	Yes
ABL	ARB APEX BANK LIMITED	Yes
CBG	Consolidated Bank of Ghana	Yes
SG	SOCIETE GENERALE GHANA	Yes

The following operators are also valid :

• MobileMoney : when using it, the api will auto guest the operator for mobile money
• AccountTransfer : this is for banking account transfer
• WAVE : This is for WAVE payment

Status list

Status	Description
PENDING	Transaction is on processing

• Please note that only "SUCCESS" and "FAILED" statuses are final ones, any others are temporary and will be updated as soon as possible

Request Information

Parameter Name	Type	Mandatory	Description
transaction_id	String	Mandatory	Your transaction Id
notify_url	Url	Mandatory	Callback URL, this url will be called after an update on the transaction
operator	String	Mandatory	Delivery Method : MobileMoney for mobile wallet payment or AccountTransfer for wire transfer or WAVE for wave wallet transfer
amount	Integer	Mandatory	Amount the receiver should get
country	ISO2 country	Mandatory	Destination Country
currency	ISO 4217 Currency	Mandatory	Currency of the transfer
phone_number	String	Mandatory only for MobileMoney and Wave	Customer mobile number for wallet payment
receiver_firstname	String	Mandatory	Receiver Firstname
receiver_lastname	String	Mandatory	Receiver Lastname
receiver_bank_name	String	Mandatory only for AccountTransfer	Customer's Bank Name
receiver_bank_address	String	Optional	Customer's Bank Address
receiver_bank_account_number	String	Mandatory only for AccountTransfer	Customer's International Bank Account Number
receiver_bank_sort_code	String	Mandatory only for AccountTransfer	Customer Branch code
receiver_company_name	String	Optional, only for ACCOUNT_TRANSFER	Account Business Name
sender_firstname	String	Mandatory	Sender Firstname
sender_lastname	String	Mandatory	Sender Lastname
sender_phone_number	String	Mandatory for CM	Phone number for sender
sender_address	String	Optional	Sender Address
sender_city	String	Optional	Sender City

HEADERS

Authorization	Bearer TOKEN

Body raw (json)

{
    "country": "CM",
    "operator": "MTN_CM",
    "phone_number": "+237600000000",
    "amount": 500,
    "currency": "XAF",
    "receiver_firstname": "Naruto",
    "receiver_lastname": "Uzumaki",
    "receiver_country": "CM",
    "sender_firstname": "Sasuke",
    "sender_lastname": "Uchiwa",
    "sender_address": "ABIDJAN",
    "sender_city": "ABIDJAN",
    "transaction_id": "3f8dde82-fc51-44cc-8486-7bc81daa3721",
    "notify_url": "https://webhook.site/"
}

Example Request

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'BASEURL/v1/transfer',
  'headers': {
    'Authorization': 'Bearer TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "phone_number": "+2250102020202",
    "operator": "MOOV_CI",
    "amount": 200,
    "currency": "XOF",
    "transaction_id": "1234567890",
    "notify_url": "http://my-url.com",
    "receiver_firstname": "Itachi",
    "receiver_lastname": "Uchiwa"
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Response

{
    "code": "00",
    "status": "PENDING",
    "comment": "Transfer will start soon"
}