Bank Collections API
Generate permanent virtual bank account numbers for collections.
# Bank Collections API
Generate a permanent virtual bank account number linked to your wallet/account for secure payments.
## Endpoint
- **Method**: POST
- **URL**: https://api.moolre.com/open/account/create
## Headers
| Header | Type | Required | Description |
| :--- | :--- | :--- | :--- |
| X-API-USER | string | Yes | Your Moolre username. |
| X-API-PUBKEY | string | Yes | Your Public API Key. |
## Request Body
| Parameter | Type | Required | Description |
| :--- | :--- | :--- | :--- |
| type | integer | Yes | Must be 9. |
| currency | string | Yes | Currency code: GHS (Ghana Cedis) or NGN (Nigerian Naira). |
| amount | number | No | Optional initial amount. When provided, it must be greater than 0. |
| firstname | string | Yes | First name of the account holder. |
| lastname | string | Yes | Last name of the account holder. |
| phone | string | Yes | Phone number of the account holder. |
| email | string | Yes | Email address of the account holder. |
| uref | string | Yes | Unique request reference. |
| accountnumber | string | Yes | Your Moolre Account Number. |
## Response (200 Success)
Bank account number created successfully.
```json
{
"status": 1,
"code": "AD19",
"message": "Account No. Creation Successful",
"data": {
"accountno": "0014730001001",
"accountname": "Kofi Adeniyi3 MoolrePay",
"bankname": "First Atlantic Bank",
"uref": "uref001"
},
"go": null
}
```
## Response (400 (Duplicate Name) Failed)
Bank account creation failed because the name is already in use.
```json
{
"status": 0,
"code": "AD32",
"message": "Account No. Creation Failed",
"data": "all",
"go": null
}
```