{"_id":"56d88886b159f10b00304619","__v":0,"parentDoc":null,"project":"549a321bf876ae0b00f33623","category":{"_id":"56d88885b159f10b0030460e","pages":["56d88886b159f10b00304618","56d88886b159f10b00304619","56d88886b159f10b0030461a","56d88886b159f10b0030461b"],"version":"56d88884b159f10b00304609","__v":1,"project":"549a321bf876ae0b00f33623","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-01-27T21:23:44.048Z","from_sync":false,"order":4,"slug":"stripe-gateway-extension","title":"Stripe Payment Gateway Extension"},"user":"549a320d5b50c21400fae689","version":{"_id":"56d88884b159f10b00304609","__v":3,"project":"549a321bf876ae0b00f33623","createdAt":"2016-03-03T18:55:00.567Z","releaseDate":"2016-03-03T18:55:00.567Z","categories":["56d88885b159f10b0030460a","56d88885b159f10b0030460b","56d88885b159f10b0030460c","56d88885b159f10b0030460d","56d88885b159f10b0030460e","56d88885b159f10b0030460f","56d88885b159f10b00304610","56d88885b159f10b00304611","56d88885b159f10b00304612","56d88885b159f10b00304613","56d88885b159f10b00304614","56d89250b159f10b003046d4","56da13977222d50b0070167c"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.2.1","version":"2.2.1"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-01-28T01:07:33.401Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Installation\"\n}\n[/block]\nTo install the Stripe Gateway API Extension log into the admin panel of your WordPress site. \nGo to Plugins. Click \"Add New.\" On the next page click \"Upload Plugin.\" \nOn the Add Plugins page click Choose File, navigate to where the Stripe extension zip file is located on your computer, click on the zip file then click \"Open\". Once the file has been chosen click \"Install Now.\" When the plugin installation is finished click \"Activate this plugin\"\n\nThe Stripe Gateway API plugin should now be activated.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Getting Started\"\n}\n[/block]\nOnce you have installed the plugin you can then enable the stripe gateway. \n\nFrom the WordPress admin navigate to LifterLMS->Settings and click on the tab Gateways.\nYou will see a section titled Stripe.\n\nIn the Stripe section you can activate your stripe plugin by entering the activation key in the text box titled Activation Key. You should have received an activation key when you purchased the extension.\n\nTo enable credit card processing through Stripe you will check the box \"Enable Stripe Payment Gateway\" You will also need to enter your Live and Test keys to enable Stripe for payment processing. See next section for setting your secret and publish keys.\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Setting Secret and Publish Keys\"\n}\n[/block]\nTo enable the Stripe gateway to accept credit cards you need to enter your stripe accounts Live and Test Secret / Publishable Keys.\n\nIf you do not have a Stripe account you will need to create one at [stripe.com](http://stripe.com). \n\nLog into your Stripe account. Click on your stripe username in the top right corner.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/wXjiifgCTfaoI0thft7J_Dashboard%202.png\",\n        \"Dashboard 2.png\",\n        \"961\",\n        \"273\",\n        \"#35516f\",\n        \"\"\n      ],\n      \"caption\": \"\"\n    }\n  ]\n}\n[/block]\nOn the Account Settings click on the tab API Keys. On this tab you will see all of the keys that you need to add to the Stripe API settings in LifterLMS. Copy each key and enter it into the corresponding key field in the LifterLMS Stripe gateway settings.\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"Make sure you are on the latest Stripe API version\",\n  \"body\": \"On the API Keys tab you will see a section titled API version. It will alert you if you are not on the current version of the Stripe API. If you are not on the current version you must update your Stripe API to the latest version by clicking \\\"Update.\\\" See image below for where the API version is located on the API Keys tab.\"\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/MPxc6D0dS3uOAxIYBkaY_API_Key_Settings.png\",\n        \"API_Key_Settings.png\",\n        \"979\",\n        \"609\",\n        \"#213a4f\",\n        \"\"\n      ],\n      \"caption\": \"Update to the latest stripe API version and copy the test and live keys to LifterLMS->Settings->Gateways->Stripe\"\n    }\n  ]\n}\n[/block]\nOnce you have entered all four keys and checked \"Enable Stripe Payment Gateway\" click \"Save Changes\"\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Enabling Test Mode\"\n}\n[/block]\nTo enable test mode to run test transactions using the Stripe credit card gateway go to LifterLMS->Settings->Gateways and scroll to the Stripe section. Check the box \"Enable Stripe Test Mode\" and click \"Save Changes\"\n\nAll transactions will now run to stripe as test transactions. You can verify the transactions by going to your Stripe account and toggling from Live to Test.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Enabling Debug Mode\"\n}\n[/block]\nIf you're encountering issues with payment processing, it may be helpful to enable Debug mode to display responses from Stripe during payment processing and customer creation.\n\nTo enabled Debug mode, navigate to LifterLMS->settings->Gateways and scroll to the Stripe section. Check the box that says \"Enable Debug Mode\" and click \"Save Changes\" at the bottom of the screen.\n\nWhenever payment processing errors (of any kind) are encountered using stripe, you will receive additional on-screen information useful debugging payment issues.\n\nWe recommend only enabling debug mode during testing and staging as your customers will see debug output when enabled.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Security and SSL\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"An SSL Certificate is Required for Real Transactions\",\n  \"body\": \"LifterLMS Stripe will *not* function in Live mode without an SSL Certificate\"\n}\n[/block]\nLifterLMS Stripe Payment Gateway will not function in Live Mode without an SSL Certificate. For help  purchasing or installing an SSL certificate, please contact your hosting provider or systems administrator.\n\nYou may, however, process transactions without an SSL certificate when Test Mode is enabled.\n\nFor more information, please consult Stripe's [SSL Documentation](https://stripe.com/help/ssl).","excerpt":"","slug":"installation-and-configuration-for-lifterlms-stripe-payment-gateway","type":"basic","title":"Installation and Configuration for LifterLMS Stripe Payment Gateway"}

Installation and Configuration for LifterLMS Stripe Payment Gateway


[block:api-header] { "type": "basic", "title": "Installation" } [/block] To install the Stripe Gateway API Extension log into the admin panel of your WordPress site. Go to Plugins. Click "Add New." On the next page click "Upload Plugin." On the Add Plugins page click Choose File, navigate to where the Stripe extension zip file is located on your computer, click on the zip file then click "Open". Once the file has been chosen click "Install Now." When the plugin installation is finished click "Activate this plugin" The Stripe Gateway API plugin should now be activated. [block:api-header] { "type": "basic", "title": "Getting Started" } [/block] Once you have installed the plugin you can then enable the stripe gateway. From the WordPress admin navigate to LifterLMS->Settings and click on the tab Gateways. You will see a section titled Stripe. In the Stripe section you can activate your stripe plugin by entering the activation key in the text box titled Activation Key. You should have received an activation key when you purchased the extension. To enable credit card processing through Stripe you will check the box "Enable Stripe Payment Gateway" You will also need to enter your Live and Test keys to enable Stripe for payment processing. See next section for setting your secret and publish keys. [block:api-header] { "type": "basic", "title": "Setting Secret and Publish Keys" } [/block] To enable the Stripe gateway to accept credit cards you need to enter your stripe accounts Live and Test Secret / Publishable Keys. If you do not have a Stripe account you will need to create one at [stripe.com](http://stripe.com). Log into your Stripe account. Click on your stripe username in the top right corner. [block:image] { "images": [ { "image": [ "https://files.readme.io/wXjiifgCTfaoI0thft7J_Dashboard%202.png", "Dashboard 2.png", "961", "273", "#35516f", "" ], "caption": "" } ] } [/block] On the Account Settings click on the tab API Keys. On this tab you will see all of the keys that you need to add to the Stripe API settings in LifterLMS. Copy each key and enter it into the corresponding key field in the LifterLMS Stripe gateway settings. [block:callout] { "type": "danger", "title": "Make sure you are on the latest Stripe API version", "body": "On the API Keys tab you will see a section titled API version. It will alert you if you are not on the current version of the Stripe API. If you are not on the current version you must update your Stripe API to the latest version by clicking \"Update.\" See image below for where the API version is located on the API Keys tab." } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/MPxc6D0dS3uOAxIYBkaY_API_Key_Settings.png", "API_Key_Settings.png", "979", "609", "#213a4f", "" ], "caption": "Update to the latest stripe API version and copy the test and live keys to LifterLMS->Settings->Gateways->Stripe" } ] } [/block] Once you have entered all four keys and checked "Enable Stripe Payment Gateway" click "Save Changes" [block:api-header] { "type": "basic", "title": "Enabling Test Mode" } [/block] To enable test mode to run test transactions using the Stripe credit card gateway go to LifterLMS->Settings->Gateways and scroll to the Stripe section. Check the box "Enable Stripe Test Mode" and click "Save Changes" All transactions will now run to stripe as test transactions. You can verify the transactions by going to your Stripe account and toggling from Live to Test. [block:api-header] { "type": "basic", "title": "Enabling Debug Mode" } [/block] If you're encountering issues with payment processing, it may be helpful to enable Debug mode to display responses from Stripe during payment processing and customer creation. To enabled Debug mode, navigate to LifterLMS->settings->Gateways and scroll to the Stripe section. Check the box that says "Enable Debug Mode" and click "Save Changes" at the bottom of the screen. Whenever payment processing errors (of any kind) are encountered using stripe, you will receive additional on-screen information useful debugging payment issues. We recommend only enabling debug mode during testing and staging as your customers will see debug output when enabled. [block:api-header] { "type": "basic", "title": "Security and SSL" } [/block] [block:callout] { "type": "danger", "title": "An SSL Certificate is Required for Real Transactions", "body": "LifterLMS Stripe will *not* function in Live mode without an SSL Certificate" } [/block] LifterLMS Stripe Payment Gateway will not function in Live Mode without an SSL Certificate. For help purchasing or installing an SSL certificate, please contact your hosting provider or systems administrator. You may, however, process transactions without an SSL certificate when Test Mode is enabled. For more information, please consult Stripe's [SSL Documentation](https://stripe.com/help/ssl).