Skip to main content

​
Virtual accounts

Virtual accounts give a customer bank-transfer details that are tied to their Inflow customer profile. Create the customer first, then assign the account once and store the returned account details in your system. This is only available for NGN

​
Assign an account

Pass the customer ID in the URL. If you omit provider, Inflow uses the default configured rail. Set provider only when your integration needs a specific supported rail.
The assignment endpoint can return an existing account when one has already been assigned. Make the request part of your customer-onboarding workflow, rather than repeatedly creating accounts at checkout.

​
Retrieve account details

When you need to display the details again, query the customer’s virtual accounts:
The response includes each assignment, its provider, and whether it is active. Display the exact accountName, accountNumber, and bankName returned by the API to reduce failed bank transfers. Show bank details in a copyable format, and include the account name beside the account number so the customer can confirm the beneficiary before making a transfer. If your application supports multiple bank accounts, label the bank name clearly and avoid asking the customer to type the account number manually. For the full request and response schema, see Assign a virtual account.