Appearance
Customer bank details
For merchants
Optionally let logged-in customers store a bank account in their customer account. The account number is resolved with Flutterwave before it is saved, and the account holder's name comes from the bank. Off by default and independent of payments.
Turn it on
In the plugin settings:
- Enable Bank Data Collection — on.
- Bank Country — the two-letter code of the country whose banks should be listed (default
NG). - Show BVN Field / Require BVN — if you need a Bank Verification Number.
What the customer sees
A bank-account form on Account → Profile: bank (list loaded from Flutterwave for the configured country), account number, account name filled in after verification and, if enabled, the BVN. Stored details are shown on Account → Overview, with the BVN masked to its last 4 digits.
Account numbers must be exactly 10 digits
Validation expects a 10-digit account number (the Nigerian NUBAN format) and an 11-digit BVN, whatever Bank Country is set to. Customers with account numbers of another length — common outside Nigeria — cannot save their details.
About the BVN
The BVN is checked for format only (11 digits) and stored. It is not verified against the BVN registry: that needs a separate approval from Flutterwave and is planned for a later release.
Sandbox behaviour
Flutterwave's sandbox only resolves accounts at bank code 044. In sandbox mode the plugin uses 044 for the lookup automatically, while still storing the bank the customer chose.
Where the data is stored
On the customer, as custom fields:
| Field | Key |
|---|---|
| Bank name | kommandhub_flutterwave_bank_name |
| Bank code | kommandhub_flutterwave_bank_code |
| Account number | kommandhub_flutterwave_account_number |
| Account name | kommandhub_flutterwave_account_name |
| BVN | kommandhub_flutterwave_bvn |
Sensitive data
These values — including the BVN — are stored unencrypted in customer custom fields and are visible to Administration users who can view customers. Field-level encryption is planned for 1.0.0. Enable the BVN field only if you need it.
Uninstalling without keeping data removes the custom fields and all stored bank details.