Connect and Test PayPal Complete Payments Sandbox With MemberPress

This document explains how to set up and test PayPal Complete Payments Sandbox mode with MemberPress. Testing in sandbox mode lets you check the setup before accepting real payments.

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 Sandbox Overview

Connecting PayPal Complete Payments to MemberPress lets you accept payments from members worldwide. The setup supports both one-time and recurring payments for different membership models.

PayPal Sandbox is a testing area that copies the live payment system. However, it does not process real charges. As a result, you can test payment flows and settings using test card numbers instead of real payment details.

Testing with PayPal Sandbox before accepting live payments is a good idea. However, sandbox testing is optional. To skip testing and connect directly to Production, see How To Connect PayPal Complete Payments To MemberPress.

Pré-requisitos

Before testing with PayPal Sandbox, make sure you have:

• MemberPress Growth or Scale plan activated on the site;
• A PayPal Developer account (free to create);
• A PayPal Complete Payments gateway created in MemberPress settings;
• At least one filiação created for testing.

Observação: A PayPal Developer account is different from a regular PayPal account. You can create one at developer.paypal.com. Use your existing PayPal login or create a new account.

Creating Sandbox Accounts

PayPal Sandbox needs separate test accounts for the merchant (Business) and buyer (Personal). These sandbox accounts only exist in the test area.

Creating a Sandbox Business Account

1. First, log in to the PayPal Developer Dashboard.
2. Em seguida, clique em Testing Tools in the left menu. Then, click Sandbox Accounts.

3. Clique no botão Create account botão.

4. Selecione Negócios as the account type.
5. Selecione um Country/Region for the test merchant.
6. Por fim, clique em Criar to make the sandbox Business account.

Creating a Sandbox Personal Account

1. No Sandbox Accounts page, click Create account.
2. Selecione Personal as the account type.
3. Selecione um Country/Region for the test buyer.
4. Clique em Criar to make the sandbox Personal account.

Dica: You can create sandbox accounts for different countries. This lets you test which payment methods appear by region. For example, Venmo only appears for US-based buyers.

Viewing Sandbox Account Details

1. No Sandbox Accounts page, find the account you want to view.
2. Click the three-dot menu (…) next to the account.

3. Clique em View/Edit Account.
4. Note the email address and system-made password.

Connecting MemberPress to PayPal Sandbox

With sandbox accounts created, you can now connect MemberPress to the PayPal Sandbox area. During the connection process, you will need to log in with your sandbox Business account. Use the email and password you found in the “Viewing Sandbox Account Details” section above.

You can log in to your sandbox Business account before starting the connection. Alternatively, PayPal will prompt you to log in during the connection process.

Connecting the Sandbox Account

1. Open another browser tab and log in to your WordPress website.
2. Ir para Painel de controle > MemberPress > Configurações > Pagamentos guia.
3. Click on the PayPal Complete Payments gateway to expand its settings.
4. Sob o Caixa de areia clique na seção Connect with PayPal botão.

5. If you are not already logged in, log in with your sandbox Business account details. Use the email and password from the account info.

6. Grant permissions and complete the connection.
7. After that, PayPal redirects back to the MemberPress settings page.
8. Verifique o Usar o PayPal Sandbox option to enable test payments.

9. Clique em Opções de atualização para salvar.

Observação: O Usar o PayPal Sandbox checkbox must be checked for test payments. When checked, MemberPress uses Sandbox instead of Production.

Testing PayPal Payments

With Sandbox connected and enabled, you can now test the payment flow. You will use the Personal Sandbox account you created earlier for testing. During checkout, you can pay using a test credit card, bank account, or PayPal balance.

Managing Test Payment Methods

To manage test payment methods for your Personal Sandbox account:

1. Ir para PayPal Developer Dashboard > Testing Tools > Sandbox Accounts.
2. Find your Personal Sandbox account in the list.
3. Click the three-dot menu (…) next to the account.
4. Clique em View/Edit account.
5. Role para baixo até a seção “Sandbox account info” seção.

6. Manage your test payment methods:
   • Credit Cards – Click Gerenciar to add or edit test credit cards;
   • Banks – Click Gerenciar to add or edit test bank accounts;
   • PayPal balance – Click the pencil icon to edit the test balance.

Processing a Test Payment

1. First, open a new private or incognito window in your browser.
2. Go to the registration page of any existing membership or a test membership.
3. Fill in the registration form with test user details.
4. Clique no botão PayPal button to open the payment pop-up.

5. Log in with the sandbox Personal account details.
6. Complete the payment in the pop-up window.

Checking Test Transactions

After completing the test payment, verify the transaction in both MemberPress and PayPal.

In MemberPress:

1. Ir para Painel de controle > MemberPress > Transações.
2. Find the test transaction in the list.
3. Check that the transaction status shows Completo.

For recurring subscriptions, also check the subscription at Painel de controle > MemberPress > Assinaturas.

In PayPal Sandbox Dashboard:

1. Ir para https://sandbox.paypal.com/.
2. Log in using your Business Sandbox account credentials (email and password).
3. Navegue até Activity > All Transactions.
4. Find the test transaction in the list and verify the details match.

The connection is working correctly if transactions appear in both MemberPress and PayPal Sandbox.

Testing Other Payment Methods

By default, the PayPal button is enabled. You can enable additional payment options to test them in Sandbox mode.

Enabling Payment Options

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.

4. In the pop-up, toggle the payment methods you want to test.

5. Click outside the pop-up to close it.
6. Clique em Opções de atualização para salvar suas alterações.

Testing Card Payments

To test card payments, enable the Card ou Card Fields option under “Accept Card Payments” in the Customize Payment Methods pop-up.

PayPal provides test card numbers for Sandbox testing. For a full list of test cards, visit the PayPal Card Testing documentation.

Testing Other Checkout Options

PayPal supports additional checkout options like Venmo, Pay Later, Apple Pay, and Google Pay. Each option has specific requirements:

• Venmo – Create a US sandbox Personal account and use USD currency. Venmo hides for other regions;
• Pay Later – Requires a supported currency (USD, GBP, EUR, AUD) and a minimum purchase amount;
• Apple Pay – Requires setup in the merchant PayPal account;
• Google Pay – Only works with one-time payments. PayPal hides Google Pay for recurring memberships.

For detailed testing instructions, visit the PayPal Checkout documentation.

Switching to Production

Após o teste bem-sucedido, você pode ativar os pagamentos em tempo real:

1. Navegue até Painel de controle > MemberPress > Configurações > Pagamentos guia.
2. Sob o Produção section of your PayPal Complete Payments gateway, connect your live PayPal Business account (not the Sandbox Business account).
3. Desmarque a opção Usar o PayPal Sandbox caixa de seleção.
4. Clique em Opções de atualização para salvar suas alterações.

Now, users can register for your memberships and pay through PayPal.

Troubleshooting Sandbox Issues

Blank screen when connecting – First, open the Sandbox Dashboard in another tab. Then, click Connect in MemberPress.

Cannot log in to sandbox – Use sandbox account details from the Developer Dashboard. Do not use regular PayPal login details.

Payment buttons not appearing – Check that Usar o PayPal Sandbox is checked. Also, verify that Sandbox shows Connected status.

Test card declined – Ensure you are using valid test card numbers from the PayPal Card Testing documentation. Also, use a future expiration date.

Venmo not appearing – Create a US sandbox Personal account and use USD currency.

Transaction not recorded – Check for pending transactions. Also, verify no firewall blocks PayPal. Review the WordPress debug log for errors.