Skip to content

Testing Flutterwave Services

ChijiokeFLW edited this page Aug 29, 2023 · 2 revisions

Overview

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.

OTPs

Any OTP passed in test transactions will pass validation. However, you can use these special OTPs to mock specific error scenarios:

  1. WRONG OTP: 5548
  2. INSUFFICIENT FUNDS: 6648

Bank Accounts

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.

Mobile Money

Successful payments

To mock a successful mobile money payment, you can use any mobile number.

Failed payments

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

Cards

Card details to use to make a mock payment.

Successful payments

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 -

Failed payments

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 -

Bill Payments

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.

BVN Credentials

Use these mock data to test your BVN consent integration.

BVN First Name Last Name OTP
22222222280 Nibby Certifier 111111
22123456789 Nibby Certifier -