Payments overview page, stubs for pages TBD (#301)

Author: lisastreeter

user/pages/03.commerce2/02.developer-guide/05.payments/01.available-gateways/docs.md

@@ -4,9 +4,9 @@ taxonomy:
 category: docs
 ---
 
-Drupal Commerce can be integrated with payment providers from all over the world. This page provides a list of the **93 contributed payment gateway modules** that currently exist. See the documentation on [Extending Drupal Commerce](../../02.install-update/06.extending) for information on adding one or more of these modules to your Drupal Commerce project and the [Install and Configure a Payment Gateway](../02.install-configure-gateways) documentation for information on configuration.
+Drupal Commerce can be integrated with payment providers from all over the world. This page provides a list of the **93 contributed payment gateway modules** that currently exist. See the documentation on [Extending Drupal Commerce](../../02.install-update/06.extending) for information on adding one or more of these modules to your Drupal Commerce project and the [Install and Configure a Payment Gateway](../install-configure-gateways) documentation for information on configuration.
 
-If you don't see a payment provider you want for your project, Drupal Commerce provides a framework for implementing your own online payment gateways. See the [Creating payment gateways](../04.create-payment-gateway) documentation for more information. 
+If you don't see a payment provider you want for your project, Drupal Commerce provides a framework for implementing your own online payment gateways. See the [Creating payment gateways](../create-payment-gateway) documentation for more information. 
 
 If you create your own payment gateway module or find one that's not in this list yet, please [let us know about it] so that we can add it.
 

user/pages/03.commerce2/02.developer-guide/05.payments/02.getting-started/docs.md

@@ -15,7 +15,7 @@ Click the *Add payment gateway* button to create a payment gateway. By default,
 
 ![Payment gateway configuration](../images/getting-started-02.png)
 
-If you would like to configure your site to use an actual gateway for a real Payment Provider, see the [Installing and Configure a Payment Gateway](../02.install-configure-gateways) documentation.
+If you would like to configure your site to use an actual gateway for a real Payment Provider, see the [Installing and Configure a Payment Gateway](../install-configure-gateways) documentation.
 
 ### Configuring your payment gateway
 Enter a *Name* and *Machine name* for your payment gateway. The name you enter will only be used internally, for identification by administrative users. The machine name will be automatically set based on the name you enter, but you can change it now if you want. Once the payment gateway has been created, you won't be able to change its machine name.

user/pages/03.commerce2/02.developer-guide/05.payments/02.install-configure-gateways/docs.md renamed to user/pages/03.commerce2/02.developer-guide/05.payments/03.install-configure-gateways/docs.md

@@ -5,14 +5,14 @@ taxonomy:
 ---
 
 
-While configuring your store you would probably want to install and configure a payment gateway provider module so that you can accept online payments. Currently available payment gateways for Commerce 2 are listed [here](../01.available-gateways).
+While configuring your store you would probably want to install and configure a payment gateway provider module so that you can accept online payments. Currently available payment gateways for Commerce 2 are listed [here](../available-gateways).
 
 This tutorial will guide you through configuring a payment gateway provider using the Commerce PayPal module as an example.
 
 Install the Module
 ------------------
 
-The first step is to install the module that provides integration with the desired payment gateway. In this case, Commerce PayPal. Drupal Commerce requires Composer and most related modules would have the same requirement - see [Using Composer](../../../01.getting-started/01.using-composer). For specific installation instructions check the module's documentation.
+The first step is to install the module that provides integration with the desired payment gateway. In this case, Commerce PayPal. Drupal Commerce requires Composer and most related modules would have the same requirement - see [Using Composer](../../../getting-started/using-composer). For specific installation instructions check the module's documentation.
 
 Add a Payment Gateway
 ---------------------

user/pages/03.commerce2/02.developer-guide/05.payments/04.payments-information-structure/docs.md

@@ -0,0 +1,12 @@
+---
+title: Payments information structure
+taxonomy:
+    category: docs
+---
+
+! We need help filling out this section! Feel free to follow the *edit this page* link and contribute.
+
+- payment, payment gateway, payment method entities
+- payment gateway plugins, payment types, payment method types
+- payment options, credit card / credit card type objects
+- payment order manager, payment statuses

user/pages/03.commerce2/02.developer-guide/05.payments/03.overriding-payment-config/docs.md renamed to user/pages/03.commerce2/02.developer-guide/05.payments/05.overriding-payment-config/docs.md

@@ -6,7 +6,7 @@ taxonomy:
 
 There are cases where a developer or site admin would want to define certain configuration related to a payment gateway in the site's settings.php file, instead of storing them in the database or define them in the code as exported configuration. Not exposing API credentials for security reasons would be such a case. In such cases, we would want to define the payment gateway using test credentials, and then override them in our settings.php file.
 
-This tutorial will guide you through overriding a payment gateway's configuration using the Commerce PayPal module as an example. It is assumed that this or another payment gateway provider module is installed and a payment gateway has been created in the store - see [Installing and Configuring a Payment Gateway](../../09.payments/02.install-configure-gateways). Building on that example, we will override the API credentials configuration for the PayPal Express Checkout payment gateway. In a production site, the payment gateway may have been exported in the code as configuration - see [Managing your site's configuration](https://www.drupal.org/docs/8/configuration-management/managing-your-sites-configuration).
+This tutorial will guide you through overriding a payment gateway's configuration using the Commerce PayPal module as an example. It is assumed that this or another payment gateway provider module is installed and a payment gateway has been created in the store - see [Installing and Configuring a Payment Gateway](../install-configure-gateways). Building on that example, we will override the API credentials configuration for the PayPal Express Checkout payment gateway. In a production site, the payment gateway may have been exported in the code as configuration - see [Managing your site's configuration](https://www.drupal.org/docs/8/configuration-management/managing-your-sites-configuration).
 
 ## Finding the Configuration Settings Names