# Payment Methods

{% embed url="<https://youtu.be/Lp-5KRA2nnk?feature=shared>" %}

In the **Payment Methods** section, you can configure the various native payment gateways of MasterStudy for your online platform. These payment methods allow you to accept payments from users for courses, products, or services as a **one-time payment.**&#x20;

{% hint style="info" %}
**One-time payment** means that the student pays for the course one time only and gets **full** access to its content forever. Moreover, courses can be sold with [subscriptions](https://docs.stylemixthemes.com/masterstudy-theme-documentation/additional-features/masterstudy-theme-manual-membership-system) and [points](https://docs.stylemixthemes.com/masterstudy-theme-documentation/masterstudy-lms-pro-addons/masterstudy-theme-manual-point-system) as well.

***

If [**WooCommerce Checkout**](https://docs.stylemixthemes.com/masterstudy-theme-documentation/woocommerce) is being used to sell courses, these payment methods (native payment methods of MasterStudy) will be **deactivated automatically.** You can manage the WooCommerce Checkout in **MS LMS > Settings > eCommerce > Checkout** tab.
{% endhint %}

{% content-ref url="../../woocommerce" %}
[woocommerce](https://docs.stylemixthemes.com/masterstudy-theme-documentation/woocommerce)
{% endcontent-ref %}

Here's an overview of the available payment options and how to set them up. To access the tab, follow **MS LMS > Settings > eCommerce > Payment methods:**

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FC4HtDjX5HHdyDtxzlDeG%2Fimage.png?alt=media&#x26;token=9ff7fdf2-e03a-43f0-899f-21395a671a40" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
In the [**Offline Payment**](#offline-payment) and [**Wire Transfer**](#wire-transfer) options, when each order is placed, the admin should[ grant access](https://docs.stylemixthemes.com/masterstudy-theme-documentation/lms-courses-features/masterstudy-theme-manual-orders#how-to-update-order-status) to the course to students manually. In [**PayPal** ](#paypal)and [**Stripe**](#stripe), it has been designed to change the order status (grant access to the course) **automatically**.

***

However, we **highly recommend** checking **all of your payment methods** and **order statuses regularly.**
{% endhint %}

To get more info about orders, refer to this documentation:

{% content-ref url="../../lms-courses-features/masterstudy-theme-manual-orders" %}
[masterstudy-theme-manual-orders](https://docs.stylemixthemes.com/masterstudy-theme-documentation/lms-courses-features/masterstudy-theme-manual-orders)
{% endcontent-ref %}

## How to Set up Payment Methods?

In Payment Methods, you can set up different payment gateways. Among the options available are:

<table data-card-size="large" data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><i class="fa-stripe-s">:stripe-s:</i> <strong>Stripe</strong></td><td><a href="#stripe">#stripe</a></td></tr><tr><td align="center"><i class="fa-paypal">:paypal:</i> <strong>PayPal</strong></td><td><a href="#paypal">#paypal</a></td></tr><tr><td align="center"><i class="fa-money-bills">:money-bills:</i> <strong>Wire Transfer</strong></td><td><a href="#wire-transfer">#wire-transfer</a></td></tr><tr><td align="center"><i class="fa-building-columns">:building-columns:</i> <strong>Offline Payment</strong></td><td><a href="#offline-payment">#offline-payment</a></td></tr></tbody></table>

To enable the needed option simply enable the toggle. By clicking the <i class="fa-circle-caret-down">:circle-caret-down:</i> icon, you get the additional settings to provide the required API keys to process the payments.

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2F2OSxIUbagYfWxNajQnK9%2Fimage.png?alt=media&#x26;token=095ab258-abc7-4cd8-9acd-a994321596bf" alt=""><figcaption></figcaption></figure>

### Offline Payment

Offline payment is designed for manual transactions where students pay outside the platform, such as through cash in your office, checks, or any other method that is not automatic.

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FY2Pvo0oYytdPolUyd4kr%2Fimage.png?alt=media&#x26;token=8871b639-33e9-47b9-994d-44b986705c2c" alt=""><figcaption></figcaption></figure>

There is only one field in the settings, which is the **offline payment processing** text. Use this field to provide **clear instructions** on how to make offline payments. **For instance:**

> **"**&#x50;lease visit our office to pay via cash or check, or deposit the course fee to the specified bank account. Once the payment is confirmed, your course access will be activated.**"**

This is how it will look on the [**Checkout Page:**](https://docs.stylemixthemes.com/masterstudy-theme-documentation/masterstudy-theme-manual-routes#checkout)

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FJdGl4APgH1CZwXpYxfsF%2Fimage.png?alt=media&#x26;token=a541f3e3-f468-4756-b69a-04a9ebc3f2b8" alt=""><figcaption></figcaption></figure>

After choosing the **offline payment** and clicking the **purchase button**, a student will have a **pending status** in the order:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2F6lACKXPchHf6qL9jQtVb%2Fimage.png?alt=media&#x26;token=d7842bd1-1736-46de-8c22-a48960606bbc" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
After **receiving the payment**, you have to [**grant access**](https://docs.stylemixthemes.com/masterstudy-theme-documentation/lms-courses-features/masterstudy-theme-manual-orders#orders-management-as-admin) to the respective students **manually.**
{% endhint %}

### Wire Transfer

Wire transfer is a direct payment method where students send payments from their bank account to your bank account.

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FkZ1rwCM7Ohwg18sl7pU1%2Fimage.png?alt=media&#x26;token=2a09ca97-4ea5-4440-82c0-bee6494a5cdd" alt=""><figcaption></figcaption></figure>

Here are the settings that need to be filled in accordingly:

* **Account Number -** Provide the complete bank account number where the payments will be deposited.
* **Account Holder Name -** Specify the name of the account holder as it appears on the bank account.
* **Bank Name -** Mention the name of your bank.
* **Swift/BIC Code -** Include the SWIFT/BIC code for international payments, ensuring smooth cross-border transactions.
* **Checkout Description -** Add details on the payment process, such as:

> "Transfer the course fee to the account details provided. Include your name and course ID in the transfer remarks for identification. Email your transfer receipt to <support@example.com>."

This is how our setup will look on the Checkout page if a student wants to buy a course:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FwUGCkcXPjzPnuaEn4i47%2Fimage.png?alt=media&#x26;token=3b954c58-088c-4383-a062-b0916b1b7ca5" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Like [**Offline Payment**](#offline-payment), after **receiving the funds**, you have to [**grant access**](https://docs.stylemixthemes.com/masterstudy-theme-documentation/lms-courses-features/masterstudy-theme-manual-orders#orders-management-as-admin) to the respective students **manually.** Until the confirmation, the order will be in **pending** status.
{% endhint %}

### PayPal

**PayPal** is a globally recognized payment gateway that allows students to pay using their PayPal balance, credit/debit cards, or linked bank accounts.

{% hint style="info" %}
You have to create a [**special app**](#how-to-setup-paypal-app) in your PayPal account to receive payment through the platform. We **don't need** a Client ID or Secret key, we just need to get a proper **PayPal Business Email.**&#x20;
{% endhint %}

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FgHVpfLxjg7jLc4oZI21z%2Fimage.png?alt=media&#x26;token=a0b5b918-de17-4d18-ba38-dbd0ca6cbd85" alt=""><figcaption></figcaption></figure>

Here are the settings that need to be filled in accordingly:

* **PayPal Business Email -** enter the email address linked to your PayPal business account. This is where payments will be directed. Check [**this out**](#how-to-setup-paypal-app) to obtain it.&#x20;
* **Payment Mode -** choose one of the **Live** or **Sandbox** modes:
  * **Sandbox** - choose sandbox mode to test PayPal functionality in a simulated environment without processing real transactions.
  * **Live** - choose the Live mode to start accepting real money.
* **Checkout Description -** provide instructions, such as:

> "You will be redirected to PayPal to complete the transaction."

#### How to Setup PayPal App?

{% hint style="info" %}
We will show the guide in **Sandbox (test) mode**. After configuring settings, make sure to change the mode to **Live** to start receiving real mone&#x79;**.**
{% endhint %}

1. Go to <https://www.paypal.com/> and sign in to your **PayPal business account**, then move to the developers' dashboard:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FlKBi3u2QLaOqkvTzC4Nw%2Fimage.png?alt=media&#x26;token=f0cfe3cb-ccb1-4435-b08d-e985b915ef07" alt=""><figcaption></figcaption></figure>

2. Move to the **Apps & Credentials** tab:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FBAYbR5xBE4NnGiD2c4ZS%2Fimage.png?alt=media&#x26;token=76d629c4-f735-41a6-b857-823de270049d" alt=""><figcaption></figcaption></figure>

3. To create an app, click on the **Create App** button:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FQZhcHLTitCSlPcauvAen%2Fimage.png?alt=media&#x26;token=afd19321-cf8c-42eb-9ace-c3168fbded30" alt=""><figcaption></figcaption></figure>

4. On the opened pop-up, name your app, indicate the app type, and create it:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FBLAVY0WQ5ZdjHuuv1IAx%2Fimage.png?alt=media&#x26;token=e74caae3-d6ac-4490-bbee-188a3af4a9a1" alt=""><figcaption></figcaption></figure>

5. On the opened page, you can see your email associated with the app:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FdfZpZfTrlhehU7C5JcIV%2Fimage.png?alt=media&#x26;token=06655520-cdbe-4bcd-a56d-38ed3489e0f5" alt=""><figcaption></figcaption></figure>

6. <mark style="color:blue;">Optional:</mark> If you want to change the email (rename), click on View Details:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FLThPqlX6yDyZqM78MxA0%2Fimage.png?alt=media&#x26;token=6d208b10-bb15-4372-97d2-18ebe7f9abee" alt=""><figcaption></figcaption></figure>

7. <mark style="color:blue;">Optional:</mark> Click on **Change Email:**

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FEvhPT39F5gxMQe0FaCAb%2Fimage.png?alt=media&#x26;token=aa780a44-168c-433f-a1e8-e8e9a13f32a6" alt=""><figcaption></figcaption></figure>

8. <mark style="color:blue;">Optional:</mark> Write the new email and save the changes:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FW7VBF1clWfZHfg3m4hiT%2Fimage.png?alt=media&#x26;token=5d0a403b-cd50-48fd-b526-6ef61da24768" alt=""><figcaption></figcaption></figure>

9. <mark style="color:blue;">Optional:</mark> You have successfully updated the email:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FiejgRaXX4iXw4ZGGl9N5%2Fimage.png?alt=media&#x26;token=b7b63bcd-cdcf-448c-bc69-deed8b3b7361" alt=""><figcaption></figcaption></figure>

10. Paste the email in the designated area in the plugin settings and **Save Settings:**

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FFTZfhFCGqNwPovjXCmGz%2Fimage.png?alt=media&#x26;token=51dedd5b-5b3a-4ecc-9b12-19c574899843" alt=""><figcaption></figcaption></figure>

11. After setting up everything and testing, you can change the mode to <mark style="color:purple;">**Live**</mark><mark style="color:purple;">:</mark>

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FZcvVCbH4tdOdWxmknwE8%2Fimage.png?alt=media&#x26;token=2d7b245b-6e15-4b03-8554-12af62b5dbb4" alt=""><figcaption></figcaption></figure>

On the [**checkout page**](https://docs.stylemixthemes.com/masterstudy-theme-documentation/masterstudy-theme-manual-routes#checkout), after selecting PayPal as a payment method, students will be redirected to the PayPal page to complete the transaction:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2Fg7ObzodMbqkMS3nVMOhl%2Fimage.png?alt=media&#x26;token=e9ba4f12-6dff-4608-8d51-ecdb627b07f6" alt=""><figcaption></figcaption></figure>

### Stripe

Stripe is a highly secure and flexible payment gateway that supports credit and debit card payments. It offers seamless integration for global transactions.

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FBlF5gadOnVsmqcd96aNX%2Fimage.png?alt=media&#x26;token=68020262-0f3d-4e3e-a550-c7c0d3d28988" alt=""><figcaption></figcaption></figure>

* **Publishable Key -** [obtain this key](#how-to-obtain-stripe-api-credentials) from your Stripe account dashboard. It is used to identify your account for front-end transactions.
* **Secret Key -** provide [the secret key](#how-to-obtain-stripe-api-credentials) for secure communication with Stripe’s API.
* **Checkout Description -** you can provide any description to explain the payment method, such as:

> "Securely pay using your credit or debit card. We accept Visa, MasterCard, American Express, and more."

Here is how it will look on the checkout page:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2Fv7wUKplpXNRRg8bmU2j8%2Fimage.png?alt=media&#x26;token=b467221f-dec9-4a0a-a45a-3c741cf7bbfa" alt=""><figcaption></figcaption></figure>

#### How to Obtain Stripe API Credentials

{% hint style="info" %}
We will show the guide in **Sandbox (test) mode**. After configuring settings, make sure to change the mode to **Live** to start receiving real mone&#x79;**.**
{% endhint %}

1. Visit <https://dashboard.stripe.com/login> and sign in or register. Then choose the app and move to the Developers dashboard:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FdXYUsnFWK7EELrdidkfC%2Fimage.png?alt=media&#x26;token=55954e01-eb3c-41a6-96f7-f1dc5c6c3d05" alt=""><figcaption></figcaption></figure>

2. Jump to the **API keys** tab, copy the **Publishable Key** and **Secret Key**, and paste them to their designated areas in the **MasterStudy Settings:**

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FNAovBJK7SD5kltGL7Lbz%2Fimage.png?alt=media&#x26;token=09c38ad9-db47-4f34-85df-5ce410c6ef95" alt=""><figcaption></figcaption></figure>

3. Here is the filled Stripe section in the Payment Methods tab:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2F8BPqVEnWJivUIgz1wseQ%2Fimage.png?alt=media&#x26;token=f6b99c78-e318-44d5-b03b-7db61aa90860" alt=""><figcaption></figcaption></figure>

4. After testing your platform, you can switch to the **Live** mode to **accept real money**. In that case, Stripe should provide new API credentials:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FbsRlk87TX1W7mjiDTwfy%2Fimage.png?alt=media&#x26;token=d5438e5d-b3b0-4c7e-b748-34a92271ab9b" alt=""><figcaption></figcaption></figure>

***

## Example: How to Purchase a Course?

1. So, if you decide to buy the course, click on the get now button, and you will see the available methods to purchase the course:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2F62lt1E5UNQ4DIqcXdVsq%2Fimage.png?alt=media&#x26;token=23d3bf14-1fd0-452d-96e7-b487bd7192b3" alt=""><figcaption></figcaption></figure>

2. We will choose the **One-time payment** option. After that, the course will be added to **the cart.** You can go there by clicking **Go to Cart** button:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2FBkwfXHuHhI9jdeV196Mx%2Fimage.png?alt=media&#x26;token=c8e74f9f-34b5-434a-84e4-91d5057c8ab0" alt=""><figcaption></figcaption></figure>

3. There is an availability to add several courses to the cart. Review your order and choose the preferred **payment method**, then proceed with the payment:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2F9VhNsTnYfOz1EoK2ZDvL%2Fimage.png?alt=media&#x26;token=a01a628b-b493-4a4f-95fa-114a690f7ea6" alt=""><figcaption></figcaption></figure>

3. After the successful payment, you will get the confirmation page with the order status:

<figure><img src="https://2021837383-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDO9V_qgvV5cQdw04iz%2Fuploads%2Fw0gy08ZIwbfrIZhtqIGB%2Fimage.png?alt=media&#x26;token=f16612ef-ce3a-43e3-88bc-8aba0f6ca115" alt=""><figcaption></figcaption></figure>

To get more info about **orders** and how admin and instructors **manage** orders,  refer to his manual:

{% content-ref url="../../lms-courses-features/masterstudy-theme-manual-orders" %}
[masterstudy-theme-manual-orders](https://docs.stylemixthemes.com/masterstudy-theme-documentation/lms-courses-features/masterstudy-theme-manual-orders)
{% endcontent-ref %}
