​
Supported partners

Below are the list of currently supported partners for virtual account issuing

  • VFD Microfinance Bank

​
Create Virtual Account

To create a virtual account, use the create collection endpoint.

Parameters

​
customer_id
string

The unique identifier for the customer to whom the card will be issued.

​
currency
string
required

The three-letter ISO currency code in uppercase.

​
merchant_name
string

merchant name that will be displayed on the virtual account. Required for ONE_TIME (Temporary) virtual account.

​
type
string
required

virtual account type e.g DEFAULT (Permanent), ONE_TIME (Temporary)

​
amount
integer

amount expected to be paid into the virtual account. Required for ONE_TIME (Temporary) virtual account.

Note: customer_id is required for (DEFAULT) permanent virtual account

Request Body
{
    "customer_id": "user",
    "currency": "NGN",
    "merchant_name": "Swerv",
    "amount": 10,
    "type": "ONE_TIME"
}

​
🔍 Get Collection Details

Retrieve detailed information of a specific collection with their unique identifier using the get collection endpoint.

Path Parameters

​
id
string
required

The unique identifier of the collection to retrieve.

​
🔍 Get All collections

Retrieve a list of all collections by sending a request to the get all collections endpoint.

Query Parameters

​
page
string
default:1
required

The page to return.

​
limit
string
default:10
required

The maximum number of results to return.

Response Example

The response provides an array of wallet objects, each containing comprehensive details about the wallets associated with your Swerv account.

Response
[
  {
    "account_name": "string",
    "account_number": "string",
    "account_type": "string",
    "balance": 100000, // Balance in the smallest currency unit
    "bank_address": "string",
    "bank_code": "string",
    "bank_name": "string",
    "created_at": "2024-01-01T00:00:00Z",
    "id": "wlt_123456789",
    "is_blocked": false,
    "pending_balance": 50000, // Pending balance in the smallest currency unit
    "reference": "string",
    "routing_number": "string",
    "total_received": 1500000, // Total amount received in the smallest currency unit
    "updated_at": "2024-01-02T00:00:00Z"
  }
  // ...other wallets
]

​
Supported partners

Below are the list of currently supported partners for virtual account issuing

  • VFD Microfinance Bank

​
Create Virtual Account

To create a virtual account, use the create collection endpoint.

Parameters

​
customer_id
string

The unique identifier for the customer to whom the card will be issued.

​
currency
string
required

The three-letter ISO currency code in uppercase.

​
merchant_name
string

merchant name that will be displayed on the virtual account. Required for ONE_TIME (Temporary) virtual account.

​
type
string
required

virtual account type e.g DEFAULT (Permanent), ONE_TIME (Temporary)

​
amount
integer

amount expected to be paid into the virtual account. Required for ONE_TIME (Temporary) virtual account.

Note: customer_id is required for (DEFAULT) permanent virtual account

Request Body
{
    "customer_id": "user",
    "currency": "NGN",
    "merchant_name": "Swerv",
    "amount": 10,
    "type": "ONE_TIME"
}

​
🔍 Get Collection Details

Retrieve detailed information of a specific collection with their unique identifier using the get collection endpoint.

Path Parameters

​
id
string
required

The unique identifier of the collection to retrieve.

​
🔍 Get All collections

Retrieve a list of all collections by sending a request to the get all collections endpoint.

Query Parameters

​
page
string
default:1
required

The page to return.

​
limit
string
default:10
required

The maximum number of results to return.

Response Example

The response provides an array of wallet objects, each containing comprehensive details about the wallets associated with your Swerv account.

Response
[
  {
    "account_name": "string",
    "account_number": "string",
    "account_type": "string",
    "balance": 100000, // Balance in the smallest currency unit
    "bank_address": "string",
    "bank_code": "string",
    "bank_name": "string",
    "created_at": "2024-01-01T00:00:00Z",
    "id": "wlt_123456789",
    "is_blocked": false,
    "pending_balance": 50000, // Pending balance in the smallest currency unit
    "reference": "string",
    "routing_number": "string",
    "total_received": 1500000, // Total amount received in the smallest currency unit
    "updated_at": "2024-01-02T00:00:00Z"
  }
  // ...other wallets
]