-
Notifications
You must be signed in to change notification settings - Fork 6
Testing Flutterwave Services
When integrating a payment gateway, you'll need to test your implementation before going live.
We've got test card and bank account details for you to use when testing. The cards cover a variety of use cases and allow you to simulate both successful and failed transactions with different causes.
Any OTP passed in test transactions will pass validation. However, you can use these special OTPs to mock specific error scenarios:
- WRONG OTP:
5548
- INSUFFICIENT FUNDS:
6648
Bank account details to use to make a mock payment.
Bank | Account Number | OTP |
---|---|---|
Access Bank (044) | 0690000031 | 12345 |
Access Bank (044) | 0690000032 | 12345 |
Access Bank (044) | 0690000033 | 12345 |
Access Bank (044) | 0690000034 | 12345 |
Pro Tip: If you need more Access Bank test account numbers, you can keep incrementing the last digit of the test account numbers above to get new test account numbers, right up to 0690000041
.
To mock a successful mobile money payment, you can use any mobile number.
Mock failed transactions for your integration tests using any of the following numbers. Update the country code of each number to match the code of your customer's number.
Mobile number | Error code | Error message |
---|---|---|
233121212121 | 200 (Failed Authentication) | Mocked a Failed Transaction |
233010101011 | 400 (Failed Transaction) | Mocked a Failed Transaction |
Card details to use to make a mock payment.
Use these cards if you want the payment to succeed.
Type | Card Number | Expiry | CVV | PIN | OTP |
---|---|---|---|---|---|
MasterCard PIN Authentication | 5531886652142950 | 09/32 | 564 | 3310 | 12345 |
Mastercard PIN Authentication 2 | 5399838383838381 | 10/31 | 470 | 3310 | 12345 |
MasterCard 3DS Authentication | 5438898014560229 | 10/31 | 564 | 3310 | 12345 |
Visa Card 3DS Authentication | 4187427415564246 | 09/32 | 828 | 3310 | 12345 |
Visa Card 3DS Authentication 2 | 4242424242424242 | 01/31 | 812 | 3310 | 12345 |
Visa Card 3DS Authentication 3 | 4751763236699647 | 09/35 | - | - | - |
Verve Card No-auth | 5061460410120223210 | 12/31 | 780 | 3310 | 12345 |
Verve Card PIN Authentication 2 | 5061460166976054667 | 10/22 | - | 3310 | - |
Address Verification (AVS) Card | 4556052704172643 | 09/32 | 899 | 3310 | 12345 |
Pre-authorization Test Card. | 5377283645077450 | 09/31 | 789 | 3310 | - |
Use these cards if you want the payment to fail.
Type | Card Number | Expiry | CVV | PIN | OTP |
---|---|---|---|---|---|
Card Declined (Address Verification) | 5143010522339965 | 08/32 | 276 | 3310 | 12345 |
Card Fraudulent | 5590131743294314 | 12/32 | 887 | 3310 | 12345 |
Card Insufficient Funds | 5258585922666506 | 09/31 | 883 | 3310 | 12345 |
Do Not Honor | 5143010522339965 | 08/31 | 276 | 3310 | - |
Insufficient Funds | 5258585922666506 | 09/31 | 883 | 3310 | 12345 |
Invalid Transaction | 5551658157653822 | 08/31 | 276 | - | - |
Restricted Card, Retain Card | 5551651630381384 | 08/31 | 276 | - | - |
Function Not Permitted to Cardholder | 5258582054729020 | 11/30 | 887 | - | - |
Function Not Permitted to Terminal | 5258588264565682 | 11/30 | 887 | - | - |
Transaction Error | 5258589130149016 | 11/30 | 887 | - | - |
Incorrect PIN | 5399834697894723 | 09/31 | 883 | 3310 | 12345 |
Verve Card - Card enrollment | 5531882884804517 | 10/32 | 564 | 3310 | - |
Here are some credentials to help you test some billers.
Biller | Credential Type | Credentials |
---|---|---|
DSTV | Smart card number | 0025401100 |
EKEDC | Meter number | 1101160434535 |
The Biller type for making mock DSTV payments is DSTV Payment
.
Use these mock data to test your BVN consent integration.
BVN | First Name | Last Name | OTP |
---|---|---|---|
22222222280 | Nibby | Certifier | 111111 |
22123456789 | Nibby | Certifier | - |