In this guide, you'll learn how to view and edit PayPal integration settings in Medusa Admin via the Integration Module.

To view the PayPal details:

1. Open Medusa Admin.
2. Go to Settings → Integrations → PayPal.

This opens the PayPal settings page where you can review the credential details, the payment behavior and the PayPal checkout page settings.

---

You can update the environment, the client ID, the secret key and the webhook ID from the first section on the PayPal settings page. Sandbox takes test payments from sandbox accounts, Live takes real ones, and each environment has its own keys and webhooks in the PayPal Developer Dashboard.

To edit the credential parameters:

1. Go to Settings → Integrations → PayPal.
2. In the Credentials section, click the action menu in the section's header.
3. Choose Edit.
4. In the side panel that opens, update the environment, the client ID, the secret key and the webhook ID. See Webhook Setup for where the webhook ID comes from.
5. Click Save.

Then click Test connection. It gets an access token from the chosen environment, so wrong keys or keys from the other environment fail here. With a webhook ID, it also checks that the webhook exists in that environment and is subscribed to PAYMENT.AUTHORIZATION.CREATED and PAYMENT.CAPTURE.COMPLETED.

---

The Behavior section determines the payments processing type.

If Capture right away is selected, one-step payment is used. If Authorize only is selected, two-step payment is used, and you capture the held amount from the order in Medusa Admin. PayPal guarantees the funds for 3 days and lets you capture within 29 days.

To edit the payment behavior:

1. Go to Settings → Integrations → PayPal.
2. In the Behavior section, click the action menu in the section's header.
3. Choose Edit.
4. In the side panel that opens, update the payment intent.
5. Click Save.

---

The PayPal checkout page section determines what the buyer sees after leaving for PayPal.

• Brand name replaces the business name of your PayPal account on PayPal pages, up to 127 characters.
• Landing page is the page the buyer sees first. You can leave the choice to PayPal, or open the PayPal login or the guest checkout with a card.
• Card statement text is added after your business name on the buyer's card statement. The statement shows 22 characters, the PAYPAL * prefix included, so keep it short.
• Cart items sends the cart's items, shipping, tax and discount to PayPal. The customer sees them in the PayPal window, and you see them on the transaction in your PayPal account. When the cart does not add up to the payment amount, for example with a gift card, the order goes to PayPal with the amount alone.

To edit the checkout page settings:

1. Go to Settings → Integrations → PayPal.
2. In the PayPal checkout page section, click the action menu in the section's header.
3. Choose Edit.
4. In the side panel that opens, update the brand name, the landing page, the card statement text and the cart items switch.
5. Click Save.

---

To add a payment provider displayed in the Storefront for PayPal:

1. Go to Settings → Regions.
2. Choose your region.
3. In the first section, click the action menu in the section's header.
4. Choose Edit.
5. In the modal that opens, add Paypal (PAYPAL) to Payment Providers.
6. Click Save.

The plugin refuses a payment in a currency PayPal does not accept, so add PayPal only to regions that use one of the 25 PayPal currencies. PayPal supports BRL, CNY and MYR as a payment currency only for PayPal accounts in the same country.