Int'l Payout & Collection
  • Start your global payment here
  • Partner & Merchant Onboarding
  • Getting Started for Partner
    • Partner Onboarding Endpoints
    • IP Capture & Whitelisting
    • Regenerate Partners Pub/Priv Keys
  • Getting Started for Merchant
  • Collection
    • Digital Signatures
    • Collection (MOMO)
    • Collection (Virtual Account-NGN )**
    • Fetch Order
    • Assigning Virtual Accounts
      • Get Available Assignable Virtual Account
      • Check if specific account is available for use
      • Create Order- using Available Virtual Account from your Account Pool
    • Cancel Order
    • Get Mobile Money Providers
  • Payout
    • Account verification
    • Payout
    • Payout Status
    • Crypto Withdrawal
    • Bank & Bank Codes
  • Transaction History
    • Get Transaction Records
Powered by GitBook
On this page
  1. Collection
  2. Assigning Virtual Accounts

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

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 

Example Request- Code

PreviousAssigning Virtual AccountsNextCheck if specific account is available for use

Last updated 1 year ago