On this page
No Headings
Last updated: June 14, 2026
You can use the steps in this section to ensure that your accounts and environment are set up to accept Pix payments.
Sign up for a PayPal developer account. On successful signup, PayPal automatically creates your sandbox environment. The sandbox environment is a test environment that helps you mimic real-world transactions. By default, the environment includes a business and personal account. You can create additional personal and business sandbox accounts as needed.
Set up the sandbox environment:
1. Go to your PayPal developer account sandbox and toggle to Sandbox.
2. Go to Apps & Credentials and select Create App.
3. Enter your app name, set the Type to Merchant, choose the sandbox business account, and select Create App. The app details page is displayed.
4. Configure a webhook listener for the app and subscribe to events:
The webhook listener is successfully configured, and a Webhook ID is displayed. You can store the ID and use it in your app code to verify the source sending messages to your listener. For more information on webhooks, see Use webhooks.
Retrieve sandbox app credentials: To integrate and test Pay with Pix, you require the following sandbox credentials for your app:
1. Client ID: App identifier that helps with account authentication.
2. Client Secret: App credential that helps with app authorization.
To retrieve the sandbox credentials:
1. Go to your PayPal developer account and switch to Sandbox.
2. Go to Apps & Credentials > API Credentials > REST API apps.
3. Copy the Client ID and Client Secret listed next to your app name and save them.
Retrieve sandbox account credentials: To test your Pay with Pix integration end-to-end, run your app, simulate a checkout flow, log in to your personal PayPal sandbox account to approve the Pix payment, and confirm that the money is received in your business PayPal sandbox account in BRL. You need sandbox login credentials for both accounts. For information on how to access or reset these credentials, see Get sandbox account credentials.
CHECKOUT.ORDER.APPROVED: Approval of checkout orderCHECKOUT.ORDER.COMPLETED: Successful Pix paymentCHECKOUT.PAYMENT-APPROVAL.REVERSED: Failed or expired captureYou can enable Pay with Pix using one of the following methods:
If you have an eligible PayPal business account, you can enable Pay with Pix directly from your dashboard:
After enabling Pix, go to Payment methods > Go to Pix profile to view your keys, set or update your preferred key for withdrawals, enable additional keys, or manage your Pix settings.
If you don't see Pay with Pix in your dashboard, request approval by visiting the links below:
Pix payments are activated after PayPal verifies eligibility and completes a compliance review. Ensure your account is configured to accept payments in BRL, as all Pix payments are settled in BRL.
Partners: Ensure merchants complete the full onboarding process before they can accept Pix payments. Progressive onboarding is not supported.