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
Request Body
Example Request- Code
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
Headers
Request Body
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
Headers
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
Request Body
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
Headers
Example Request- Code
Cancel Order
This endpoint is used to cancel an order.
POST
Headers
Request Body
example request -code
Last updated