# Start your global payment here This page is meant to give an overview and understanding of the integration process of our International payment and collection for merchant aggregators ## Int'l Payment & Collection (IPC). The **Int'l Payment & Collection (IPC)** is a solution designed to help merchant aggregators/payment service providers (PSP) with a system that allows them to process transactions (Collections & Payout ) for their merchants across the globe using mobile money, bank transfers, and account to account With a singular integration, you will have access to create wallet in different countries with the ability to process both collection & Payout directly from your wallet. ### Who is a Partner? A partner is a merchant (digital wallet providers, PSP, banks etc.) looking for a singular infrastructure to receive and payout in different countries. ### Partner's Settlement Wallet To get a settlement Account, partner is required to sign up on [www.intrapay.fuspay.finance](http://www.intrapay.fuspay.finance) 1. Sign up on Intrapay 2. Go to the Fiat Wallet Tab 3. Provide KYC to Setup Collection/Fiat Wallet 4. Map your Intrapay account to the right patner (Partner Mapping) ### Features of the IPC 1. **Server-Server Communication:** This enables Intrapay to communicate with a partner (e.g Binance) that their merchant has been added 2. **Name-match Algorithm**: This helps to match the asset holders name to the bank account senders name in order to prevent disputes 3. **Auto-reversal:** This helps to handle failed transactions or transactions with mismatched sender details. 4. **Transaction Encryption & IP:** All transactions communications are encrypted with the state-of-the-art ## Benefits Intrapay's infrastructure offers benefits to partners and merchants. ### Benefits to Partners 1. **Instant settlement:** Merchants are given dynamic virtual accounts to collect payments and are immediately settled. 2. **Name-Match Intelligence:** This helps to match a name on transaction details to the name of the asset holder ensuring no mismatch. 3. **Auto-reversal:** Auto-reversal ensures that when transactions fail funds are reversed to the sender thereby reducing disputes ### Dispute Resolution & Issues Handling We have a dedicated team of technical and customer support team to help resolve any transaction-related issues within 24 hours. **WhatsApp Support:** https\:// **Slack Support:** https\:// **Telegram Support:** https\:// **Email Support:** # Partner & Merchant Onboarding Onboarding Process Overview ### ###

Onboarding Process

StepsActionHow ToOutcomeImplication
API Journey

IPC/IPPA		The journey through fuspay API endponts
1Get the IPC or IPPA DocumentationThe IPC or IPPA documentation would be sent to partenr/merchant in the support group (Slack, Whatsapp)
2 Register on the Partner Onboard Endpoint. Please know the static IP of your system. IPC/IPPA Partner post JSON with email and partner codeEndpoint returns Partner ID, Private and Secret KeyThese Credentials are used to sign and communicate with IPC/IPPA
3Partner IP WhitelistingThe merchants send us the IPs of their server and their partner ID returned from the Register partner endpointWhitelisted IPs are allowed to call our systemA security measure to ensure only permitted servers can communicate with our infrastructeure
9Post Order to Create Order EndpointYou need to have done your wallet setup i.e step 5

There are 2 methods of creating an order . Either they have their own screen for showing their users the payment flow or they use our payment pages

This decision decides how the endpoint is interacted with (what is in the header or the body of the request) More info in the doc

Signing Request: Request are signed using the digital signature endpoint before they are sent to the create order endpoint

Sample codes are in the doc
10Fetch Order StatusThis is an endpoint that helps to know the status of a collection orderAPI response showing the status of an order
11Payout EndpointThis is an endpoint that does the payout. This also does account verification to avoid payouts to wrong accountsCallback for payout is sent
12Fetch Payout StatusThis is an API call that helps to know the status of a payout request.
Intrapay App Journey (Onboarding)

merchants only.		Merchant is connected to their partner. on Intrapay. Also, The partner and the merchant can sometimes be the same entity
4Platform Sign Up.Visit intrapay.fuspay.financeSign up pageUser on successful sign up has access to platform
5Collection Wallet SetupUser goes to the Fiat wallet Side bar on the Intrapay App

Then Input BVN/Passport Number, Name, DOB, and address		Collection Wallet is setup

This allows you to have a pool of virtual accounts in Nigeria. Without wallet setup you will not be able to get Virtual accounts 		Wallet is setup but without KYC there would be $100 limit (fiat equivalent) of payout and collection on the account per day
6Partner MappingClick on the partner mapping tab

Merchant should input

Partner_ Merchant_ID (generated by your partner for your)
Partner callback (your callback url for Notifications)		A merchant is mapped to the partner that was added to the IPC previously

User can now see their merchant secret key and intrapay merchant ID on their Intrapay Dashboard		Merchant is connected to the partner. The partner and the merchant can sometimes be the same entity.
7Copy Merchant secret keyAfter Mapping merchant to partner copy the merchant secret key in the partner mapping tabMerchant secret key differs per country and is used to identify the merchants per country. The merchant secret is used to make API calls also
8Copy Intrapay Merchant IDCopy the intrapay merchant ID at the bottom left of the screen (in the fiat wallet section)The merchant ID also differs per country. The Merchants ID is used to make API calls
# Getting Started for Partner This page describes how a partner onboards on Intrapay Onboarding on the IPPA for Partners is a **"server-to-server"** communication. We have provided a list of endpoints to make the integration and onboarding seamless. Below is the description of how to authenticate with our endpoints and a list of endpoints needed to successfully onboard. ### Authentication A one time link will be sent to the email of the partner upon sign up to retrieve “public key, private key and Partner ID. {% hint style="warning" %} This is a one time link. If you mistakenly close the link, use this to regenerate new credentials. Onboarding Endpoints api/v1/no-auth/PartnerP2P/OnboardPartner {% endhint %} #### PUBLIC KEY - pk\_*partner\_*xxx In every request, your public key will be added to the authorization header as a bearer token when making a request to your System. #### SECRET KEY OF PARTNER - sk\_*partner\_*xxx When Intrapay is making a request to the Partner’s server, we use the Partner’s secret Key to generate “Digital Signature” which is attached to the request body as “Signature Key”. Also note that the Partner is expected to do the same except for Order Creation & Order Notification as explained below #### SECRET KEY OF MERCHANT - sk\_*merchant\_*xxx The secret key of the merchant and the secret key of the partner *(for example, concat string:- \[sk\_merchant\_xxx+''+sk\_partner\_xxx] )* is used to generate the digital signature that is attached to the request body when making the following request: * 1\. Create an order on Intraypay by partner * 2\. Send Order Notification to Partner Order Notification URL {% hint style="warning" %} Also, note that the public key of the partner will / should always be added as an authorization header when making requests to intrapay {% endhint %} #### DIGITAL SIGNATURE SHA-512 is the encryption algorithm used; signed with the SECRET KEY(s) for all requests body. {% hint style="warning" %} Also, note that the signature key in the request body is ignored during the signing of the request body {% endhint %} Digital signatures are compared as an integrity test. You compare it when we post callback to you and we compare when you create an order. what is compared is the signed body without the signature field ### Partner Onboarding Endpoints {% hint style="danger" %} Please call this endpoint once. To add extra currency go to you intrapay dashboad and add subaccount for more currencies. {% endhint %} ## This endpoint is to register a partner `POST` `https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/OnboardPartner.` Partner's Public, Secret Keys, and partners ID will be sent to Partner email as a one-time link. #### Headers | Name | Type | Description | | ---------------------------------------------- | ------ | ---------------- | | Content-Type\* | String | application/json | #### Request Body | Name | Type | Description | | ----------------------------------------------- | ------ | ----------------------------- | | partner\_code\* | String | a code signifying the partner | | email\* | String | email of the partner | {% tabs %} {% tab title="200: OK " %} {% endtab %} {% endtabs %} ### Example request- Code. {% tabs %} {% tab title="Nodejs" %} ```javascript const fetch = require('node-fetch'); fetch("https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/OnboardPartner", { "method": "POST", "headers": { "Content-Type": "application/json", "cookie": "connect.sid=s%253AoNBPv4ez8npeuKVKlS9KwX_1Dshiamlf.n8opjPuoF3XsU%252Be0VTLMUe6xzeAXmpCfQrpW9KW1KDs" }, "body": { "partner_code": "Binance", "email": "sample@example.com" } }) .then(response => console.log(response)) .catch(err => console.error(err)); ``` {% endtab %} {% tab title="cURL" %} ``` curl "https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/OnboardPartner" \ -H 'Content-Type: application/json' \ -X POST \ -b 'connect.sid'='s%3AoNBPv4ez8npeuKVKlS9KwX_1Dshiamlf.n8opjPuoF3XsU%2Be0VTLMUe6xzeAXmpCfQrpW9KW1KDs' \ -d '{ "partner_code": "Binance", "email": "sample@example.com" }' ``` {% endtab %} {% endtabs %} {% hint style="info" %} After onboarding on the partner onboarding endpoint, you have to provide the IPs for your system. As the IPs need to whitelisted on our system. {% endhint %} ### IP Capture & Whitelisting ## This endpoint is used to capture your IPs for Whitelisting. Just post any data to it and we would know your IP and whitelist for you. `POST` `https://staging-exchanger-api.fuspay.finance/test-ip-connection/` {% tabs %} {% tab title="200: OK " %} {% endtab %} {% endtabs %} ### ### Regenerate Partners Pub/Priv Keys ## This endpoint is used by partners to regenerate their keys `POST` `https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/OnboardPartner./` A One time reset link is sent to the partner email address to regenerate the keys **Old keys becomes invalid** #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ------------------------ | | Content-type\* | String | application/json | | Authorization\* | String | Bearer pk\_partner\_xxxx | #### Request Body | Name | Type | Description | | ----------------------------------------------- | ------ | ---------------------------------------------- | | email\* | String | | | signature\* | String | sha512-req-body-signed-with-sk\_partner\_xxxxx | | partner\_code\* | String | the partner code used on partner onboarding | {% tabs %} {% tab title="200: OK " %} {% endtab %} {% endtabs %} #### Example Request- Code {% tabs %} {% tab title="Node" %} ```javascript const fetch = require('node-fetch'); fetch("https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/GenKeysForPartner", { "method": "POST", "headers": { "Content-Type": "application/json", "Authorization": "Bearer pk_partner_xxxx", }, "body": { "email": "sample@example.com", "partner_code":"", "signature": "sha512-req-body-signed-with-sk_partner_xxxxx" } }) .then(response => console.log(response)) .catch(err => console.error(err)); ``` {% endtab %} {% endtabs %} ### # Partner Onboarding Endpoints This endpoint is to register a partner `POST` `https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/OnboardPartner.` Partner's Public, Secret Keys, and partners ID will be sent to Partner email as a one-time link. #### Headers | Name | Type | Description | | ---------------------------------------------- | ------ | ---------------- | | Content-Type\* | String | application/json | #### Request Body | Name | Type | Description | | ----------------------------------------------- | ------ | ----------------------------- | | partner\_code\* | String | a code signifying the partner | | email\* | String | email of the partner | {% tabs %} {% tab title="200: OK " %} {% endtab %} {% endtabs %} ### Example request- Code. {% tabs %} {% tab title="Nodejs" %} ```javascript const fetch = require('node-fetch'); fetch("https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/OnboardPartner", { "method": "POST", "headers": { "Content-Type": "application/json", "cookie": "connect.sid=s%253AoNBPv4ez8npeuKVKlS9KwX_1Dshiamlf.n8opjPuoF3XsU%252Be0VTLMUe6xzeAXmpCfQrpW9KW1KDs" }, "body": { "partner_code": "Binance", "email": "sample@example.com" } }) .then(response => console.log(response)) .catch(err => console.error(err)); ``` {% endtab %} {% endtabs %} # IP Capture & Whitelisting This endpoint is used to capture your IPs for White listing. Just post any data to it and we would know your IP and whitelist for you. `POST` `https://staging-exchanger-api.fuspay.finance/test-ip-connection/` {% tabs %} {% tab title="200: OK" %} {% endtab %} {% tab title="" %} {% endtab %} {% endtabs %} # Regenerate Partners Pub/Priv Keys This endpoint is used by partners to regenerate their keys `POST` `https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/OnboardPartner./` A One time reset link is sent to the partner email address to regenerate the keys **Old keys becomes invalid** #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ------------------------ | | Content-type\* | String | application/json | | Authorization\* | String | Bearer pk\_partner\_xxxx | #### Request Body | Name | Type | Description | | ----------------------------------------------- | ------ | ---------------------------------------------- | | email\* | String | | | signature\* | String | sha512-req-body-signed-with-sk\_partner\_xxxxx | | partner\_code\* | String | the partner code used on partner onboarding | {% tabs %} {% tab title="200: OK " %} {% endtab %} {% endtabs %} #### Example Request- Code {% tabs %} {% tab title="Node" %} ```javascript const fetch = require('node-fetch'); fetch("https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/GenKeysForPartner", { "method": "POST", "headers": { "Content-Type": "application/json", "Authorization": "Bearer pk_partner_xxxx", }, "body": { "email": "sample@example.com", "partner_code":"", "signature": "sha512-req-body-signed-with-sk_partner_xxxxx" } }) .then(response => console.log(response)) .catch(err => console.error(err)); ``` {% endtab %} {% endtabs %} # Getting Started for Merchant This page explains how the merchant can set up P2P Payment automation from A-Z To start accepting payment automatically using the IPC system, merchants are required to download the "Intrapay Mobile App" or visit our [Web](https://intrapay.fuspay.finance/auth/register) app ### To Do 1. **Sign up on Intrapay** - Open a free account on Intrapay either on mobile or [web](https://intrapay.fuspay.finance/auth/register); and click on the 'Fiat wallet' on the home page's sidebar to create your fiat wallet.
2. **Setup Collection** - After clicking on the fiat wallet sidebar, the merchant is expected to setup collection to create their fiat wallet. This involves the merchant inputting their BVN/International passport ID(depending on country), Date of Birth, phone number.
**Partner Mapping:** This helps to map the merchant to his partner account. The merchant is expected to add his callback URL (for payment confirmation and API responses) and merchant ID (a code generated from the merchant's own system)
4. **Perform KYC** - Accounts without KYC are limited accounts with a daily limit of #50000 in Nigeria. To start processing higher volumes a merchant should submit and have approved all the required KYC documents (country dependent).
# Collection # Digital Signatures This page describes how to sign your orders ### Digital Signature ## This endpoint is used to sign the request body and generate the digital signature. `POST` `https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/SignRequestSha512/` The object is signed without including the signature field. Also sign exactly the fields that would be posted to the endpoint **Please make sure we have whitelisted all your IPs** **Only Collection or Order creation requires using of merchant secret and partner secret all other request to be signed are to be signed using partner secret alone** #### Headers | Name | Type | Description | | ---------------------------------------------- | ------ | ---------------- | | Content-Type\* | String | application/json | #### Request Body | Name | Type | Description | | -------------------------------------------------------- | ------ | ---------------------------------------------------------------------- | | partner\_order\_id\* | String | the order id on partners end | | amount\_to\_collect\* | String | the amount to be collected | | timestamp\* | String | the time the order was created | | order\_expiration\* | String | the time the order would expire | | currency\* | String | the currency of collection eg GHS, NGN | | partner\_callback\_url\* | String | the url where payment confirmation would be posted | | partner\_redirect\_url | String | partners site where users would be redirected after successful payment | | secret\* | String | merchant and partner secret. The keys are concatenated | | intrapay\_merchant\_id | String | Your Id on the intrapay app | | partner\_id | String | Your partner id returned on the onboard endpoint | #### Sample code {% tabs %} {% tab title="NodeJs" %} ```javascript const request = require('request'); const options = { method: 'POST', url: 'https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/SignRequestSha512', headers: {'Content-Type': 'application/json'}, body: { partner_order_id: 'FUSPAY-00400-001-091-008', amount_to_collect: '30', timestamp: 1693285902419, order_expiration: 1693285902419, intrapay_merchant_id: "", partner_id: "" currency: 'NGN', partner_callback_url: 'https://webhook.site/xxxxxxxx', partner_redirect_url: 'https://google.com', secret: '4LJDHGA-SJTECNA-XXXX-XXXXsk_partner_ph25sjy-qtfeoxy-rqbvzyq-z-xx' }, json: true }; request(options, function (error, response, body) { if (error) throw new Error(error); console.log(body); }); ``` {% endtab %} {% endtabs %} # Collection (MOMO) Collection with payment pages is for Mobile Money dominated countries (GHS, KHS). This is the Async method of creating collection order it is designed to provide speedy responses. ### Create Order - Using Fuspay's Payment Pages ## This endpoint is used to create an order on Intrapay `POST` `https://prod-order-exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/CreateOrder/` So, if you want a payment page (a screen that allows your users input their phone number & network), Please include ***x-partner-id, x-merchant-secret*** in the **header** and ignore ***intrapay\_merchant\_id*** in the request body. **Note:** The intrapay merchant id is different for each account (currency) created on Intrapay. You can find your intrapay merchant id at the bottom left AFTER YOU HAVE SETUP the wallet of that currency. The merchant secret is also different per currency. Find your merchant secret at the partner mapping screen by clicking on your name on the partner list. Orders start to appear on Intrapay dashboard after user has visited the payment page and has accepted payment on their phone. #### Headers | Name | Type | Description | | --------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- | | x-merchant-secret\* | String | The secret key of the merchant (this is different for each country) and can be gotten from your dashboard (partner mapping) | | Content-Type\* | String | application/json | | x-partner-id\* | String | The ID of the partner (Binance) sending the order | | Authorization\* | String | Authorization is a bearer token which is Partners public key | #### Request Body | Name | Type | Description | | -------------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------- | | partner\_order\_id\* | String | Id of order generated on partners' system | | amount\_to\_collect\* | String | amount buyer is to pay | | timestamp\* | Number | Time order was created. unix or epoch time in milleseconds (GMT+0) | | order\_expiration\* | Number | the time to be elapsed before order becomes invalid. unix or epoch time in millseconds (GMT+0) | | currency\* | String | currency the buyer is paying the merchant with | | partner\_callback\_url\* | String | payment notification used by IntraPay to notify Partner System about the Payment status of the order | | partner\_redirect\_url\* | String | provided by partner. url to redirect partner's users | | signature\* | String | SHA-512 of request payload signed with both merchant and partner secret key(SK\_merchant\_xxx+SK\_partner\_xxx) | {% tabs %} {% tab title="200: OK successful response" %} {% code overflow="wrap" %} ```javascript //API response OK //Callback Response 1 { "partner_order_id": "FUSPAY-Y-20251", "callbak_data": "OK" } //Callback response 2 {"": "https://intrapay.fuspay.finance/b2b?partner_id=p60037¤cy=KHS&amount=1001&fee=0&order_id=593163277406920704&lang=eng-NG&country=kenya&tk=YN6ITFY-ECIEG2A-VCEAT2I-ARZKZEA7388"} ``` {% endcode %} {% endtab %} {% tab title="400: Bad Request failed responses" %} {% code overflow="wrap" %} ```javascript { "status": "error", "message": "Public Key combination is not valid", "partner_order_id": "FUSPAY-Y-20251", "signature": "8cb88b058e32460560d707788c759f25201c5a353596c9d271922ba2b0f89541f779642c08a8993bc37ab96cd7cb97ff291a38b6d29ab6642e0979de9077a992" } ``` {% endcode %} {% endtab %} {% endtabs %} #### Example Request- Code {% tabs %} {% tab title="Node" %} {% code overflow="wrap" lineNumbers="true" %} ```javascript ( async () => { const primary_key = "1" const secret_key = "" const partner_id = "" const merchant_secret = "" const request = require('request'); const options = { method: 'POST', url: 'https://prod-order-exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/CreateOrder', headers: { 'Content-Type': 'application/json', 'x-merchant-secret': merchant_secret, 'x-partner-id': partner_id, Authorization: Bearer ${primary_key} }, body: { "partner_order_id": "qorepay0001", "amount_to_collect": "500", "timestamp": 1694604837129, "order_expiration": 1694605737129, "currency": "KHS", "partner_callback_url": "https://webhook.site/86e6e156-8250-417e-857c-7bfd3cab224d", "partner_redirect_url": "https://webhook.site/86e6e156-8250-417e-857c-7bfd3cab224d", "signature": "8da879e46e30cb50519a321677c14568f2a08e2ce35c046514a4523402a376d2659827516f59620023400396dd3652c6825a8cb221ffabf7d1007e0275f24d60" }, json: true }; request(options, function (error, response, body) { if (error) throw new Error(error); console.log(body); });     } )() ``` {% endcode %} {% endtab %} {% tab title="cURL" %} ``` // CURL VERSION curl --request POST \ --url https://prod-order-exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/CreateOrder \ --header 'Authorization: Bearer pk_partner_xxxxx' \ --header 'Content-Type: application/json' \ --header 'x-merchant-secret: xxxxxxxx' \ --header 'x-partner-id: pxxx' \ --data '{ "partner_order_id": "xxxxx", "amount_to_collect": "500", "timestamp": 1694604837129, "order_expiration": 1694605737129, "currency": "KHS", "partner_callback_url": "https://webhook.site/xxxxd", "partner_redirect_url": "https://webhook.site/xxxxxx", "signature": "xxxxxxx" }' ``` {% endtab %} {% endtabs %} # Collection (Virtual Account-NGN )\*\* This is the Async method of creating collection order it is desiigned to provide speedy responses while creating and fetching orders ### Create Order-Without Payment Pages or in Nigeria (Virtual accounts) #### This endpoint is also used to create an order on Intrapay `POST` `https://prod-order-exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/CreateOrder/` If you have a payment page for collecting your end-user's phone number and network (mobile money regions) or you want to collect in **NIGERIA;** Please add ***"intrapay\_merchant\_id"*** and ***partner\_id*** in the **request body**. For Nigeria, the virtual bank account is sent as a JSON response from the API **Note:** The intrapay merchant id is different for each account (currency) created on Intrapay. You can find your intrapay merchant id at the bottom left AFTER YOU HAVE SETUP the wallet of that currency. The merchant secret is also different per currency. Find your merchant secret at the partner mapping screen by clicking on your name on the partner list. Once callback is received order appears on intrapay dashboard. #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ------------------------------------------------------------ | | Content-Type\* | String | application/json | | Authorization\* | String | Authorization is a bearer token which is Partners public key | #### Request Body | Name | Type | Description | | -------------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------- | | partner\_order\_id\* | String | Id of order generated on partners' system | | amount\_to\_collect\* | String | amount seller or buy as listed | | timestamp\* | Number | Time order was created. unix or epoch time in milleseconds (GMT+0) | | order\_expiration\* | String | the time to be elapsed before order becomes invalid. unix or epoch time in millseconds (GMT+0) | | currency\* | String | currency the buyer is paying the merchant with | | partner\_callback\_url\* | String | payment notification used by IntraPay to notify Partner System about the Payment status of the order | | partner\_redirect\_url\* | String | provided by partner. url to redirect partner's users | | signature\* | String | SHA-512 of request payload signed with both merchant and partner secret key(SK\_merchant\_xxx+SK\_partner\_xxx) | | intrapay\_merchant\_id\* | String | The intrapay merchant id is found on your intrapay dashboard on your fiat tab. | | partner\_id\* | String | this is the ID gotten from the partner onboard endpoint | {% tabs %} {% tab title="200: OK successful response" %} {% code overflow="wrap" %} ```javascript //API Response { message:"OK" } //callback response 1 { "partner_order_id": "FUSPAY-Y-20251", "callbak_data": "OK" } //callback response 2 { "status": "PENDING", "id": 271046, "partner_id": "p60037", "order_notify_url": " https://webhook.site/f968b3b6-964c-4418-bdb0-169f3c2c3e4c", "exchanger_user_id": 129, "intrapay_merchant_id": "intra_merchant_176833", "messsage": "Fetched successfully", "payment": { "status": "PENDING", "sender_name": "" }, "virtual_account": { "amount": 100, "account_name": "John Ibikunle", "bank_name": "GTB", "account_number": "0845342528", "virtual_account_id": 2 }, "order_details": {} } ``` {% endcode %} {% endtab %} {% tab title="400: Bad Request failed responses" %} ```javascript { error: true, status: "error", message: string, data: null } ``` {% endtab %} {% endtabs %} #### Example Request- Code {% tabs %} {% tab title="Node" %} ```javascript const request = require('request') const options = { method: 'POST', url: 'http://localhost:5000/api/v1/no-auth/PartnerP2P/CreateOrder', headers: { 'Content-Type': 'application/json', Authorization: 'Bearer pk_partner_xxxxxxxx' }, body: { partner_order_id: 'my-server-order-id', amount_to_collect: '100', timestamp: 1693285902419, order_expiration: 1693285902419, currency: 'NGN', // GHS | KHS | NGN | UGX | ZAR intrapay_merchant_id: "", partner_id: "", partner_callback_url: 'https://xxx...', partner_redirect_url: 'https://example.com?status=success&order=my-server-order-id', signature: 'fe04ee69d4f9a93c71f3d1bbf37d49d541e5c4fb159c4a75924f398262e2af146d0e2e33b1379a9b57c641d822c410158e03b64faab34dc98d528bfa234f9dd3' }, json: true }; request(options, function (error, response, body) { if (error) throw new Error(error); console.log(body); }); ``` {% endtab %} {% endtabs %} {% tabs %} {% tab title="200: OK successful response" %} ```javascript { "status": "success", "messsage": "", "data": { "payment": { "status": "PENDING | PAID | REFUND" }, "virtual_account": { "amount": "", "account_name": "", "bank_name": "", "account_number": "" }, "order_details": { "status": "PENDING | COMPLETED | EXPIRED | CANCELED", "partner_order_id": "", "intrapay_order_reference": "" } } } ``` {% endtab %} {% tab title="400: Bad Request failed response" %} ```javascript { "status": "fail", "messsage": "" } ``` {% endtab %} {% endtabs %} # Fetch Order This endpoint is used to check the status of a collection order ### Fetch order ### This endpoint is used to fetch an order to verify its status `GET` `https://prod-order-exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/FetchOrder?partner_order_id=xx&partner_id=xx/` **Order Status** Pending = newly created orders that has not been fulfilled in 45 mins Completed = Order that has been fulfilled and a callback has been returned in 45 mins Mismatched = this is when a user pays above or below the amount on the order. Expired = Order that payment was made but callback wasnt returned in 45 mins Abandoned = an order that a user hasnt paid into in over 45 mins Claimed = in cases of mismatched and expired merchants can decide to claim the money paid #### Query Parameters | Name | Type | Description | | ---------------------------------------------------- | ------ | ----------------------------- | | partner\_order\_id\* | String | the id of the order generated | | partner\_id | String | the Id of the partner | #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ------------------- | | Authorization\* | String | partners public key | | Content-Type\* | String | application/json | {% tabs %} {% tab title="200: OK successful response" %} ``` { "status": "success", "id":"", "partner_id":"", "order_notify_url":"", "exchanger_user_id":"", "intrapay_merchant_id":"" "messsage": "", "data": { "payment": { "status": "PENDING | PAID | REFUND" }, "virtual_account": { "amount": "", "account_name": "", "bank_name": "", "account_number": "" }, "order_details": { "status": "PENDING | COMPLETED | EXPIRED | CANCELED", "partner_order_id": "", "intrapay_order_reference": "" } } } ``` {% endtab %} {% tab title="400: Bad Request failed response" %} ``` { "status": "fail", "messsage": "" } ``` {% endtab %} {% endtabs %} #### Example Request- Code {% tabs %} {% tab title="Node" %} ```javascript const fetch = require('node-fetch'); fetch("https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/FetchOrder?partner_order_id=xxxxx", { "method": "GET", "headers": { "Content-Type": "application/json", "Authorization": "Bearer pk_partner_xxxx", "cookie": "connect.sid=s%253AoNBPv4ez8npeuKVKlS9KwX_1Dshiamlf.n8opjPuoF3XsU%252Be0VTLMUe6xzeAXmpCfQrpW9KW1KDs" } }) .then(response => console.log(response)) .catch(err => console.error(er ``` {% endtab %} {% endtabs %} # Assigning Virtual Accounts These endpoints are used to create, fetch and cancel orders. There are 2 ways you can create an order on our system using Virtual Accounts. The first way we are responsible for assigning the Virtual account (`https://prod-order-exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/CreateOrder/` and the other way you fetch an available account from our end an show to your users. We would explore the first way using the endpoint below. The other way is right below ## This endpoint is used to create an order on Intrapay *(Old Auto Assigned VA for NGN)* `POST` `https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/CreateOrder/` `The endpoint above has been changed to https://prod-order-exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/CreateOrder/ for efficiency sake` So, if you want a redirect URL (a screen that allows your users input their phone number & network), Please include ***x-partner-id, x-merchant-secret*** in the **header** and ignore ***intrapay\_merchant\_id*** in the request body. However, if you have a system for collecting the phone number and network (mobile money regions) or you want to collect in NIGERIA; you should not add ***x-partner-id*** and ***x-merchant-secret*** in the header, and send ***"intrapay\_merchant\_id"*** and ***partner\_id*** in the **request body** instead The intrapay merchant id is different for each account (currency) created on Intrapay. You can find your intrapay merchant id at the bottom left AFTER YOU HAVE SETUP the wallet of that currency. The merchant secret is also different per currency. Find your merchant secret at the partner mapping screen by clicking on your name on the partner list. Please make sure we have whitelisted all your IPs #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ----------------------------------------------------------------------- | | Authorization\* | String | ***Bearer*** pk\_partner\_xxx | | Content-Type\* | String | application/json | | x-partner-id | String | Your partner ID | | x-merchant-secret | String | the merchant secret copied from intrapay dashboard(differs per country) | #### Request Body | Name | Type | Description | | -------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | partner\_order\_id\* | String | Id of order generated on partners's system | | amount\_to\_collect\* | String | amount seller or buy as listed | | intrapay\_merchant\_id\* | Number | merchant id on Intrapay (this is different per account) | | timestamp\* | Number | Time order was signed. unix or epoch time in milleseconds (GMT+0) | | order\_expiration\* | String | the time to be elapsed before order becomes invalid. unix or epoch time in milleseconds (GMT+0) | | currency\* | String | currency the buyer is paying the merchant with | | partner\_callback\_url\* | String | partner payment notification url used by IntraPay to notify Partner System about the Payment status of the order | | partner\_redirect\_url\* | String | provided by partner url to redirect buyer | | signature\* | String | SHA-512 of request payload signed with both merchant and partner secret key(SK\_merchant\_xxx+SK\_partner\_xxx) | | phone | String |

The phone number of the sender. Not needed in non mobile money regions. This should not be included if you are going to use our page to collect the number.

Add country code 254XX671000

| | mobile\_money\_network | String | The mobile network operator. eg MTN, Safaricom(MPESA), ATM. Not needed in non mobile money regions. This should not be included if you are going to use our page to collect the number | | partner\_id | String | The partner Id returned from the onboarding endpoint | {% tabs %} {% tab title="200: OK successful response" %} ```javascript //API Response { message:"OK", redirect_url:"" } //Response sent to callback URL { "status": "success", "messsage": "", "virtual_account": { "account_name": "", "bank_name": "", "account_number": "" }, "order_details": { "status": "PENDING", "partner_order_id": "", "intrapay_order_reference": "" } } ``` {% endtab %} {% tab title="400: Bad Request failed responses" %} ```javascript { "status": "fail", "messsage": "", "error_code": "" } 1001 - Order is already open / pending 1002 - Order has been canceled 1003- Order has been completed 1004- Order has expired ``` {% endtab %} {% endtabs %} #### Example Request- Code {% tabs %} {% tab title="Node" %} ```javascript const request = require('request') const options = { method: 'POST', url: 'http://localhost:5000/api/v1/no-auth/PartnerP2P/CreateOrder', headers: { 'Content-Type': 'application/json', Authorization: 'Bearer pk_partner_xxxxxxxx' }, body: { partner_order_id: 'my-server-order-id', amount_to_collect: '5', timestamp: 1693285902419, order_expiration: 1693285902419, currency: 'NGN', // GHS | KHS | NGN | UGX | ZAR intrapay_merchant_id: "", partner_id: "", partner_callback_url: 'https://xxx...', partner_redirect_url: 'https://example.com?status=success&order=my-server-order-id', signature: 'fe04ee69d4f9a93c71f3d1bbf37d49d541e5c4fb159c4a75924f398262e2af146d0e2e33b1379a9b57c641d822c410158e03b64faab34dc98d528bfa234f9dd3' }, json: true }; request(options, function (error, response, body) { if (error) throw new Error(error); console.log(body); }); ``` {% endtab %} {% tab title="cURL" %} ``` curl "https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/CreateOrder" \ -H 'Content-Type: application/json' \ -H 'x-intrapay-partner-secret: H36ZOEA-HK7EWOQ-TVM2C6A-QH6BW2Q53954' \ -H 'Authorization: Bearer pk_partner_xxxx' \ -X POST \ -b 'connect.sid'='s%3AoNBPv4ez8npeuKVKlS9KwX_1Dshiamlf.n8opjPuoF3XsU%2Be0VTLMUe6xzeAXmpCfQrpW9KW1KDs' \ -d '{ "partner_order_id": "", "amount_to_collect": "", "intrapay_merchant_id": "", "timestamp": "", "order_expiration": "", "currency": "", "partner_callback_url": "", "partner_redirect_url": "", "partner_buyer_registered_name": "", "signature": "sha-512-of-req-body-signed-with-SK_merchant_xxx+SK_partner_xxx" }' ``` {% endtab %} {% endtabs %} ### Get Available Assignable Virtual Account ### This endpoint is used to fetch free/available virtual accounts from your account pool. `POST` `https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/GetCollectionPoolAccounts?choose_bank=All/` This gives you ability to assign virtual account number to a collection order. Virtual Account Number are used once until an order is fulfilled or timeout This endpoint also gives you the ability to decide the bank generating the virtual account. if choose\_bank=All virtual accounts from all bank partners (GTB, Globus) would be returned; However if set to GTB, only VAs from GTB would be returned. #### Query Parameters | Name | Type | Description | | ------------ | ------ | ----------------------------------------------------------------------------------------------------------------------- | | choose\_bank | String | to select the bank providing the virtual account eg choose\_bank =GTB. This would return virtual accounts from GTB only | #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ----------------------------- | | Authorization\* | String | ***Bearer*** pk\_partner\_xxx | | Content-Type\* | String | application/json | #### Request Body | Name | Type | Description | | -------------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------- | | intrapay\_merchant\_id\* | Number | merchant id on Intrapay (this is different per account) | | signature\* | String | SHA-512 of request payload signed with both merchant and partner secret key(SK\_merchant\_xxx+SK\_partner\_xxx) | | partner\_id | String | the partners id from partner onbaording endpoint | {% tabs %} {% tab title="200: OK successful response" %} ```javascript Response { "success": true, "message": "Collection Pool Accounts", "data": [ { "virtual_account_id": xxx, "account_name": "xxxxx", "account_number": "xxxxxx", "status": "ACTIVE" },     ....     ] } //Active means account is not being used and is available for use ``` {% endtab %} {% tab title="400: Bad Request failed responses" %} {% endtab %} {% endtabs %} #### Example Request- Code ### Check if specific account is available for use ## This endpoint is used to check if a specific account is available for use `GET` `https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/IsPoolAccountAvailable?account_number=xxxx/` #### Query Parameters
NameTypeDescription
account_number*Stringthis is the account number you are trying to verify
#### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ------------------- | | Authorization\* | String | partners public key | | Content-Type\* | String | application/json | {% tabs %} {% tab title="200: OK successful response" %} ```javascript { success: true, message: m, data: data   } //true means account is available for use ``` {% endtab %} {% tab title="400: Bad Request failed response" %} {% endtab %} {% endtabs %} #### Example Request- Code ### Create Order- using Available Virtual Account from your Account Pool ## This endpoint is used to create an order on Intrapay `POST` `https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/CreateOrder/` This endpoint puts you in charge of assigning virtual accounts to your collection orders. So to create orders this way, we have provided an endpoint above where you can get the list of available Virtual accounts (Accounts not assigned to any transaction yet) and once you get the free VA you send it along with your new order. The intrapay merchant id is different for each account (currency) created on Intrapay. You can find your intrapay merchant id at the bottom left AFTER YOU HAVE SETUP the wallet of that currency. The merchant secret is also different per currency. Find your merchant secret at the partner mapping screen by clicking on your name on the partner list. #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ----------------------------- | | Authorization\* | String | ***Bearer*** pk\_partner\_xxx | | Content-Type\* | String | application/json | #### Request Body | Name | Type | Description | | -------------------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------- | | partner\_order\_id\* | String | Id of order generated on partners's system | | amount\_to\_collect\* | String | amount seller or buy as listed | | intrapay\_merchant\_id\* | Number | merchant id on Intrapay (this is different per account) | | timestamp\* | Number | Time order was signed. unix or epoch time in milleseconds (GMT+0) | | order\_expiration\* | String | the time to be elapsed before order becomes invalid. unix or epoch time in milleseconds (GMT+0) | | currency\* | String | currency the buyer is paying the merchant with | | partner\_callback\_url\* | String | partner payment notification url used by IntraPay to notify Partner System about the Payment status of the order | | partner\_redirect\_url\* | String | provided by partner url to redirect buyer | | signature\* | String | SHA-512 of request payload signed with both merchant and partner secret key(SK\_merchant\_xxx+SK\_partner\_xxx) | | assigned\_virtual\_account\_number\* | String | The virtual account picked from the get free account endpoint. eg 1234567890 | | partner\_id\* | String | The partner Id returned from the onboarding endpoint | {% tabs %} {% tab title="200: OK successful response" %} ```javascript //API Response { message:"OK", redirect_url:"" } //Response sent to callback URL { "status": "success", "messsage": "", "virtual_account": { "account_name": "", "bank_name": "", "account_number": "" }, "order_details": { "status": "PENDING", "partner_order_id": "", "intrapay_order_reference": "" } } ``` {% endtab %} {% tab title="400: Bad Request failed responses" %} ```javascript { "status": "fail", "messsage": "", "error_code": "" } 1001 - Order is already open / pending 1002 - Order has been canceled 1003- Order has been completed 1004- Order has expired ``` {% endtab %} {% endtabs %} #### Example Request- Code ### Fetch order ## This endpoint is used to fetch an order to verify its status `GET` `https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/FetchOrder/` **Order Status** PENDING - Order is open / pending CANCELED - Order has been canceled COMPLETED- Order has been completed and payment was made EXPIRED- Order has expired **Payment Status** PENDING - Order payment is not received yet PAID - Order payment has been completed and payment was made by the Buyer REFUND - Buyer was refunded **The following transactions can be deemed as pending via API responses :** Mismatched ( with Bank Ref ) Pending (No bank Ref) Abandoned - pending > 4hours All pending are #### Query Parameters | Name | Type | Description | | ---------------------------------------------------- | ------ | ---------------------------------------------- | | partner\_order\_id\* | String | the Id or reference of the order being checked | #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ------------------- | | Authorization\* | String | partners public key | | Content-Type\* | String | application/json | {% tabs %} {% tab title="200: OK successful response" %} ```javascript { "status": "success", "messsage": "", "data": { "payment": { "status": "PENDING | PAID | REFUND" }, "virtual_account": { "amount": "", "account_name": "", "bank_name": "", "account_number": "" }, "order_details": { "status": "PENDING | COMPLETED | EXPIRED | CANCELED", "partner_order_id": "", "intrapay_order_reference": "" } } } ``` {% endtab %} {% tab title="400: Bad Request failed response" %} ```javascript { "status": "fail", "messsage": "" } ``` {% endtab %} {% endtabs %} #### Example Request- Code {% tabs %} {% tab title="Node" %} ```javascript const fetch = require('node-fetch'); fetch("https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/FetchOrder?partner_order_id=xxxxx", { "method": "GET", "headers": { "Content-Type": "application/json", "Authorization": "Bearer pk_partner_xxxx", "cookie": "connect.sid=s%253AoNBPv4ez8npeuKVKlS9KwX_1Dshiamlf.n8opjPuoF3XsU%252Be0VTLMUe6xzeAXmpCfQrpW9KW1KDs" } }) .then(response => console.log(response)) .catch(err => console.error(err)); ``` {% endtab %} {% tab title="cURL" %} ``` curl "https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/FetchOrder?partner_order_id=xxxxx" \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer pk_partner_xxxx' \ -X GET \ -b 'connect.sid'='s%3AoNBPv4ez8npeuKVKlS9KwX_1Dshiamlf.n8opjPuoF3XsU%2Be0VTLMUe6xzeAXmpCfQrpW9KW1KDs' ``` {% endtab %} {% endtabs %} ### Cancel Order ## This endpoint is used to cancel an order. `POST` #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ----------------------- | | Content-Type\* | String | application/json | | Authorization\* | String | Bearer pk\_partner\_xxx | #### Request Body | Name | Type | Description | | ---------------------------------------------------- | ------ | ------------------------------------------------------------------ | | partner\_order\_id\* | String | Order id | | signature\* | String | sha-512-of-req-body-signed-with-SK\_merchant\_xxx+SK\_partner\_xxx | {% tabs %} {% tab title="200: OK successful response" %} ```javascript { "status": "success", "message": "", "partner_order_id": "" } ``` {% endtab %} {% tab title="400: Bad Request failed response" %} ```javascript { "status": "fail", "messsage": "" } ``` {% endtab %} {% endtabs %} ### example request -code {% tabs %} {% tab title="Node" %} ``` const fetch = require('node-fetch'); fetch("https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/CancelOrder", { "method": "POST", "headers": { "Content-Type": "application/json", "Authorization": "Bearer pk_partner_xxxx", "cookie": "connect.sid=s%253AoNBPv4ez8npeuKVKlS9KwX_1Dshiamlf.n8opjPuoF3XsU%252Be0VTLMUe6xzeAXmpCfQrpW9KW1KDs" }, "body": { "partner_order_id": "", "signature": "sha-512-of-req-body-signed-with-SK_merchant_xxx+SK_partner_xxx" } }) .then(response => console.log(response)) .catch(err => console.error(err)); ``` {% endtab %} {% tab title="cURL" %} ``` curl "https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/CancelOrder" \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer pk_partner_xxxx' \ -X POST \ -b 'connect.sid'='s%3AoNBPv4ez8npeuKVKlS9KwX_1Dshiamlf.n8opjPuoF3XsU%2Be0VTLMUe6xzeAXmpCfQrpW9KW1KDs' \ -d '{ "partner_order_id": "", "signature": "sha-512-of-req-body-signed-with-SK_merchant_xxx+SK_partner_xxx" }' ``` {% endtab %} {% endtabs %} # Get Available Assignable Virtual Account This endpoint is used to fetch free/available virtual accounts from your account pool. `POST` `https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/GetCollectionPoolAccounts?choose_bank=All/` This gives you ability to assign virtual account number to a collection order. Virtual Account Number are used once until an order is fulfilled or timeout This endpoint also gives you the ability to decide the bank generating the virtual account. if choose\_bank=All virtual accounts from all bank partners (GTB, Globus) would be returned; However if set to GTB, only VAs from GTB would be returned. #### Query Parameters | Name | Type | Description | | ------------ | ------ | ----------------------------------------------------------------------------------------------------------------------- | | choose\_bank | String | to select the bank providing the virtual account eg choose\_bank =GTB. This would return virtual accounts from GTB only | #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ----------------------------- | | Authorization\* | String | ***Bearer*** pk\_partner\_xxx | | Content-Type\* | String | application/json | #### Request Body | Name | Type | Description | | -------------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------- | | intrapay\_merchant\_id\* | Number | merchant id on Intrapay (this is different per account) | | signature\* | String | SHA-512 of request payload signed with both merchant and partner secret key(SK\_merchant\_xxx+SK\_partner\_xxx) | | partner\_id | String | the partners id from partner onbaording endpoint | {% tabs %} {% tab title="200: OK successful response" %} ```javascript Response { "success": true, "message": "Collection Pool Accounts", "data": [ { "virtual_account_id": xxx, "account_name": "xxxxx", "account_number": "xxxxxx", "status": "ACTIVE" },     ....     ] } //Active means account is not being used and is available for use ``` {% endtab %} {% tab title="400: Bad Request failed responses" %} {% endtab %} {% endtabs %} #### Example Request- Code # Check if specific account is available for use This endpoint is used to check if a specific account is available for use `GET` `https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/IsPoolAccountAvailable?account_number=xxxx/` #### Query Parameters
NameTypeDescription
account_number*Stringthis is the account number you are trying to verify
#### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ------------------- | | Authorization\* | String | partners public key | | Content-Type\* | String | application/json | {% tabs %} {% tab title="200: OK successful response" %} ```javascript { success: true, message: m, data: data   } //true means account is available for use ``` {% endtab %} {% tab title="400: Bad Request failed response" %} {% endtab %} {% endtabs %} #### Example Request- Code # Create Order- using Available Virtual Account from your Account Pool This endpoint is used to create an order on Intrapay. `POST` `https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/CreateOrder/` This endpoint puts you in charge of assigning virtual accounts to your collection orders. So to create orders this way, we have provided an endpoint above where you can get the list of available Virtual accounts (Accounts not assigned to any transaction yet) and once you get the free VA you send it along with your new order. The intrapay merchant id is different for each account (currency) created on Intrapay. You can find your intrapay merchant id at the bottom left AFTER YOU HAVE SETUP the wallet of that currency. The merchant secret is also different per currency. Find your merchant secret at the partner mapping screen by clicking on your name on the partner list. #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ----------------------------- | | Authorization\* | String | ***Bearer*** pk\_partner\_xxx | | Content-Type\* | String | application/json | #### Request Body | Name | Type | Description | | -------------------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------- | | partner\_order\_id\* | String | Id of order generated on partners's system | | amount\_to\_collect\* | String | amount seller or buy as listed | | intrapay\_merchant\_id\* | Number | merchant id on Intrapay (this is different per account) | | timestamp\* | Number | Time order was signed. unix or epoch time in milleseconds (GMT+0) | | order\_expiration\* | String | the time to be elapsed before order becomes invalid. unix or epoch time in milleseconds (GMT+0) | | currency\* | String | currency the buyer is paying the merchant with | | partner\_callback\_url\* | String | partner payment notification url used by IntraPay to notify Partner System about the Payment status of the order | | partner\_redirect\_url\* | String | provided by partner url to redirect buyer | | signature\* | String | SHA-512 of request payload signed with both merchant and partner secret key(SK\_merchant\_xxx+SK\_partner\_xxx) | | assigned\_virtual\_account\_number\* | String | The virtual account picked from the get free account endpoint. eg 1234567890 | | partner\_id\* | String | The partner Id returned from the onboarding endpoint | {% tabs %} {% tab title="200: OK successful response" %} ```javascript //API Response { message:"OK", redirect_url:"" } //Response sent to callback URL { "status": "success", "messsage": "", "virtual_account": { "account_name": "", "bank_name": "", "account_number": "" }, "order_details": { "status": "PENDING", "partner_order_id": "", "intrapay_order_reference": "" } } ``` {% endtab %} {% tab title="400: Bad Request failed responses" %} ```javascript { "status": "fail", "messsage": "", "error_code": "" } 1001 - Order is already open / pending 1002 - Order has been canceled 1003- Order has been completed 1004- Order has expired ``` {% endtab %} {% endtabs %} #### Example Request- Code ```json // request body sample { "partner_order_id": "Shayo_8", "amount_to_collect": "300", "timestamp": "1726059780", "order_expiration": "1726061000", "partner_id": "p890458", "currency": "NGN", "intrapay_merchant_id": "intra_merchant_999419", "partner_callback_url": "https://webhook.site/fd6cdcfc76eebdfb", "partner_redirect_url": "https://google.com", "assigned_virtual_account_number": "123457812", "signature": "ce3822ba01f064a8ed5289b8523ddd39cea25a78ec37185ee36eedb568ff8ffd994859e10716210a627dc46a5571" } ``` # Cancel Order This endpoint is used to cancel an order. `POST` #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ----------------------- | | Content-Type\* | String | application/json | | Authorization\* | String | Bearer pk\_partner\_xxx | #### Request Body | Name | Type | Description | | ---------------------------------------------------- | ------ | ------------------------------------------------------------------ | | partner\_order\_id\* | String | Order id | | signature\* | String | sha-512-of-req-body-signed-with-SK\_merchant\_xxx+SK\_partner\_xxx | {% tabs %} {% tab title="200: OK successful response" %} ```javascript { "status": "success", "message": "", "partner_order_id": "" } ``` {% endtab %} {% tab title="400: Bad Request failed response" %} ```javascript { "status": "fail", "messsage": "" } ``` {% endtab %} {% endtabs %} ### example request -code {% tabs %} {% tab title="Node" %} ``` const fetch = require('node-fetch'); fetch("https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/CancelOrder", { "method": "POST", "headers": { "Content-Type": "application/json", "Authorization": "Bearer pk_partner_xxxx", "cookie": "connect.sid=s%253AoNBPv4ez8npeuKVKlS9KwX_1Dshiamlf.n8opjPuoF3XsU%252Be0VTLMUe6xzeAXmpCfQrpW9KW1KDs" }, "body": { "partner_order_id": "", "signature": "sha-512-of-req-body-signed-with-SK_merchant_xxx+SK_partner_xxx" } }) .then(response => console.log(response)) .catch(err => console.error(err)); ``` {% endtab %} {% endtabs %} # Get Mobile Money Providers This is to get mobile money providers of each country ### Mobile Money Providers ## Get the available mobile money operators of a country `GET` `https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/MobileMoney/` #### Headers | Name | Type | Description | | ------------ | ------ | ---------------- | | Content-Type | String | application/json | {% tabs %} {% tab title="200: OK Successful response " %} ```javascript { "ghana": { "Country": "Ghana", "list": [ { "name": "MTN", "code": "MTN" }, { "name": "Vodacom", "code": "VOD" }, { "name": "Airtel Money", "code": "ATM" } ] }, "kenya": { "Country": "Kenya", "list": [ { "name": "MPESA (Safaricom)", "code": "MPESA" } ] }, "uganda": { "Country": "Uganda", "list": [ { "name": "MTN", "code": "MTN" }, { "name": "Airtel Money", "code": "ATM" }, { "name": "Warid Pesa", "code": "WARID" }, { "name": "Orange money", "code": "ORANGE" } ] } } ``` {% endtab %} {% endtabs %} # Payout This page is an overview on how to manage payout from your settlement wallet. # 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 | {% tabs %} {% tab title="200: OK successful response" %} ```javascript { success:true, message:string, data:{ account_name:''} } ``` {% endtab %} {% tab title="400: Bad Request Error " %} ```javascript {error:true, data:null} ``` {% endtab %} {% endtabs %} ### 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) | {% tabs %} {% tab title="200: OK Successful Transfer " %} {% code overflow="wrap" lineNumbers="true" fullWidth="true" %} ```javascript { "success": true, "message": "Withdrawal initiated. Updates will be provided on callback!!!", "data": null } ``` {% endcode %} {% endtab %} {% endtabs %} ### 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 | {% tabs %} {% tab title="200: OK Successful Transfer or Failed Transfer" %} 
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
}
{% endtab %} {% endtabs %} ### Banks & Bank Codes ```javascript [ { "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", "code": "110012" }, { "bank_name": "Arca Payments", "code": "110011" }, { "bank_name": "Interswitch Financial Inclusion Services (Ifis)", "code": "110010" }, { "bank_name": "Kadick Integration Limited", "code": "110008" }, { "bank_name": "Paystack Payments Limited", "code": "110006" }, { "bank_name": "3Line Card Management Limited", "code": "110005" }, { "bank_name": "Interswitch Limited", "code": "110003" }, { "bank_name": "Beta-Access Yello", "code": "100052" }, { "bank_name": "Titan-Paystack", "code": "100039" }, { "bank_name": "Kegow(Chamsmobile)", "code": "100036" }, { "bank_name": "Zwallet", "code": "100034" }, { "bank_name": "Opay", "code": "100004" }, { "bank_name": "Otech Microfinance Bank Ltd", "code": "090580" }, { "bank_name": "Gbede Microfinance Bank", "code": "090579" }, { "bank_name": "Iwade Microfinance Bank Ltd", "code": "090578" }, { "bank_name": "Octopus Microfinance Bank Ltd", "code": "090576" }, { "bank_name": "Firstmidas Microfinance Bank Ltd", "code": "090575" }, { "bank_name": "Snow Microfinance Bank", "code": "090573" }, { "bank_name": "Ewt Microfinance Bank", "code": "090572" }, { "bank_name": "Ilaro Poly Microfinance Bank Ltd", "code": "090571" }, { "bank_name": "Iyamoye Microfinance Bank Ltd", "code": "090570" }, { "bank_name": "Qube Microfinance Bank Ltd", "code": "090569" }, { "bank_name": "Broadview Microfinance Bank Ltd", "code": "090568" }, { "bank_name": "Orokam Microfinance Bank Ltd", "code": "090567" }, { "bank_name": "Okuku Microfinance Bank Ltd", "code": "090566" }, { "bank_name": "Oke-Aro Oredegbe Microfinance Bank Ltd", "code": "090565" }, { "bank_name": "Supreme Microfinance Bank Ltd", "code": "090564" }, { "bank_name": "Balera Microfinance Bank Ltd", "code": "090563" }, { "bank_name": "Cedar Microfinance Bank Ltd", "code": "090562" }, { "bank_name": "Akuchukwu Microfinance Bank Ltd", "code": "090561" }, { "bank_name": "Shield Microfinance Bank Ltd", "code": "090559" }, { "bank_name": "Shongom Microfinance Bank Ltd", "code": "090558" }, { "bank_name": "Lifegate Microfinance Bank Ltd", "code": "090557" }, { "bank_name": "Egwafin Microfinance Bank Ltd", "code": "090556" }, { "bank_name": "Bishopgate Microfinance Bank", "code": "090555" }, { "bank_name": "Kayvee Microfinance Bank", "code": "090554" }, { "bank_name": "Consistent Trust Microfinance Bank Ltd", "code": "090553" }, { "bank_name": "Ekimogun Microfinance Bank", "code": "090552" }, { "bank_name": "Fairmoney Microfinance Bank Ltd", "code": "090551" }, { "bank_name": "Green Energy Microfinance Bank Ltd", "code": "090550" }, { "bank_name": "Kc Microfinance Bank", "code": "090549" }, { "bank_name": "Ally Microfinance Bank", "code": "090548" }, { "bank_name": "Rockshield Microfinance Bank", "code": "090547" }, { "bank_name": "Ijebu-Ife Microfinance Bank Ltd", "code": "090546" }, { "bank_name": "Abulesoro Microfinance Bank Ltd", "code": "090545" }, { "bank_name": "Aspire Microfinance Bank Ltd", "code": "090544" }, { "bank_name": "Iwoama Microfinance Bank", "code": "090543" }, { "bank_name": "Otuo Microfinance Bank Ltd", "code": "090542" }, { "bank_name": "Excellent Microfinance Bank", "code": "090541" }, { "bank_name": "Aztec Microfinance Bank", "code": "090540" }, { "bank_name": "Enrich Microfinance Bank", "code": "090539" }, { "bank_name": "Blue Investments Microfinance Bank", "code": "090538" }, { "bank_name": "Lobrem Microfinance Bank", "code": "090537" }, { "bank_name": "Ikoyi-Osun Microfinance Bank", "code": "090536" }, { "bank_name": "Nkpolu-Ust Microfinance", "code": "090535" }, { "bank_name": "Polyibadan Microfinance Bank", "code": "090534" }, { "bank_name": "Ibolo Micorfinance Bank Ltd", "code": "090532" }, { "bank_name": "Aku Microfinance Bank", "code": "090531" }, { "bank_name": "Confidence Microfinance Bank Ltd", "code": "090530" }, { "bank_name": "Ampersand Microfinance Bank", "code": "090529" }, { "bank_name": "Mgbidi Microfinance Bank", "code": "090528" }, { "bank_name": "Ojokoro Microfinance Bank", "code": "090527" }, { "bank_name": "Crescent Microfinance Bank", "code": "090526" }, { "bank_name": "Triple A Microfinance Bank", "code": "090525" }, { "bank_name": "Solidrock Microfinance Bank", "code": "090524" }, { "bank_name": "Chase Microfinance Bank", "code": "090523" }, { "bank_name": "Foresight Microfinance Bank", "code": "090521" }, { "bank_name": "Ic Globalmicrofinance Bank", "code": "090520" }, { "bank_name": "Ibom Fadama Microfinance Bank", "code": "090519" }, { "bank_name": "Afemai Microfinance Bank", "code": "090518" }, { "bank_name": "Uhuru Microfinance Bank", "code": "090517" }, { "bank_name": "Numo Microfinance Bank", "code": "090516" }, { "bank_name": "Rima Growth Pathway Microfinance Bank", "code": "090515" }, { "bank_name": "Umuchinemere Procredit Microfinance Bank", "code": "090514" }, { "bank_name": "Seap Microfinance Bank", "code": "090513" }, { "bank_name": "Bubayero Microfinance Bank", "code": "090512" }, { "bank_name": "Cloverleaf Microfinance Bank", "code": "090511" }, { "bank_name": "Umunnachi Microfinance Bank", "code": "090510" }, { "bank_name": "Capitalmetriq Swift Microfinance Bank", "code": "090509" }, { "bank_name": "Borno Renaissance Microfinance Bank", "code": "090508" }, { "bank_name": "Fims Microfinance Bank", "code": "090507" }, { "bank_name": "Solid Allianze Microfinance Bank", "code": "090506" }, { "bank_name": "Nigeria Prisonsmicrofinance Bank", "code": "090505" }, { "bank_name": "Zikora Microfinance Bank", "code": "090504" }, { "bank_name": "Projects Microfinance Bank", "code": "090503" }, { "bank_name": "Shalom Microfinance Bank", "code": "090502" }, { "bank_name": "Boromu Microfinance Bank", "code": "090501" }, { "bank_name": "Gwong Microfinance Bank", "code": "090500" }, { "bank_name": "Pristine Divitis Microfinance Bank", "code": "090499" }, { "bank_name": "Catland Microfinance Bank", "code": "090498" }, { "bank_name": "Palmcoast Microfinance Bank", "code": "090497" }, { "bank_name": "Radalpha Microfinance Bank", "code": "090496" }, { "bank_name": "Boji Boji Microfinance Bank", "code": "090494" }, { "bank_name": "Iperu Microfinance Bank", "code": "090493" }, { "bank_name": "Oraukwu Microfinance Bank", "code": "090492" }, { "bank_name": "Nsuk Microfinance Bank", "code": "090491" }, { "bank_name": "Chukwunenye Microfinance Bank", "code": "090490" }, { "bank_name": "Alvana Microfinance Bank", "code": "090489" }, { "bank_name": "Ibu-Aje Microfinance", "code": "090488" }, { "bank_name": "Kingdom College Microfinance Bank", "code": "090487" }, { "bank_name": "Fortress Microfinance Bank", "code": "090486" }, { "bank_name": "Safegate Microfinance Bank", "code": "090485" }, { "bank_name": "Garki Microfinance Bank", "code": "090484" }, { "bank_name": "Ada Microfinance Bank", "code": "090483" }, { "bank_name": "Prisco Microfinance Bank", "code": "090481" }, { "bank_name": "Cintrust Microfinance Bank", "code": "090480" }, { "bank_name": "First Heritage Microfinance Bank", "code": "090479" }, { "bank_name": "Avuenegbe Microfinance Bank", "code": "090478" }, { "bank_name": "Light Microfinance Bank", "code": "090477" }, { "bank_name": "Anchorage Microfinance Bank", "code": "090476" }, { "bank_name": "Giant Stride Microfinance Bank", "code": "090475" }, { "bank_name": "Verdant Microfinance Bank", "code": "090474" }, { "bank_name": "Assets Microfinance Bank", "code": "090473" }, { "bank_name": "Caretaker Microfinance Bank", "code": "090472" }, { "bank_name": "Oluchukwu Microfinance Bank", "code": "090471" }, { "bank_name": "Aniocha Microfinance Bank", "code": "090469" }, { "bank_name": "Olofin Owena Microfinance Bank", "code": "090468" }, { "bank_name": "Good Neighbours Microfinance Bank", "code": "090467" }, { "bank_name": "Yct Microfinance Bank", "code": "090466" }, { "bank_name": "Maintrust Microfinance Bank", "code": "090465" }, { "bank_name": "Unimaid Microfinance Bank", "code": "090464" }, { "bank_name": "Rehoboth Microfinance Bank", "code": "090463" }, { "bank_name": "Monarch Microfinance Bank", "code": "090462" }, { "bank_name": "Uniibadan Microfinance Bank", "code": "090461" }, { "bank_name": "Oluyole Microfinance Bank", "code": "090460" }, { "bank_name": "Nice Microfinance Bank", "code": "090459" }, { "bank_name": "Ospoly Microfinance Bank", "code": "090456" }, { "bank_name": "Borstal Microfinance Bank", "code": "090454" }, { "bank_name": "Uzondu Mf Bank", "code": "090453" }, { "bank_name": "Unilag Microfinance Bank", "code": "090452" }, { "bank_name": "Atbu Microfinance Bank", "code": "090451" }, { "bank_name": "Kwasu Mf Bank", "code": "090450" }, { "bank_name": "Sls Mf Bank", "code": "090449" }, { "bank_name": "Moyofade Mf Bank", "code": "090448" }, { "bank_name": "Support Mf Bank", "code": "090446" }, { "bank_name": "Capstone Mf Bank", "code": "090445" }, { "bank_name": "Boi Mf Bank", "code": "090444" }, { "bank_name": "Rima Microfinance Bank", "code": "090443" }, { "bank_name": "Giwa Microfinance Bank", "code": "090441" }, { "bank_name": "Cherish Microfinance Bank", "code": "090440" }, { "bank_name": "Ibeto Microfinance Bank", "code": "090439" }, { "bank_name": "Futminna Microfinance Bank", "code": "090438" }, { "bank_name": "Oakland Microfinance Bank", "code": "090437" }, { "bank_name": "Spectrum Microfinance Bank", "code": "090436" }, { "bank_name": "Insight Microfinance Bank", "code": "090434" }, { "bank_name": "Rigo Microfinance Bank", "code": "090433" }, { "bank_name": "Memphis Microfinance Bank", "code": "090432" }, { "bank_name": "Bluewhales Microfinance Bank", "code": "090431" }, { "bank_name": "Ilora Microfinance Bank", "code": "090430" }, { "bank_name": "Crossriver Microfinance Bank", "code": "090429" }, { "bank_name": "Ishie Microfinance Bank", "code": "090428" }, { "bank_name": "Ebsu Microfinance Bank", "code": "090427" }, { "bank_name": "Banex Microfinance Bank", "code": "090425" }, { "bank_name": "Abucoop Microfinance Bank", "code": "090424" }, { "bank_name": "Landgold Microfinance Bank", "code": "090422" }, { "bank_name": "Izon Microfinance Bank", "code": "090421" }, { "bank_name": "Winview Bank", "code": "090419" }, { "bank_name": "Highland Microfinance Bank", "code": "090418" }, { "bank_name": "Imowo Microfinance Bank", "code": "090417" }, { "bank_name": "Chibueze Microfinance Bank", "code": "090416" }, { "bank_name": "Calabar Microfinance Bank", "code": "090415" }, { "bank_name": "Crutech Microfinance Bank", "code": "090414" }, { "bank_name": "Benysta Microfinance Bank", "code": "090413" }, { "bank_name": "Preeminent Microfinance Bank", "code": "090412" }, { "bank_name": "Giginya Microfinance Bank", "code": "090411" }, { "bank_name": "Maritime Microfinance Bank", "code": "090410" }, { "bank_name": "Fcmb Microfinance Bank", "code": "090409" }, { "bank_name": "Gmb Microfinance Bank", "code": "090408" }, { "bank_name": "Business Support Microfinance Bank", "code": "090406" }, { "bank_name": "Moniepoint Microfinance Bank", "code": "090405" }, { "bank_name": "Olowolagba Microfinance Bank", "code": "090404" }, { "bank_name": "Uda Microfinance Bank", "code": "090403" }, { "bank_name": "Peace Microfinance Bank", "code": "090402" }, { "bank_name": "Shepherd Trust Microfinance Bank", "code": "090401" }, { "bank_name": "Finca Microfinance Bank", "code": "090400" }, { "bank_name": "Nwannegadi Microfinance Bank", "code": "090399" }, { "bank_name": "Federal Polytechnic Nekede Microfinance Bank", "code": "090398" }, { "bank_name": "Chanelle Bank", "code": "090397" }, { "bank_name": "Oscotech Microfinance Bank", "code": "090396" }, { "bank_name": "Borgu Microfinance Bank", "code": "090395" }, { "bank_name": "Amac Microfinance Bank", "code": "090394" }, { "bank_name": "Mozfin Microfinance Bank", "code": "090392" }, { "bank_name": "Davodani Microfinance Bank", "code": "090391" }, { "bank_name": "Parkway Mf Bank", "code": "090390" }, { "bank_name": "Ek-Reliable Microfinance Bank", "code": "090389" }, { "bank_name": "Interland Microfinance Bank", "code": "090386" }, { "bank_name": "Gti Microfinance Bank", "code": "090385" }, { "bank_name": "Kredi Money Microfinance Bank", "code": "090380" }, { "bank_name": "Peniel Micorfinance Bank Ltd", "code": "090379" }, { "bank_name": "New Golden Pastures Microfinance Bank", "code": "090378" }, { "bank_name": "Isaleoyo Microfinance Bank", "code": "090377" }, { "bank_name": "Apple Microfinance Bank", "code": "090376" }, { "bank_name": "Coastline Microfinance Bank", "code": "090374" }, { "bank_name": "Tf Microfinance Bank", "code": "090373" }, { "bank_name": "Legend Microfinance Bank", "code": "090372" }, { "bank_name": "Agosasa Microfinance Bank", "code": "090371" }, { "bank_name": "Ilasan Microfinance Bank", "code": "090370" }, { "bank_name": "Seedvest Microfinance Bank", "code": "090369" }, { "bank_name": "Corestep Microfinance Bank", "code": "090365" }, { "bank_name": "Nuture Microfinance Bank", "code": "090364" }, { "bank_name": "Headway Microfinance Bank", "code": "090363" }, { "bank_name": "Molusi Microfinance Bank", "code": "090362" }, { "bank_name": "Cashconnect Microfinance Bank", "code": "090360" }, { "bank_name": "Isuofia Microfinance Bank", "code": "090353" }, { "bank_name": "Jessefield Microfinance Bank", "code": "090352" }, { "bank_name": "Illorin Microfinance Bank", "code": "090350" }, { "bank_name": "Nasarawa Microfinance Bank", "code": "090349" }, { "bank_name": "Oau Microfinance Bank Ltd", "code": "090345" }, { "bank_name": "Citizen Trust Microfinance Bank Ltd", "code": "090343" }, { "bank_name": "Unilorin Microfinance Bank", "code": "090341" }, { "bank_name": "Stockcorp Microfinance Bank", "code": "090340" }, { "bank_name": "Uniuyo Microfinance Bank", "code": "090338" }, { "bank_name": "Iyeru Okin Microfinance Bank Ltd", "code": "090337" }, { "bank_name": "Bipc Microfinance Bank", "code": "090336" }, { "bank_name": "Oche Microfinance Bank", "code": "090333" }, { "bank_name": "Evergreen Microfinance Bank", "code": "090332" }, { "bank_name": "Unaab Microfinance Bank", "code": "090331" }, { "bank_name": "Fame Microfinance Bank", "code": "090330" }, { "bank_name": "Neptune Microfinance Bank", "code": "090329" }, { "bank_name": "Trust Microfinance Bank", "code": "090327" }, { "bank_name": "Balogun Gambari Microfinance Bank", "code": "090326" }, { "bank_name": "Ikenne Microfinance Bank", "code": "090324" }, { "bank_name": "Mainland Microfinance Bank", "code": "090323" }, { "bank_name": "Rephidim Microfinance Bank", "code": "090322" }, { "bank_name": "Mayfair Microfinance Bank", "code": "090321" }, { "bank_name": "Kadpoly Microfinance Bank", "code": "090320" }, { "bank_name": "Bonghe Microfinance Bank", "code": "090319" }, { "bank_name": "Federal University Dutse Microfinance Bank", "code": "090318" }, { "bank_name": "Bayero Microfinance Bank", "code": "090316" }, { "bank_name": "U And C Microfinance Bank", "code": "090315" }, { "bank_name": "Edfin Microfinance Bank", "code": "090310" }, { "bank_name": "Brightway Microfinance Bank", "code": "090308" }, { "bank_name": "Aramoko Microfinance Bank", "code": "090307" }, { "bank_name": "Sulsap Microfinance Bank", "code": "090305" }, { "bank_name": "Evangel Microfinance Bank", "code": "090304" }, { "bank_name": "Purplemoney Microfinance Bank", "code": "090303" }, { "bank_name": "Sunbeam Microfinance Bank", "code": "090302" }, { "bank_name": "Kontagora Microfinance Bank", "code": "090299" }, { "bank_name": "Federalpoly Nasarawamfb", "code": "090298" }, { "bank_name": "Alert Microfinance Bank", "code": "090297" }, { "bank_name": "Polyuwanna Microfinance Bank", "code": "090296" }, { "bank_name": "Omiye Microfinance Bank", "code": "090295" }, { "bank_name": "Eagle Flight Microfinance Bank", "code": "090294" }, { "bank_name": "Brethren Microfinance Bank", "code": "090293" }, { "bank_name": "Afekhafe Microfinance Bank", "code": "090292" }, { "bank_name": "Halacredit Microfinance Bank", "code": "090291" }, { "bank_name": "Fct Microfinance Bank", "code": "090290" }, { "bank_name": "Pillar Microfinance Bank", "code": "090289" }, { "bank_name": "Assets Matrix Microfinance Bank", "code": "090287" }, { "bank_name": "First Option Microfinance Bank", "code": "090285" }, { "bank_name": "Thrive Microfinance Bank", "code": "090283" }, { "bank_name": "Arise Microfinance Bank", "code": "090282" }, { "bank_name": "Megapraise Microfinance Bank", "code": "090280" }, { "bank_name": "Ikire Microfinance Bank", "code": "090279" }, { "bank_name": "Glory Microfinance Bank", "code": "090278" }, { "bank_name": "Meridian Microfinance Bank", "code": "090275" }, { "bank_name": "Prestige Microfinance Bank", "code": "090274" }, { "bank_name": "Coalcamp Microfinance Bank", "code": "090254" }, { "bank_name": "Yobe Microfinance Bank", "code": "090252" }, { "bank_name": "Itex Integrated Services Limited", "code": "090211" }, { "bank_name": "Accelerex Network", "code": "090202" }, { "bank_name": "Xpress Payments", "code": "090201" }, { "bank_name": "Girei Microfinance Bank", "code": "090186" }, { "bank_name": "Standard Microfinance Bank", "code": "090182" }, { "bank_name": "Balogun Fulani Microfinance Bank", "code": "090181" }, { "bank_name": "Rahama Microfinance Bank", "code": "090170" }, { "bank_name": "First Multiple Microfinance Bank", "code": "090163" }, { "bank_name": "Microvis Microfinance Bank", "code": "090113" }, { "bank_name": "Tajwallet", "code": "080002" }, { "bank_name": "Fha Mortgage Bank Ltd", "code": "070026" }, { "bank_name": "Akwa Savings & Loans Limited", "code": "070025" }, { "bank_name": "Homebase Mortgage", "code": "070024" }, { "bank_name": "Delta Trust Mortgage Bank", "code": "070023" }, { "bank_name": "Stb Mortgage Bank", "code": "070022" }, { "bank_name": "Coop Mortgage Bank", "code": "070021" }, { "bank_name": "Mayfresh Mortgage Bank", "code": "070019" }, { "bank_name": "Branch International Financial Services", "code": "050006" }, { "bank_name": "Aaa Finance", "code": "050005" }, { "bank_name": "Newedge Finance Ltd", "code": "050004" }, { "bank_name": "Sagegrey Finance Limited", "code": "050003" }, { "bank_name": "Fewchore Finance Company Limited", "code": "050002" }, { "bank_name": "County Finance Ltd", "code": "050001" }, { "bank_name": "Lotus Bank", "code": "000029" }, { "bank_name": "Central Bank Of Nigeria", "code": "000028" }, { "bank_name": "Optimus Bank", "code": "000036" }, { "bank_name": "Mercury MFB", "code": "090589" } ] ``` # Payout How to do payout ### Payout ## This endpoint is used to do the actual 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) | | partner\_callback\_url | String | This is your notification URL | {% tabs %} {% tab title="200: OK Successful Transfer " %} {% code overflow="wrap" lineNumbers="true" fullWidth="true" %} ```javascript { "success": true, "message": "Withdrawal initiated. Updates will be provided on callback!!!", "data": null } ``` {% endcode %} {% endtab %} {% endtabs %} # Payout Status How to confirm the status of your payout This endpoint is used 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 | {% tabs %} {% tab title="200: OK Successful Transfer or Failed Transfer" %} 
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
}
{% endtab %} {% endtabs %} # Crypto Withdrawal This documentation allows you to withdraw to USDT from your capital wallet This [doc](https://exchanger-api.fuspay.finance/rsa/wallet-api.pdf) describes how to connect, authenticate and transmit data via Fuspay Wallet System Note: The Fuspay wallet system uses Rivest-Shamir-Adleman (RSA) asymmetric encryption to encrypt and decrypt data via REST API Connect To access the Fuspay wallet system, you need to download your RSA Digital certificates from your dashboard. The certificates are public and private certificate. To send data to Fuspay you need to encrypt the request payload with your public certificate and to get response from us, you need to decrypt the response with your private certificate. Also, you must whitelist your server IP address on our system before a successful call can be made. Authentication To authenticate, you need to add the header - 'your-fuspay-secret-key'. Remember to encrypt your request with your public key and decrypt it with your private key **Please click on the link below to see the code samples and integrate seamlessly** [Crypto withdrawal document using your API ](https://exchanger-api.fuspay.finance/rsa/wallet-api.pdf) # Bank & Bank Codes ```javascript { "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", "code": "110012" }, { "bank_name": "Arca Payments", "code": "110011" }, { "bank_name": "Interswitch Financial Inclusion Services (Ifis)", "code": "110010" }, { "bank_name": "Kadick Integration Limited", "code": "110008" }, { "bank_name": "Paystack Payments Limited", "code": "110006" }, { "bank_name": "3Line Card Management Limited", "code": "110005" }, { "bank_name": "Interswitch Limited", "code": "110003" }, { "bank_name": "Beta-Access Yello", "code": "100052" }, { "bank_name": "Titan-Paystack", "code": "100039" }, { "bank_name": "Kegow(Chamsmobile)", "code": "100036" }, { "bank_name": "Zwallet", "code": "100034" }, { "bank_name": "Opay", "code": "100004" }, { "bank_name": "Otech Microfinance Bank Ltd", "code": "090580" }, { "bank_name": "Gbede Microfinance Bank", "code": "090579" }, { "bank_name": "Iwade Microfinance Bank Ltd", "code": "090578" }, { "bank_name": "Octopus Microfinance Bank Ltd", "code": "090576" }, { "bank_name": "Firstmidas Microfinance Bank Ltd", "code": "090575" }, { "bank_name": "Snow Microfinance Bank", "code": "090573" }, { "bank_name": "Ewt Microfinance Bank", "code": "090572" }, { "bank_name": "Ilaro Poly Microfinance Bank Ltd", "code": "090571" }, { "bank_name": "Iyamoye Microfinance Bank Ltd", "code": "090570" }, { "bank_name": "Qube Microfinance Bank Ltd", "code": "090569" }, { "bank_name": "Broadview Microfinance Bank Ltd", "code": "090568" }, { "bank_name": "Orokam Microfinance Bank Ltd", "code": "090567" }, { "bank_name": "Okuku Microfinance Bank Ltd", "code": "090566" }, { "bank_name": "Oke-Aro Oredegbe Microfinance Bank Ltd", "code": "090565" }, { "bank_name": "Supreme Microfinance Bank Ltd", "code": "090564" }, { "bank_name": "Balera Microfinance Bank Ltd", "code": "090563" }, { "bank_name": "Cedar Microfinance Bank Ltd", "code": "090562" }, { "bank_name": "Akuchukwu Microfinance Bank Ltd", "code": "090561" }, { "bank_name": "Shield Microfinance Bank Ltd", "code": "090559" }, { "bank_name": "Shongom Microfinance Bank Ltd", "code": "090558" }, { "bank_name": "Lifegate Microfinance Bank Ltd", "code": "090557" }, { "bank_name": "Egwafin Microfinance Bank Ltd", "code": "090556" }, { "bank_name": "Bishopgate Microfinance Bank", "code": "090555" }, { "bank_name": "Kayvee Microfinance Bank", "code": "090554" }, { "bank_name": "Consistent Trust Microfinance Bank Ltd", "code": "090553" }, { "bank_name": "Ekimogun Microfinance Bank", "code": "090552" }, { "bank_name": "Fairmoney Microfinance Bank Ltd", "code": "090551" }, { "bank_name": "Green Energy Microfinance Bank Ltd", "code": "090550" }, { "bank_name": "Kc Microfinance Bank", "code": "090549" }, { "bank_name": "Ally Microfinance Bank", "code": "090548" }, { "bank_name": "Rockshield Microfinance Bank", "code": "090547" }, { "bank_name": "Ijebu-Ife Microfinance Bank Ltd", "code": "090546" }, { "bank_name": "Abulesoro Microfinance Bank Ltd", "code": "090545" }, { "bank_name": "Aspire Microfinance Bank Ltd", "code": "090544" }, { "bank_name": "Iwoama Microfinance Bank", "code": "090543" }, { "bank_name": "Otuo Microfinance Bank Ltd", "code": "090542" }, { "bank_name": "Excellent Microfinance Bank", "code": "090541" }, { "bank_name": "Aztec Microfinance Bank", "code": "090540" }, { "bank_name": "Enrich Microfinance Bank", "code": "090539" }, { "bank_name": "Blue Investments Microfinance Bank", "code": "090538" }, { "bank_name": "Lobrem Microfinance Bank", "code": "090537" }, { "bank_name": "Ikoyi-Osun Microfinance Bank", "code": "090536" }, { "bank_name": "Nkpolu-Ust Microfinance", "code": "090535" }, { "bank_name": "Polyibadan Microfinance Bank", "code": "090534" }, { "bank_name": "Ibolo Micorfinance Bank Ltd", "code": "090532" }, { "bank_name": "Aku Microfinance Bank", "code": "090531" }, { "bank_name": "Confidence Microfinance Bank Ltd", "code": "090530" }, { "bank_name": "Ampersand Microfinance Bank", "code": "090529" }, { "bank_name": "Mgbidi Microfinance Bank", "code": "090528" }, { "bank_name": "Ojokoro Microfinance Bank", "code": "090527" }, { "bank_name": "Crescent Microfinance Bank", "code": "090526" }, { "bank_name": "Triple A Microfinance Bank", "code": "090525" }, { "bank_name": "Solidrock Microfinance Bank", "code": "090524" }, { "bank_name": "Chase Microfinance Bank", "code": "090523" }, { "bank_name": "Foresight Microfinance Bank", "code": "090521" }, { "bank_name": "Ic Globalmicrofinance Bank", "code": "090520" }, { "bank_name": "Ibom Fadama Microfinance Bank", "code": "090519" }, { "bank_name": "Afemai Microfinance Bank", "code": "090518" }, { "bank_name": "Uhuru Microfinance Bank", "code": "090517" }, { "bank_name": "Numo Microfinance Bank", "code": "090516" }, { "bank_name": "Rima Growth Pathway Microfinance Bank", "code": "090515" }, { "bank_name": "Umuchinemere Procredit Microfinance Bank", "code": "090514" }, { "bank_name": "Seap Microfinance Bank", "code": "090513" }, { "bank_name": "Bubayero Microfinance Bank", "code": "090512" }, { "bank_name": "Cloverleaf Microfinance Bank", "code": "090511" }, { "bank_name": "Umunnachi Microfinance Bank", "code": "090510" }, { "bank_name": "Capitalmetriq Swift Microfinance Bank", "code": "090509" }, { "bank_name": "Borno Renaissance Microfinance Bank", "code": "090508" }, { "bank_name": "Fims Microfinance Bank", "code": "090507" }, { "bank_name": "Solid Allianze Microfinance Bank", "code": "090506" }, { "bank_name": "Nigeria Prisonsmicrofinance Bank", "code": "090505" }, { "bank_name": "Zikora Microfinance Bank", "code": "090504" }, { "bank_name": "Projects Microfinance Bank", "code": "090503" }, { "bank_name": "Shalom Microfinance Bank", "code": "090502" }, { "bank_name": "Boromu Microfinance Bank", "code": "090501" }, { "bank_name": "Gwong Microfinance Bank", "code": "090500" }, { "bank_name": "Pristine Divitis Microfinance Bank", "code": "090499" }, { "bank_name": "Catland Microfinance Bank", "code": "090498" }, { "bank_name": "Palmcoast Microfinance Bank", "code": "090497" }, { "bank_name": "Radalpha Microfinance Bank", "code": "090496" }, { "bank_name": "Boji Boji Microfinance Bank", "code": "090494" }, { "bank_name": "Iperu Microfinance Bank", "code": "090493" }, { "bank_name": "Oraukwu Microfinance Bank", "code": "090492" }, { "bank_name": "Nsuk Microfinance Bank", "code": "090491" }, { "bank_name": "Chukwunenye Microfinance Bank", "code": "090490" }, { "bank_name": "Alvana Microfinance Bank", "code": "090489" }, { "bank_name": "Ibu-Aje Microfinance", "code": "090488" }, { "bank_name": "Kingdom College Microfinance Bank", "code": "090487" }, { "bank_name": "Fortress Microfinance Bank", "code": "090486" }, { "bank_name": "Safegate Microfinance Bank", "code": "090485" }, { "bank_name": "Garki Microfinance Bank", "code": "090484" }, { "bank_name": "Ada Microfinance Bank", "code": "090483" }, { "bank_name": "Prisco Microfinance Bank", "code": "090481" }, { "bank_name": "Cintrust Microfinance Bank", "code": "090480" }, { "bank_name": "First Heritage Microfinance Bank", "code": "090479" }, { "bank_name": "Avuenegbe Microfinance Bank", "code": "090478" }, { "bank_name": "Light Microfinance Bank", "code": "090477" }, { "bank_name": "Anchorage Microfinance Bank", "code": "090476" }, { "bank_name": "Giant Stride Microfinance Bank", "code": "090475" }, { "bank_name": "Verdant Microfinance Bank", "code": "090474" }, { "bank_name": "Assets Microfinance Bank", "code": "090473" }, { "bank_name": "Caretaker Microfinance Bank", "code": "090472" }, { "bank_name": "Oluchukwu Microfinance Bank", "code": "090471" }, { "bank_name": "Aniocha Microfinance Bank", "code": "090469" }, { "bank_name": "Olofin Owena Microfinance Bank", "code": "090468" }, { "bank_name": "Good Neighbours Microfinance Bank", "code": "090467" }, { "bank_name": "Yct Microfinance Bank", "code": "090466" }, { "bank_name": "Maintrust Microfinance Bank", "code": "090465" }, { "bank_name": "Unimaid Microfinance Bank", "code": "090464" }, { "bank_name": "Rehoboth Microfinance Bank", "code": "090463" }, { "bank_name": "Monarch Microfinance Bank", "code": "090462" }, { "bank_name": "Uniibadan Microfinance Bank", "code": "090461" }, { "bank_name": "Oluyole Microfinance Bank", "code": "090460" }, { "bank_name": "Nice Microfinance Bank", "code": "090459" }, { "bank_name": "Ospoly Microfinance Bank", "code": "090456" }, { "bank_name": "Borstal Microfinance Bank", "code": "090454" }, { "bank_name": "Uzondu Mf Bank", "code": "090453" }, { "bank_name": "Unilag Microfinance Bank", "code": "090452" }, { "bank_name": "Atbu Microfinance Bank", "code": "090451" }, { "bank_name": "Kwasu Mf Bank", "code": "090450" }, { "bank_name": "Sls Mf Bank", "code": "090449" }, { "bank_name": "Moyofade Mf Bank", "code": "090448" }, { "bank_name": "Support Mf Bank", "code": "090446" }, { "bank_name": "Capstone Mf Bank", "code": "090445" }, { "bank_name": "Boi Mf Bank", "code": "090444" }, { "bank_name": "Rima Microfinance Bank", "code": "090443" }, { "bank_name": "Giwa Microfinance Bank", "code": "090441" }, { "bank_name": "Cherish Microfinance Bank", "code": "090440" }, { "bank_name": "Ibeto Microfinance Bank", "code": "090439" }, { "bank_name": "Futminna Microfinance Bank", "code": "090438" }, { "bank_name": "Oakland Microfinance Bank", "code": "090437" }, { "bank_name": "Spectrum Microfinance Bank", "code": "090436" }, { "bank_name": "Insight Microfinance Bank", "code": "090434" }, { "bank_name": "Rigo Microfinance Bank", "code": "090433" }, { "bank_name": "Memphis Microfinance Bank", "code": "090432" }, { "bank_name": "Bluewhales Microfinance Bank", "code": "090431" }, { "bank_name": "Ilora Microfinance Bank", "code": "090430" }, { "bank_name": "Crossriver Microfinance Bank", "code": "090429" }, { "bank_name": "Ishie Microfinance Bank", "code": "090428" }, { "bank_name": "Ebsu Microfinance Bank", "code": "090427" }, { "bank_name": "Banex Microfinance Bank", "code": "090425" }, { "bank_name": "Abucoop Microfinance Bank", "code": "090424" }, { "bank_name": "Landgold Microfinance Bank", "code": "090422" }, { "bank_name": "Izon Microfinance Bank", "code": "090421" }, { "bank_name": "Winview Bank", "code": "090419" }, { "bank_name": "Highland Microfinance Bank", "code": "090418" }, { "bank_name": "Imowo Microfinance Bank", "code": "090417" }, { "bank_name": "Chibueze Microfinance Bank", "code": "090416" }, { "bank_name": "Calabar Microfinance Bank", "code": "090415" }, { "bank_name": "Crutech Microfinance Bank", "code": "090414" }, { "bank_name": "Benysta Microfinance Bank", "code": "090413" }, { "bank_name": "Preeminent Microfinance Bank", "code": "090412" }, { "bank_name": "Giginya Microfinance Bank", "code": "090411" }, { "bank_name": "Maritime Microfinance Bank", "code": "090410" }, { "bank_name": "Fcmb Microfinance Bank", "code": "090409" }, { "bank_name": "Gmb Microfinance Bank", "code": "090408" }, { "bank_name": "Business Support Microfinance Bank", "code": "090406" }, { "bank_name": "Moniepoint Microfinance Bank", "code": "090405" }, { "bank_name": "Olowolagba Microfinance Bank", "code": "090404" }, { "bank_name": "Uda Microfinance Bank", "code": "090403" }, { "bank_name": "Peace Microfinance Bank", "code": "090402" }, { "bank_name": "Shepherd Trust Microfinance Bank", "code": "090401" }, { "bank_name": "Finca Microfinance Bank", "code": "090400" }, { "bank_name": "Nwannegadi Microfinance Bank", "code": "090399" }, { "bank_name": "Federal Polytechnic Nekede Microfinance Bank", "code": "090398" }, { "bank_name": "Chanelle Bank", "code": "090397" }, { "bank_name": "Oscotech Microfinance Bank", "code": "090396" }, { "bank_name": "Borgu Microfinance Bank", "code": "090395" }, { "bank_name": "Amac Microfinance Bank", "code": "090394" }, { "bank_name": "Mozfin Microfinance Bank", "code": "090392" }, { "bank_name": "Davodani Microfinance Bank", "code": "090391" }, { "bank_name": "Parkway Mf Bank", "code": "090390" }, { "bank_name": "Ek-Reliable Microfinance Bank", "code": "090389" }, { "bank_name": "Interland Microfinance Bank", "code": "090386" }, { "bank_name": "Gti Microfinance Bank", "code": "090385" }, { "bank_name": "Kredi Money Microfinance Bank", "code": "090380" }, { "bank_name": "Peniel Micorfinance Bank Ltd", "code": "090379" }, { "bank_name": "New Golden Pastures Microfinance Bank", "code": "090378" }, { "bank_name": "Isaleoyo Microfinance Bank", "code": "090377" }, { "bank_name": "Apple Microfinance Bank", "code": "090376" }, { "bank_name": "Coastline Microfinance Bank", "code": "090374" }, { "bank_name": "Tf Microfinance Bank", "code": "090373" }, { "bank_name": "Legend Microfinance Bank", "code": "090372" }, { "bank_name": "Agosasa Microfinance Bank", "code": "090371" }, { "bank_name": "Ilasan Microfinance Bank", "code": "090370" }, { "bank_name": "Seedvest Microfinance Bank", "code": "090369" }, { "bank_name": "Corestep Microfinance Bank", "code": "090365" }, { "bank_name": "Nuture Microfinance Bank", "code": "090364" }, { "bank_name": "Headway Microfinance Bank", "code": "090363" }, { "bank_name": "Molusi Microfinance Bank", "code": "090362" }, { "bank_name": "Cashconnect Microfinance Bank", "code": "090360" }, { "bank_name": "Isuofia Microfinance Bank", "code": "090353" }, { "bank_name": "Jessefield Microfinance Bank", "code": "090352" }, { "bank_name": "Illorin Microfinance Bank", "code": "090350" }, { "bank_name": "Nasarawa Microfinance Bank", "code": "090349" }, { "bank_name": "Oau Microfinance Bank Ltd", "code": "090345" }, { "bank_name": "Citizen Trust Microfinance Bank Ltd", "code": "090343" }, { "bank_name": "Unilorin Microfinance Bank", "code": "090341" }, { "bank_name": "Stockcorp Microfinance Bank", "code": "090340" }, { "bank_name": "Uniuyo Microfinance Bank", "code": "090338" }, { "bank_name": "Iyeru Okin Microfinance Bank Ltd", "code": "090337" }, { "bank_name": "Bipc Microfinance Bank", "code": "090336" }, { "bank_name": "Oche Microfinance Bank", "code": "090333" }, { "bank_name": "Evergreen Microfinance Bank", "code": "090332" }, { "bank_name": "Unaab Microfinance Bank", "code": "090331" }, { "bank_name": "Fame Microfinance Bank", "code": "090330" }, { "bank_name": "Neptune Microfinance Bank", "code": "090329" }, { "bank_name": "Trust Microfinance Bank", "code": "090327" }, { "bank_name": "Balogun Gambari Microfinance Bank", "code": "090326" }, { "bank_name": "Ikenne Microfinance Bank", "code": "090324" }, { "bank_name": "Mainland Microfinance Bank", "code": "090323" }, { "bank_name": "Rephidim Microfinance Bank", "code": "090322" }, { "bank_name": "Mayfair Microfinance Bank", "code": "090321" }, { "bank_name": "Kadpoly Microfinance Bank", "code": "090320" }, { "bank_name": "Bonghe Microfinance Bank", "code": "090319" }, { "bank_name": "Federal University Dutse Microfinance Bank", "code": "090318" }, { "bank_name": "Bayero Microfinance Bank", "code": "090316" }, { "bank_name": "U And C Microfinance Bank", "code": "090315" }, { "bank_name": "Edfin Microfinance Bank", "code": "090310" }, { "bank_name": "Brightway Microfinance Bank", "code": "090308" }, { "bank_name": "Aramoko Microfinance Bank", "code": "090307" }, { "bank_name": "Sulsap Microfinance Bank", "code": "090305" }, { "bank_name": "Evangel Microfinance Bank", "code": "090304" }, { "bank_name": "Purplemoney Microfinance Bank", "code": "090303" }, { "bank_name": "Sunbeam Microfinance Bank", "code": "090302" }, { "bank_name": "Kontagora Microfinance Bank", "code": "090299" }, { "bank_name": "Federalpoly Nasarawamfb", "code": "090298" }, { "bank_name": "Alert Microfinance Bank", "code": "090297" }, { "bank_name": "Polyuwanna Microfinance Bank", "code": "090296" }, { "bank_name": "Omiye Microfinance Bank", "code": "090295" }, { "bank_name": "Eagle Flight Microfinance Bank", "code": "090294" }, { "bank_name": "Brethren Microfinance Bank", "code": "090293" }, { "bank_name": "Afekhafe Microfinance Bank", "code": "090292" }, { "bank_name": "Halacredit Microfinance Bank", "code": "090291" }, { "bank_name": "Fct Microfinance Bank", "code": "090290" }, { "bank_name": "Pillar Microfinance Bank", "code": "090289" }, { "bank_name": "Assets Matrix Microfinance Bank", "code": "090287" }, { "bank_name": "First Option Microfinance Bank", "code": "090285" }, { "bank_name": "Thrive Microfinance Bank", "code": "090283" }, { "bank_name": "Arise Microfinance Bank", "code": "090282" }, { "bank_name": "Megapraise Microfinance Bank", "code": "090280" }, { "bank_name": "Ikire Microfinance Bank", "code": "090279" }, { "bank_name": "Glory Microfinance Bank", "code": "090278" }, { "bank_name": "Meridian Microfinance Bank", "code": "090275" }, { "bank_name": "Prestige Microfinance Bank", "code": "090274" }, { "bank_name": "Coalcamp Microfinance Bank", "code": "090254" }, { "bank_name": "Yobe Microfinance Bank", "code": "090252" }, { "bank_name": "Itex Integrated Services Limited", "code": "090211" }, { "bank_name": "Accelerex Network", "code": "090202" }, { "bank_name": "Xpress Payments", "code": "090201" }, { "bank_name": "Girei Microfinance Bank", "code": "090186" }, { "bank_name": "Standard Microfinance Bank", "code": "090182" }, { "bank_name": "Balogun Fulani Microfinance Bank", "code": "090181" }, { "bank_name": "Rahama Microfinance Bank", "code": "090170" }, { "bank_name": "First Multiple Microfinance Bank", "code": "090163" }, { "bank_name": "Microvis Microfinance Bank", "code": "090113" }, { "bank_name": "Tajwallet", "code": "080002" }, { "bank_name": "Fha Mortgage Bank Ltd", "code": "070026" }, { "bank_name": "Akwa Savings & Loans Limited", "code": "070025" }, { "bank_name": "Homebase Mortgage", "code": "070024" }, { "bank_name": "Delta Trust Mortgage Bank", "code": "070023" }, { "bank_name": "Stb Mortgage Bank", "code": "070022" }, { "bank_name": "Coop Mortgage Bank", "code": "070021" }, { "bank_name": "Mayfresh Mortgage Bank", "code": "070019" }, { "bank_name": "Branch International Financial Services", "code": "050006" }, { "bank_name": "Aaa Finance", "code": "050005" }, { "bank_name": "Newedge Finance Ltd", "code": "050004" }, { "bank_name": "Sagegrey Finance Limited", "code": "050003" }, { "bank_name": "Fewchore Finance Company Limited", "code": "050002" }, { "bank_name": "County Finance Ltd", "code": "050001" }, { "bank_name": "Lotus Bank", "code": "000029" }, { "bank_name": "Central Bank Of Nigeria", "code": "000028" }, { "bank_name": "Optimus Bank", "code": "000036" }, { "bank_name": "Mercury MFB", "code": "090589" } ] ``` # Transaction History # Get Transaction Records This is a /GetWalletHistory endpoint for you to retrieve either history of a particular order number or get the entire history of your wallet. ### Get Wallet History You can use this endpoint to make two types of query * Query a single transaction: To know more about a transaction status, you can use the **"search\_partner\_order\_ref"** to query the transaction. If you are using this key, ignore the start and end data parameters * Query using date range: If you want to see all the history of activities on your wallet between a date range use the "start\_date" & "end\_date". While using this key, ignore the **search\_partner\_order\_ref** ## This endpoint is used to query wallet history or a transaction status history `POST` `https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/GetWalletHistory/` ## This endpoint is used to query wallet history or a transaction status history `POST` `https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/GetWalletHistory/` If #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ----------------------- | | Authorization\* | String | Bearer pk\_partner\_xxx | | Content-Type\* | String | application/json | #### Request Body | Name | Type | Description | | --------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | partner\_id\* | String | This is the partner\_id on IPC e.g p123456 | | start\_date | String | Start date of transaction history you want to query | | end\_date | String | End date of transaction history you want to query | | signature\* | String | Signed Hash of payload | | search\_partner\_order\_ref | String | This is the order\_ref in your system. e.g Ref:12345. If this field is NULL then the date parameters is used and a URL will be returned to get wallet history of the specified start & end date. | {% tabs %} {% tab title="200: OK successful response" %} ```javascript { success:true, message:string, data:{ account_name:''} } ``` {% endtab %} {% tab title="400: Bad Request Error " %} ```javascript {error:true, data:null} ``` {% endtab %} {% endtabs %} #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ------------ | | Authorization\* | String | 5rgJ3BfaIM83 | | Content-Type\* | String | w8v9pXIPaOmZ | #### Request Body | Name | Type | Description | | --------------------------------------------- | ------ | ------------ | | partner\_id\* | String | eUdpZQKnF8vi | | start\_date | String | ysGn3uTZHROk | | end\_date | String | ZE1xvZFDjYNb | | signature\* | String | JzFeXb60EnPL | | search\_partner\_order\_ref | String | hVAWGgT0bAMx | {% tabs %} {% tab title="Payload" %} ```json // Payload Sample to query using date parameters { "partner_id": "p123456", "intrapay_merchant_id": "intrapay_merchant_123456", "start_date": "2023-12-1", "end_date": "2023-12-31", "search_partner_order_ref": "", // leave order ref empty "signature": "e.g Signature here" } //Payload Sample to query for a single transaction { "partner_id": "p123456", "intrapay_merchant_id": "intrapay_merchant_123456", "start_date": "", // ignore start date "end_date": "", //ignore end date "search_partner_order_ref": "ref2587", "signature": "e.g Signature here" } ``` {% endtab %} {% tab title="Response" %} ```json //Payload Sample using date parameters query { "success": true, "message": "Fetch Wallet History", "data": { "data": null }, "download_url": "https://sampledownload.link" //this URL will download a CVS sheet to see all data. } } //Response Sample for a single transaction query { "success": true, "message": "Fetch Wallet History", "data": { "data": [ { "amount": 200000, "reference": "2587", "narration": "P2P_TXN_NAIRA_CLAIMED", "currency": "NGN", "created_at": "2023-12-15T12:34:50.000Z", "type": "CREDIT" } ], "download_url": null } } ``` {% endtab %} {% endtabs %}