{"id":64,"date":"2025-05-20T04:15:31","date_gmt":"2025-05-20T04:15:31","guid":{"rendered":"https:\/\/documentation.iqonic.design\/frezka\/?p=64"},"modified":"2026-03-10T09:21:35","modified_gmt":"2026-03-10T09:21:35","slug":"flutterwave-payment","status":"publish","type":"post","link":"https:\/\/documentation.iqonic.design\/frezka\/flutterwave-payment\/","title":{"rendered":"FlutterWave Payment"},"content":{"rendered":"<div class=\"nolwrap\">\n<pre class=\"wp-block-preformatted\">Estimated reading: 3 minutes<\/pre>\n\n\n\n<p>Welcome to FlutterWave! In this guide, you will learn how to sign up for a FlutterWave account and obtain API keys necessary for integrating FlutterWave into your website or application.<\/p>\n\n\n\n<p>If you have an existing FlutterWave business account\u00a0<a href=\"https:\/\/idp.flutterwave.com\/realms\/flutterwave\/protocol\/openid-connect\/auth?client_id=2e5450b8-ee6a-4e5d-b6db-cd9240b5bba3&amp;redirect_uri=https%3A%2F%2Fdevelopersandbox.flutterwave.com%2Fexchange&amp;response_type=code&amp;scope=openid\" target=\"_blank\" rel=\"noreferrer noopener\">Login<\/a>,to the account.<\/p>\n\n\n\n<p>Otherwise,\u00a0<a href=\"https:\/\/onboarding.flutterwave.com\/signup\/steps\/645ccc96f618c2250a85af46\" target=\"_blank\" rel=\"noopener\">Sign up<\/a>\u00a0and create a new business account.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Sign Up for FlutterWave<\/strong><\/h2>\n\n\n\n<p>1. <strong>Visit the FlutterWave Website<\/strong>: Go to\u00a0<a href=\"https:\/\/developer.flutterwave.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">FlutterWave&#8217;s website<\/a>.<\/p>\n\n\n\n<p>2. <strong>Sign Up<\/strong>: Click on the &#8220;Sign Up&#8221; button located at the top right corner of the page.<\/p>\n\n\n\n<p>3. <strong>Provide Your Details<\/strong>: Fill out the registration form with your email address, preferred password, and other required information. Make sure to provide accurate details.<\/p>\n\n\n\n<p>4. <strong>Verify Your Email<\/strong>: After submitting the form, check your email inbox for a verification message from FlutterWave. Click on the verification link provided in the email to verify your account.<\/p>\n\n\n\n<p>5. <strong>Complete Your Profile<\/strong>: Once your account is verified, log in to FlutterWave and complete your profile by providing additional information such as your business name, address, and contact details.<\/p>\n\n\n\n<p><strong>TIP<\/strong><\/p>\n\n\n\n<p>Congratulations! You have successfully signed up for a FlutterWave account.Now, let&#8217;s proceed to&nbsp;<a href=\"https:\/\/documentation.iqonic.design\/frezka\/payment-gateway\/flutterwave-payment\">obtaining your API keys<\/a><\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Obtain API Keys<\/strong><\/h2>\n\n\n\n<p>FlutterWave provides API keys that are necessary for integrating its payment gateway and other services into your website or application.<\/p>\n\n\n\n<p><strong>INFO<\/strong><\/p>\n\n\n\n<p>There are two &#8220;modes&#8221; of operation for your FlutterWave account:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Live Mode<\/strong>: Real money, real transactions, real effects.<\/li>\n\n\n\n<li><strong>Test Mode<\/strong>: No real money is involved. Only our test cards and bank accounts can be used.<\/li>\n<\/ul>\n\n\n\n<p>Follow these steps to obtain your API keys:<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Get an API Key for the First Time<a href=\"https:\/\/apps.iqonic.design\/documentation\/frezka-doc\/build\/docs\/payment-gateway\/flutterwave-payment#get-an-api-key-for-the-first-time\" target=\"_blank\" rel=\"noopener\">\u200b<\/a><\/strong><\/h2>\n\n\n\n<p>To generate API keys on FlutterWave for the first time, follow these steps:<\/p>\n\n\n\n<p>1. <strong>Access Settings<\/strong>: Log in to your&nbsp;<a href=\"https:\/\/dashboard.flutterwave.com\/login\" target=\"_blank\" rel=\"noreferrer noopener\">FlutterWave dashboard<\/a>.<\/p>\n\n\n\n<p>2. <strong>Navigate to API Keys<\/strong>: Click on the&nbsp;<strong>&#8220;Settings&#8221;<\/strong>&nbsp;section and then select&nbsp;<strong>&#8220;API Keys&#8221;<\/strong>&nbsp;under the Developers tab.<\/p>\n\n\n\n<p>3. <strong>Generate Secret Key<\/strong>: Click on the &#8220;Generate Secret Key&#8221; button to obtain your live Secret key. An authentication code will be sent to the email address associated with your FlutterWave account.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1918\" height=\"968\" src=\"https:\/\/documentation.iqonic.design\/frezka\/wp-content\/uploads\/sites\/13\/2025\/05\/FlutterWave_Payment1.png\" alt=\"\" class=\"wp-image-609\" \/><\/figure>\n\n\n\n<p>4. <strong>Enter Authentication Code<\/strong>: Check your email inbox for the 7-digit authentication code sent by FlutterWave. Enter this code in the designated field to complete the generation process.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Generate New API Keys<\/strong><\/h2>\n\n\n\n<p>If you already have an API key and need to generate new ones, follow these steps:<\/p>\n\n\n\n<p>1. <strong>Access Settings<\/strong>: Log in to your FlutterWave dashboard.<\/p>\n\n\n\n<p>2. <strong>Navigate to API Keys<\/strong>: Click on the&nbsp;<strong>&#8220;Settings&#8221;<\/strong>&nbsp;section and then select&nbsp;<strong>&#8220;API Keys&#8221;<\/strong>&nbsp;under the Developers tab.<\/p>\n\n\n\n<p>3. <strong>Generate New Keys<\/strong>: Click on the&nbsp;<strong>&#8220;Generate New Key&#8221;<\/strong>&nbsp;button to obtain your new live API keys.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1918\" height=\"968\" src=\"https:\/\/documentation.iqonic.design\/frezka\/wp-content\/uploads\/sites\/13\/2025\/05\/FlutterWave_Payment2.png\" alt=\"\" class=\"wp-image-610\" \/><\/figure>\n\n\n\n<p>4. <strong>Set Expiration Period(Optional)<\/strong>:If required, you can set an expiration period for your current API keys.<\/p>\n\n\n\n<p>5. <strong>Enter Authentication Code<\/strong>: Enter the 7-digit authentication code sent to your email address and click on&nbsp;<strong>&#8220;Generate new API keys&#8221;<\/strong>.<\/p>\n\n\n\n<p><strong>INFO<\/strong><\/p>\n\n\n\n<p>You&#8217;re given three kinds of API keys:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Secret Key<\/strong>: The most powerful type of key. It can authorize any action on your account, so it should never be exposed to the public.<\/li>\n\n\n\n<li><strong>Public Key<\/strong>: The key you&#8217;ll use in &#8220;public&#8221; scenarios.<\/li>\n\n\n\n<li><strong>Encryption Key<\/strong>: Only used with the direct card charge endpoint. See the encryption guide for details.<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Add Generated Keys To Admin Panel<\/strong><\/h2>\n\n\n\n<p>Now you&#8217;ve successfully generated keys please navigate to Admin Panel and follow the steps mentioned below<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Navigate to&nbsp;<strong>Settings \u2192 Payment Method<\/strong>.<\/li>\n\n\n\n<li>Enable the switch for&nbsp;<strong>FlutterWave<\/strong>&nbsp;Payment.<\/li>\n\n\n\n<li>Paste&nbsp;<strong>Secret Key<\/strong>&nbsp;under the&nbsp;<em>Secret Key<\/em>&nbsp;field and&nbsp;<strong>Public Key<\/strong>&nbsp;under the<br><em>App Key<\/em>&nbsp;fields.<\/li>\n\n\n\n<li>Submit the changes.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1559\" height=\"739\" src=\"https:\/\/documentation.iqonic.design\/frezka\/wp-content\/uploads\/sites\/13\/2025\/05\/FlutterWave_Payment3.png\" alt=\"\" class=\"wp-image-611\" \/><\/figure>\n\n\n\n<p><strong>TIP<\/strong><\/p>\n\n\n\n<p>Congratulations! Your FlutterWave configuration is done.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Test FlutterWave Payment<\/strong><\/h2>\n\n\n\n<p>Below is a table listing various test card details that you can use for testing purposes.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Successful Payment<\/strong><\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Card Number<\/th><th>Description<\/th><th>CVV<\/th><th>PIN<\/th><th>Expiry<\/th><th>OTP<\/th><\/tr><\/thead><tbody><tr><td>4242424242424242<\/td><td>Visa Card with Successful Payment<\/td><td>812<\/td><td>3310<\/td><td>09\/31<\/td><td>12345<\/td><\/tr><tr><td>5531886652142950<\/td><td>Mastercard with Successful Payment<\/td><td>564<\/td><td>3310<\/td><td>09\/32<\/td><td>12345<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Failed Payment<\/strong><\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Card Number<\/th><th>Description<\/th><th>CVV<\/th><th>PIN<\/th><th>Expiry<\/th><th>OTP<\/th><\/tr><\/thead><tbody><tr><td>5143010522339965<\/td><td>Visa Card with Failed Payment (Card Declined)<\/td><td>276<\/td><td>3310<\/td><td>08\/32<\/td><td>12345<\/td><\/tr><tr><td>5551658157653822<\/td><td>Mastercard with Failed Payment (Invalid Transaction)<\/td><td>276<\/td><td>&#8211;<\/td><td>08\/31<\/td><td>12345<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>These test cards can be used for simulating different scenarios during your development and testing phases. Remember, these cards are for testing purposes only and should not be used for real transactions.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Remove FlutterWave Payment<\/strong><\/h2>\n\n\n\n<p>Two ways to remove FlutterWave payment gateway<\/p>\n\n\n\n<p><strong>1. Permanent removal from code<a href=\"https:\/\/apps.iqonic.design\/documentation\/frezka-doc\/build\/docs\/payment-gateway\/flutterwave-payment#1-permanent-removal-from-code\" target=\"_blank\" rel=\"noopener\">\u200b<\/a><\/strong><\/p>\n\n\n\n<p>1. Open your pubspec.yaml file.<\/p>\n\n\n\n<p>2. Locate the following lines and remove them:<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">flutterwave_standard:<br>    git:<br>        url: https:\/\/github.com\/iqonic-design\/flutterwave_standard.git<br>        ref: main<\/pre>\n\n\n\n<p>3. Save the file and run the following command to update your project:<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">flutter pub get<\/pre>\n\n\n\n<p>4. Remove any code related to FlutterWave in your project to ensure no references remain.<\/p>\n\n\n\n<p><strong>NOTE<\/strong><\/p>\n\n\n\n<p>If you have remove dependency from pubspec.yaml then hit the pub get command. now, remove the code related to&nbsp;<strong>flutterwave_standard<\/strong>.<\/p>\n\n\n\n<p><strong>2. Temporary disablement (recommended for temporary use cases)<\/strong><\/p>\n\n\n\n<p>1. Open the Admin Panel of your application.<\/p>\n\n\n\n<p>2. Navigate to: Settings \u2192 Payment Method.<\/p>\n\n\n\n<p>3. Locate the FlutterWave option and turn off the toggle to disable it temporarily.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Related FAQs About API Keys<\/strong><\/h2>\n\n\n\n<p><strong>Why Can&#8217;t I View My API Keys?<\/strong><\/p>\n\n\n\n<p>To keep your account safe, we don&#8217;t allow you to view your API keys more than once. Instead, download your secret API key immediately after generating it using the &#8220;Download Secret Key&#8221; button. The key will no longer appear once you leave this page.<\/p>\n\n\n\n<p><strong>What Happens When I Generate New API Keys?<\/strong><\/p>\n\n\n\n<p>When you generate new API keys, the old keys will expire after the set expiry period, depending on the period you set when generating the API keys. To avoid downtime, you must update your application with the new API keys before the old keys expire.<br><a href=\"https:\/\/apps.iqonic.design\/documentation\/frezka-doc\/build\/docs\/payment-gateway\/paypal-payment\" target=\"_blank\" rel=\"noopener\"><\/a><\/p>\n<\/div>","protected":false},"excerpt":{"rendered":"<p>Estimated reading: 3 minutes Welcome to FlutterWave! In this guide, you will learn how to sign up for a FlutterWave account and obtain API keys necessary for integrating FlutterWave into your website or application. If you have an existing FlutterWave business account\u00a0Login,to the account. Otherwise,\u00a0Sign up\u00a0and create a new business account. Sign Up for FlutterWave [&hellip;]<\/p>\n","protected":false},"author":11,"featured_media":0,"parent":30,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-64","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"featured_image_src":null,"author_info":{"display_name":"laraveladminiq","author_link":"https:\/\/documentation.iqonic.design\/frezka\/author\/laraveladminiq\/"},"children":[],"_links":{"self":[{"href":"https:\/\/documentation.iqonic.design\/frezka\/wp-json\/wp\/v2\/posts\/64","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/documentation.iqonic.design\/frezka\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/documentation.iqonic.design\/frezka\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/documentation.iqonic.design\/frezka\/wp-json\/wp\/v2\/users\/11"}],"replies":[{"embeddable":true,"href":"https:\/\/documentation.iqonic.design\/frezka\/wp-json\/wp\/v2\/comments?post=64"}],"version-history":[{"count":9,"href":"https:\/\/documentation.iqonic.design\/frezka\/wp-json\/wp\/v2\/posts\/64\/revisions"}],"predecessor-version":[{"id":1528,"href":"https:\/\/documentation.iqonic.design\/frezka\/wp-json\/wp\/v2\/posts\/64\/revisions\/1528"}],"up":[{"embeddable":true,"href":"https:\/\/documentation.iqonic.design\/frezka\/wp-json\/wp\/v2\/posts\/30"}],"wp:attachment":[{"href":"https:\/\/documentation.iqonic.design\/frezka\/wp-json\/wp\/v2\/media?parent=64"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/documentation.iqonic.design\/frezka\/wp-json\/wp\/v2\/categories?post=64"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/documentation.iqonic.design\/frezka\/wp-json\/wp\/v2\/tags?post=64"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}