Account verification
This endpoints are used to verify account details and pay into accounts (bank or mobile money).
Account Verification
This endpoint identifies the owner of the account.
POST
https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/AccountVerification/
It returns the name of the owner of the bank account or the mobile number. This avoids sending money to the wrong account.
Headers
Name | Type | Description |
---|---|---|
Authorization* | String | Bearer pk_partner_xxx |
Content-Type* | String | application/json |
Request Body
Name | Type | Description |
---|---|---|
account_number* | String | This is the bank account number or phone number the payout will be made to |
account_code* | String | this is the code (eg. 051 fidelity bank or 'Momo' for Mobile money) |
currency* | String | This is the currency of the fiat wallet the withdrawal would be made from e.g GHS, NGN |
signature* | String | Signed Hash of payload. Sign on the digital signature endpoint with just your partner secret |
{
success:true,
message:string,
data:{
account_name:''}
}
{error:true, data:null}
Payout
This endpoint is used to do the actual payout. This does both account verification and payout
POST
https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/Payout/
Transfer to a bank account or mobile money
Headers
Name | Type | Description |
---|---|---|
Authorization* | String | partners public key |
Request Body
Name | Type | Description |
---|---|---|
amount* | String | The amount that is about to be withdrawn |
account_number* | String | The bank account number or mobile money number |
currency* | String | This is the currency of the wallet your are withdrawing from |
withdrawal_reference* | String | This is a string generated from your end to identify the withdrawal |
partner_id* | String | this is your partner id on on the IPC system |
intrapay_merchant_id* | String | This is your merchant ID on the Intrapay platform |
signature* | String | The signature is the request body signed with the merchant secret key + Partner secret key |
account_code* | String | this is the code identifying the bank ("057" for Nigerian Banks )or the mobile money providers (MPESA, MTN, VOD) |
{ "success": true, "message": "Withdrawal initiated. Updates will be provided on callback!!!", "data": null }
Payout Status
This endpoint is to query the status of a payout
GET
https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/GetPayout?intrapay_merchant_id=intra_merchant_954512¤cy=GHS&withdrawal_reference=P17004196996oRbpiHxy/
Transfer to a bank account or mobile money
Query Parameters
Name | Type | Description |
---|---|---|
intrapay_merchant_id* | String | Your intrapay merchant ID |
currency* | String | The currency of the payout request |
withdrawal_reference* | String | The reference of the withdrawal generated on your system |
Headers
Name | Type | Description |
---|---|---|
Authorization* | String | partners public key |
The below is a successful payout response
{
withdrawal_reference: 'P17005609380KKXXYYsS',
amount: 130,
currency: 'GHS',
status: 'COMPLETED',
channel: 'MOMO',
type: 'CREDIT',
customer: { accountName: 'Enoch Peprah', accountNumber: '0542314924' },
network: 'MTN',
created_at: '2023-11-21T10:03:00.568Z',
updated_at: '2023-11-21T10:03:00.568Z'
}
for failed payouts
{
withdrawal_reference: 'P17004196996oRbpiHxy',
amount: undefined,
currency: undefined,
status: undefined,
channel: undefined,
type: undefined,
customer: undefined,
network: undefined,
created_at: undefined,
updated_at: undefined
}
Banks & Bank Codes
[
{
"bank_name": "Access Bank",
"code": "044"
},
{
"bank_name": "Citi Bank",
"code": "023"
},
{
"bank_name": "EcoBank PLC",
"code": "050"
},
{
"bank_name": "First Bank PLC",
"code": "011"
},
{
"bank_name": "First City Monument Bank",
"code": "214"
},
{
"bank_name": "Fidelity Bank",
"code": "070"
},
{
"bank_name": "Guaranty Trust Bank",
"code": "058"
},
{
"bank_name": "Polaris bank",
"code": "076"
},
{
"bank_name": "Stanbic IBTC Bank",
"code": "221"
},
{
"bank_name": "Standard Chaterted bank PLC",
"code": "068"
},
{
"bank_name": "Sterling Bank PLC",
"code": "232"
},
{
"bank_name": "United Bank for Africa",
"code": "033"
},
{
"bank_name": "Union Bank PLC",
"code": "032"
},
{
"bank_name": "Wema Bank PLC",
"code": "035"
},
{
"bank_name": "Zenith bank PLC",
"code": "057"
},
{
"bank_name": "Unity Bank PLC",
"code": "215"
},
{
"bank_name": "ProvidusBank PLC",
"code": "101"
},
{
"bank_name": "Keystone Bank",
"code": "082"
},
{
"bank_name": "Jaiz Bank",
"code": "301"
},
{
"bank_name": "Heritage Bank",
"code": "030"
},
{
"bank_name": "Suntrust Bank",
"code": "100"
},
{
"bank_name": "FINATRUST MICROFINANCE BANK",
"code": "608"
},
{
"bank_name": "Rubies Microfinance Bank",
"code": "090175"
},
{
"bank_name": "Kuda",
"code": "090267"
},
{
"bank_name": "TCF MFB",
"code": "090115"
},
{
"bank_name": "FSDH Merchant Bank",
"code": "400001"
},
{
"bank_name": "Rand merchant Bank",
"code": "502"
},
{
"bank_name": "Globus Bank",
"code": "103"
},
{
"bank_name": "Paga",
"code": "327"
},
{
"bank_name": "Taj Bank Limited",
"code": "000026"
},
{
"bank_name": "GoMoney",
"code": "100022"
},
{
"bank_name": "AMJU Unique Microfinance Bank",
"code": "090180"
},
{
"bank_name": "BRIDGEWAY MICROFINANCE BANK",
"code": "090393"
},
{
"bank_name": "Eyowo MFB",
"code": "090328"
},
{
"bank_name": "Mint-Finex MICROFINANCE BANK",
"code": "090281"
},
{
"bank_name": "Covenant Microfinance Bank",
"code": "070006"
},
{
"bank_name": "VFD Micro Finance Bank",
"code": "090110"
},
{
"bank_name": "PatrickGold Microfinance Bank",
"code": "090317"
},
{
"bank_name": "Sparkle",
"code": "090325"
},
{
"bank_name": "Paycom",
"code": "305"
},
{
"bank_name": "NPF MicroFinance Bank",
"code": "070001"
},
{
"bank_name": "PayAttitude Online",
"code": "110001"
},
{
"bank_name": "Intellifin",
"code": "100027"
},
{
"bank_name": "Contec Global Infotech Limited (NowNow)",
"code": "100032"
},
{
"bank_name": "FCMB Easy Account",
"code": "100031"
},
{
"bank_name": "EcoMobile",
"code": "100030"
},
{
"bank_name": "Innovectives Kesh",
"code": "100029"
},
{
"bank_name": "One Finance",
"code": "100026"
},
{
"bank_name": "Zinternet Nigera Limited",
"code": "100025"
},
{
"bank_name": "TagPay",
"code": "100023"
},
{
"bank_name": "Eartholeum",
"code": "100021"
},
{
"bank_name": "MoneyBox",
"code": "100020"
},
{
"bank_name": "Fidelity Mobile",
"code": "100019"
},
{
"bank_name": "Enterprise Bank",
"code": "000019"
},
{
"bank_name": "Coronation Merchant Bank",
"code": "060001"
},
{
"bank_name": "FBNQUEST Merchant Bank",
"code": "060002"
},
{
"bank_name": "Nova Merchant Bank",
"code": "060003"
},
{
"bank_name": "Omoluabi savings and loans",
"code": "070007"
},
{
"bank_name": "ASOSavings & Loans",
"code": "090001"
},
{
"bank_name": "Trustbond Mortgage Bank",
"code": "090005"
},
{
"bank_name": "SafeTrust",
"code": "090006"
},
{
"bank_name": "FBN Mortgages Limited",
"code": "090107"
},
{
"bank_name": "Imperial Homes Mortgage Bank",
"code": "100024"
},
{
"bank_name": "AG Mortgage Bank",
"code": "100028"
},
{
"bank_name": "Gateway Mortgage Bank",
"code": "070009"
},
{
"bank_name": "Abbey Mortgage Bank",
"code": "070010"
},
{
"bank_name": "Refuge Mortgage Bank",
"code": "070011"
},
{
"bank_name": "Lagos Building Investment Company",
"code": "070012"
},
{
"bank_name": "Platinum Mortgage Bank",
"code": "070013"
},
{
"bank_name": "First Generation Mortgage Bank",
"code": "070014"
},
{
"bank_name": "Brent Mortgage Bank",
"code": "070015"
},
{
"bank_name": "Infinity Trust Mortgage Bank",
"code": "070016"
},
{
"bank_name": "Jubilee-Life Mortgage Bank",
"code": "090003"
},
{
"bank_name": "Haggai Mortgage Bank Limited",
"code": "070017"
},
{
"bank_name": "New Prudential Bank",
"code": "090108"
},
{
"bank_name": "Fortis Microfinance Bank",
"code": "070002"
},
{
"bank_name": "Page Financials",
"code": "070008"
},
{
"bank_name": "Parralex Microfinance bank",
"code": "090004"
},
{
"bank_name": "Ekondo MFB",
"code": "090097"
},
{
"bank_name": "Seed Capital Microfinance Bank",
"code": "090112"
},
{
"bank_name": "Empire trust MFB",
"code": "090114"
},
{
"bank_name": "AMML MFB",
"code": "090116"
},
{
"bank_name": "Boctrust Microfinance Bank",
"code": "090117"
},
{
"bank_name": "IBILE Microfinance Bank",
"code": "090118"
},
{
"bank_name": "Ohafia Microfinance Bank",
"code": "090119"
},
{
"bank_name": "Wetland Microfinance Bank",
"code": "090120"
},
{
"bank_name": "Hasal Microfinance Bank",
"code": "090121"
},
{
"bank_name": "Gowans Microfinance Bank",
"code": "090122"
},
{
"bank_name": "Verite Microfinance Bank",
"code": "090123"
},
{
"bank_name": "Xslnce Microfinance Bank",
"code": "090124"
},
{
"bank_name": "Regent Microfinance Bank",
"code": "090125"
},
{
"bank_name": "Fidfund Microfinance Bank",
"code": "090126"
},
{
"bank_name": "BC Kash Microfinance Bank",
"code": "090127"
},
{
"bank_name": "Ndiorah Microfinance Bank",
"code": "090128"
},
{
"bank_name": "Money Trust Microfinance Bank",
"code": "090129"
},
{
"bank_name": "Consumer Microfinance Bank",
"code": "090130"
},
{
"bank_name": "Allworkers Microfinance Bank",
"code": "090131"
},
{
"bank_name": "Richway Microfinance Bank",
"code": "090132"
},
{
"bank_name": "AL-Barakah Microfinance Bank",
"code": "090133"
},
{
"bank_name": "Accion Microfinance Bank",
"code": "090134"
},
{
"bank_name": "Personal Trust Microfinance Bank",
"code": "090135"
},
{
"bank_name": "Baobab Microfinance Bank",
"code": "090136"
},
{
"bank_name": "PecanTrust Microfinance Bank",
"code": "090137"
},
{
"bank_name": "Royal Exchange Microfinance Bank",
"code": "090138"
},
{
"bank_name": "Visa Microfinance Bank",
"code": "090139"
},
{
"bank_name": "Sagamu Microfinance Bank",
"code": "090140"
},
{
"bank_name": "Chikum Microfinance Bank",
"code": "090141"
},
{
"bank_name": "Yes Microfinance Bank",
"code": "090142"
},
{
"bank_name": "Apeks Microfinance Bank",
"code": "090143"
},
{
"bank_name": "CIT Microfinance Bank",
"code": "090144"
},
{
"bank_name": "Fullrange Microfinance Bank",
"code": "090145"
},
{
"bank_name": "Trident Microfinance Bank",
"code": "090146"
},
{
"bank_name": "Hackman Microfinance Bank",
"code": "090147"
},
{
"bank_name": "Bowen Microfinance Bank",
"code": "090148"
},
{
"bank_name": "IRL Microfinance Bank",
"code": "090149"
},
{
"bank_name": "Virtue Microfinance Bank",
"code": "090150"
},
{
"bank_name": "Mutual Trust Microfinance Bank",
"code": "090151"
},
{
"bank_name": "Nagarta Microfinance Bank",
"code": "090152"
},
{
"bank_name": "FFS Microfinance Bank",
"code": "090153"
},
{
"bank_name": "CEMCS Microfinance Bank",
"code": "090154"
},
{
"bank_name": "La Fayette Microfinance Bank",
"code": "090155"
},
{
"bank_name": "e-Barcs Microfinance Bank",
"code": "090156"
},
{
"bank_name": "Infinity Microfinance Bank",
"code": "090157"
},
{
"bank_name": "Futo Microfinance Bank",
"code": "090158"
},
{
"bank_name": "Credit Afrique Microfinance Bank",
"code": "090159"
},
{
"bank_name": "Addosser Microfinance Bank",
"code": "090160"
},
{
"bank_name": "Okpoga Microfinance Bank",
"code": "090161"
},
{
"bank_name": "Stanford Microfinance Bak",
"code": "090162"
},
{
"bank_name": "First Royal Microfinance Bank",
"code": "090164"
},
{
"bank_name": "Petra Microfinance Bank",
"code": "090165"
},
{
"bank_name": "Eso-E Microfinance Bank",
"code": "090166"
},
{
"bank_name": "Daylight Microfinance Bank",
"code": "090167"
},
{
"bank_name": "Gashua Microfinance Bank",
"code": "090168"
},
{
"bank_name": "Alpha Kapital Microfinance Bank",
"code": "090169"
},
{
"bank_name": "Mainstreet Microfinance Bank",
"code": "090171"
},
{
"bank_name": "Astrapolaris Microfinance Bank",
"code": "090172"
},
{
"bank_name": "Reliance Microfinance Bank",
"code": "090173"
},
{
"bank_name": "Malachy Microfinance Bank",
"code": "090174"
},
{
"bank_name": "HighStreet Microfinance Bank",
"code": "090175"
},
{
"bank_name": "Bosak Microfinance Bank",
"code": "090176"
},
{
"bank_name": "Lapo Microfinance Bank",
"code": "090177"
},
{
"bank_name": "GreenBank Microfinance Bank",
"code": "090178"
},
{
"bank_name": "FAST Microfinance Bank",
"code": "090179"
},
{
"bank_name": "Baines Credit Microfinance Bank",
"code": "090188"
},
{
"bank_name": "Esan Microfinance Bank",
"code": "090189"
},
{
"bank_name": "Mutual Benefits Microfinance Bank",
"code": "090190"
},
{
"bank_name": "KCMB Microfinance Bank",
"code": "090191"
},
{
"bank_name": "Midland Microfinance Bank",
"code": "090192"
},
{
"bank_name": "Unical Microfinance Bank",
"code": "090193"
},
{
"bank_name": "NIRSAL Microfinance Bank",
"code": "090194"
},
{
"bank_name": "Grooming Microfinance Bank",
"code": "090195"
},
{
"bank_name": "Pennywise Microfinance Bank",
"code": "090196"
},
{
"bank_name": "ABU Microfinance Bank",
"code": "090197"
},
{
"bank_name": "RenMoney Microfinance Bank",
"code": "090198"
},
{
"bank_name": "New Dawn Microfinance Bank",
"code": "090205"
},
{
"bank_name": "UNN MFB",
"code": "090251"
},
{
"bank_name": "Imo State Microfinance Bank",
"code": "090258"
},
{
"bank_name": "Alekun Microfinance Bank",
"code": "090259"
},
{
"bank_name": "Above Only Microfinance Bank",
"code": "090260"
},
{
"bank_name": "Quickfund Microfinance Bank",
"code": "090261"
},
{
"bank_name": "Stellas Microfinance Bank",
"code": "090262"
},
{
"bank_name": "Navy Microfinance Bank",
"code": "090263"
},
{
"bank_name": "Auchi Microfinance Bank",
"code": "090264"
},
{
"bank_name": "Lovonus Microfinance Bank",
"code": "090265"
},
{
"bank_name": "Uniben Microfinance Bank",
"code": "090266"
},
{
"bank_name": "Adeyemi College Staff Microfinance Bank",
"code": "090268"
},
{
"bank_name": "Greenville Microfinance Bank",
"code": "090269"
},
{
"bank_name": "AB Microfinance Bank",
"code": "090270"
},
{
"bank_name": "Lavender Microfinance Bank",
"code": "090271"
},
{
"bank_name": "Olabisi Onabanjo University Microfinance Bank",
"code": "090272"
},
{
"bank_name": "Emeralds Microfinance Bank",
"code": "090273"
},
{
"bank_name": "Trustfund Microfinance Bank",
"code": "090276"
},
{
"bank_name": "Al-Hayat Microfinance Bank",
"code": "090277"
},
{
"bank_name": "FET",
"code": "100001"
},
{
"bank_name": "Parkway-ReadyCash",
"code": "100003"
},
{
"bank_name": "Cellulant",
"code": "100005"
},
{
"bank_name": "eTranzact",
"code": "100006"
},
{
"bank_name": "Stanbic IBTC @ease wallet",
"code": "100007"
},
{
"bank_name": "Ecobank Xpress Account",
"code": "100008"
},
{
"bank_name": "GTMobile",
"code": "100009"
},
{
"bank_name": "TeasyMobile",
"code": "100010"
},
{
"bank_name": "Mkudi",
"code": "100011"
},
{
"bank_name": "VTNetworks",
"code": "100012"
},
{
"bank_name": "AccessMobile",
"code": "100013"
},
{
"bank_name": "FBNMobile",
"code": "100014"
},
{
"bank_name": "Kegow",
"code": "100015"
},
{
"bank_name": "FortisMobile",
"code": "100016"
},
{
"bank_name": "Hedonmark",
"code": "100017"
},
{
"bank_name": "ZenithMobile",
"code": "100018"
},
{
"bank_name": "Flutterwave Technology Solutions Limited",
"code": "110002"
},
{
"bank_name": "NIP Virtual Bank",
"code": "999999"
},
{
"bank_name": "Titan Trust Bank",
"code": "000025"
},
{
"bank_name": "ChamsMobile",
"code": "303"
},
{
"bank_name": "MAUTECH Microfinance Bank",
"code": "090423"
},
{
"bank_name": "Greenwich Merchant Bank",
"code": "060004"
},
{
"bank_name": "Parallex Bank",
"code": "000030"
},
{
"bank_name": "Firmus MFB",
"code": "090366"
},
{
"bank_name": "PALMPAY",
"code": "100033"
},
{
"bank_name": "Manny Microfinance bank",
"code": "090383"
},
{
"bank_name": "Letshego MFB",
"code": "090420"
},
{
"bank_name": "M36",
"code": "100035"
},
{
"bank_name": "Safe Haven MFB",
"code": "090286"
},
{
"bank_name": "9 Payment Service Bank",
"code": "120001"
},
{
"bank_name": "Tangerine Bank",
"code": "090426"
},
{
"bank_name": "FEDETH MICROFINANCE BANK",
"code": "090482"
},
{
"bank_name": "Carbon",
"code": "100026"
},
{
"bank_name": "DOT MICROFINANCE BANK",
"code": "090470"
},
{
"bank_name": "PremiumTrust Bank",
"code": "000031"
},
{
"bank_name": "Links Microfinance Bank",
"code": "090435"
},
{
"bank_name": "TeamApt",
"code": "110007"
},
{
"bank_name": "ENaira",
"code": "000033"
},
{
"bank_name": "TANADI MFB (CRUST)",
"code": "090560"
},
{
"bank_name": "GOODNEWS MFB",
"code": "090495"
},
{
"bank_name": "Money Master Psb",
"code": "120005"
},
{
"bank_name": "Smartcash Payment Service Bank",
"code": "120004"
},
{
"bank_name": "Momo Psb",
"code": "120003"
},
{
"bank_name": "Hopepsb",
"code": "120002"
},
{
"bank_name": "Woven Finance",
"code": "110029"
},
{
"bank_name": "Nomba Financial Services Limited",
"code": "110028"
},
{
"bank_name": "Yello Digital Financial Services",
"code": "110027"
},
{
"bank_name": "Spay Business",
"code": "110026"
},
{
"bank_name": "Netapps Technology Limited",
"code": "110025"
},
{
"bank_name": "Resident Fintech Limited",
"code": "110024"
},
{
"bank_name": "Capricorn Digital",
"code": "110023"
},
{
"bank_name": "Koraypay",
"code": "110022"
},
{
"bank_name": "Bud Infrastructure Limited",
"code": "110021"
},
{
"bank_name": "Nibssussd Payments",
"code": "110019"
},
{
"bank_name": "Microsystems Investment And Development Limited",
"code": "110018"
},
{
"bank_name": "Crowdforce",
"code": "110017"
},
{
"bank_name": "Vas2Nets Limited",
"code": "110015"
},
{
"bank_name": "Qr Payments",
"code": "110013"
},
{
"bank_name": "Cellulant Pssp",