How To Connect PayPal Complete Payments To MemberPress

PayPal Complete Payments is a payment gateway that accepts membership payments worldwide. With this gateway, you can connect PayPal to MemberPress and process payments directly on your site.

This document explains how to connect PayPal Complete Payments to MemberPress. It also covers how to set up payment methods and manage transactions.

Observação: This feature is available to MemberPress Growth and Scale plan members. To upgrade from the Launch plan, click the Plano de mudança link on the Página da conta MemberPress.

Observação: MemberPress PayPal Complete Payments gateway is available with the MemberPress 1.12.15rc1 (Edge) plugin version.

PayPal Complete Payments Overview

The PayPal Complete Payments gateway shows all payment options on the registration page. As a result, members can complete payments in a pop-up window without leaving your site.

The gateway supports several payment methods to meet different buyer needs. For example, members can pay using PayPal, Pay Later, Venmo (US only), Apple Pay, and Google Pay. Additionally, card payments with 3D Secure are also supported.

Os principais recursos incluem:

• One-time and recurring subscription processing;
• Suporte para Pedidos de bônus with recurring memberships;
• Automatic refund syncing between PayPal and MemberPress;
• Mobile app switching for PayPal app users.

Importante: Payment method options depend on the buyer's country and your account settings. PayPal will show or hide options based on what is available.

PayPal Complete Payments vs. PayPal Standard

PayPal Complete Payments works separately from the PayPal Standard gateway. Both gateways are fully supported. Therefore, you can run them at the same time on the same site.

However, PayPal Complete Payments does not replace existing PayPal Standard subscriptions. There is no way to move subscriptions between the two gateways. Instead, existing subscriptions will continue through PayPal Standard.

Pré-requisitos

Before connecting PayPal Complete Payments to MemberPress, make sure you have:

• MemberPress Growth or Scale plan activated on the site;
• A PayPal Business account (personal accounts will not work);
• An SSL certificate installed on the site (HTTPS required);
• At least one filiação created.

Observação: If needed, create a PayPal Business account at PayPal.com. The account must have a confirmed email address. Also, payment receiving must be enabled.

Connecting PayPal Complete Payments to MemberPress

To connect PayPal Complete Payments to MemberPress, first create the gateway in MemberPress. Then, connect to PayPal Sandbox for testing, or connect directly to Production for live payments.

Dica: Testing with PayPal Sandbox before accepting live payments is a good idea. However, this step is optional.

Creating a PayPal Complete Payments Gateway

1. First, log in to your website and go to Painel de controle > MemberPress > Configurações.
2. Em seguida, clique no botão Pagamentos guia.
3. Em seguida, clique em + Adicionar método de pagamento para adicionar um novo gateway de pagamento.

4. No Gateway selecione PayPal Complete Payments.
5. No Nome field, add a label for the gateway. Members will see this label on registration forms. For example, you can name it “PayPal”.

6. Por fim, clique no botão Opções de atualização para salvar suas configurações.

Connecting PayPal Production

To connect your PayPal merchant account and start receiving live payments:

1. Ir para Painel de controle > MemberPress > Configurações > Pagamentos guia.
2. Click on the PayPal Complete Payments gateway to expand its settings.
3. Sob o Produção clique na seção Connect with PayPal botão.

4. A PayPal window will open. Log in with your PayPal Business account details.
5. Follow the on-screen steps to grant permissions to MemberPress.
6. Click the final confirmation button in PayPal to complete the connection.
7. After that, PayPal will redirect back to the MemberPress settings page. The connection saves on its own.

8. Clique no botão Opções de atualização para salvar suas configurações.

A successful connection shows Conectado status and the PayPal Merchant ID. You will also see a Disconnect button if you need to remove the connection later.

If the connection fails, check that the PayPal account is a Business account. Also, verify the email is confirmed and payment receiving is enabled.

Configuring Payment Methods

The PayPal Complete Payments gateway lets you control which payment methods appear on registration pages. To access these settings:

1. Ir para Painel de controle > MemberPress > Configurações > Pagamentos guia.
2. Click on the PayPal Complete Payments gateway to expand its settings.
3. Clique no botão Personalizar métodos de pagamento button below the Production and Sandbox sections.

A pop-up window will open where you can enable or disable different payment options.

Payment Buttons

You can enable or disable payment buttons under the Botões seção:

• PayPal – Standard PayPal checkout;
• Pay Later – Lets buyers spread payments over time;
• Credit – PayPal Credit financing option;
• Venmo – US-only payment method through the Venmo app;
• Card – Shows a “Debit or Credit Card” button that expands to card fields;
• Apple Pay – Requires setup in the merchant PayPal account;
• Google Pay – One-time payments only (does not support recurring).

Importante: Google Pay does not support recurring subscriptions. As a result, PayPal hides Google Pay for recurring memberships.

Card Options

The gateway offers two options for accepting card payments:

Card shows a button labeled “Debit or Credit Card.” When clicked, it expands to show card entry fields. This option gives a cleaner look at first.

Card Fields shows card entry fields right on the registration page. Members see the card number, expiration date, and CVV fields right away.

Observação: You can only enable one of these options at a time. They cannot be used together.

Submit Button Behavior

When card fields are disabled, the standard MemberPress submit button hides. In this case, members must click one of the PayPal buttons to complete registration.

When card fields are enabled, the submit button stays visible. Members can then use a PayPal button or enter card details and click submit.

Payment Method Availability

PayPal decides which payment methods to show based on buyer country, currency, and purchase type.

Método de pagamento	Limits
PayPal	Most currencies supported
Venmo	USD and US buyers only
Pay Later	USD, GBP, EUR, AUD only
Google Pay	One-time payments only
Apple Pay	Requires merchant setup

Also, PayPal hides methods that do not work when recurring memberships include order bumps.

Using PayPal Complete Payments on Registration Pages

Once connected, the PayPal Complete Payments option appears on membership registration pages.

When members pay using PayPal Complete Payments, all transactions sync between PayPal and MemberPress. You can view transactions at Painel de controle > MemberPress > Transações. Similarly, you can manage subscriptions at Painel de controle > MemberPress > Assinaturas.

Gerenciamento de assinaturas

Subscriptions created through PayPal Complete Payments work differently from other payment gateways.

Subscription Display in PayPal

Payments appear as one-time charges in the PayPal dashboard. This happens because MemberPress manages the billing schedule on its own. The system stores payment methods securely and charges members on renewal dates.

Automatic Renewals

The MemberPress service initiates all renewal payments automatically. These renewals run on the schedule set when the member first subscribed. The subscription terms cannot be modified after the initial purchase.

To change subscription terms (price, billing cycle, etc.), the existing subscription must be canceled. The member then needs to register again under the new conditions.

To cancel PayPal Complete Payments subscriptions, follow the steps in the canceling subscriptions documentation. Always cancel through MemberPress, not PayPal.

Observação: Manual changes to transactions or subscriptions in MemberPress do not affect scheduled payments. This works the same way as the Gateway Stripe.

Reembolsos

PayPal Complete Payments supports refund syncing between PayPal and MemberPress.

To process refunds, follow the steps in the refunding a transaction documentation. MemberPress sends the refund request to PayPal, and both systems update automatically. Refunds made directly in PayPal also sync back to MemberPress.

Partial Refunds

PayPal supports partial refunds. However, MemberPress marks the transaction as fully refunded no matter the amount. To handle this, process the partial refund in PayPal first. Then, manually adjust the transaction status in MemberPress at Painel de controle > MemberPress > Transações.

Pedidos de colisões

The gateway supports Pedidos de bônus for recurring memberships. When a member adds an order bump, all charges combine into a single transaction. The PayPal pop-up then shows a breakdown of all charges.

Payment methods that do not support saving (like Google Pay) hide when order bumps are present. MemberPress schedules separate renewals for each subscription based on their billing terms.

To refund order bumps, you need to process the refund in PayPal. Then, manually adjust the MemberPress transactions.

Solução de problemas

Cannot connect PayPal account – Check that the account is a Business account with a verified email. Also, make sure payment receiving is enabled. Try clearing your browser cache and retry.

Payment buttons not appearing – First, check that payment methods are enabled in gateway settings. Then, verify the currency works with the enabled methods. Also, test in a different browser and check for JavaScript errors.

Specific button missing (e.g., Venmo) – Verify that the buyer's location supports that payment method. Also, check that the merchant PayPal account has the feature enabled.

Transaction not created after payment – Check for pending transactions at Painel de controle > MemberPress > Transações. Also, verify no firewall or security plugin blocks PayPal. Review the WordPress debug log for errors.

Perguntas frequentes

Can existing PayPal Standard subscriptions move to PayPal Complete Payments?

No, there is no way to move subscriptions between gateways. Instead, keep PayPal Standard active (hidden from new sign-ups) for existing subscriptions.

Does this gateway support free trials?

Yes, it does. No transaction appears in PayPal during the trial period. Billing begins when the trial ends.

Why do subscriptions show as one-time payments in PayPal?

MemberPress manages billing separately from PayPal's subscription system. As a result, payments appear as single charges at each renewal.

Can members update their payment method?

Yes, they can. Members can update their payment method through the Página da conta no MemberPress.

What happens if a renewal payment fails?

MemberPress retries failed payments based on the set schedule. Members receive notice of failures. After several failures, the subscription expires.