PayPal Configuration Guide

PayPal is a widely used global payment platform, supporting 190+ countries and 25+ currencies, suitable for cross-border e-commerce and international business.

Prerequisites

Register PayPal Business Account

Visit paypal.com to register business account and complete enterprise verification.

Create API Credentials

Create application in developer portal developer.paypal.com, get Client ID and Client Secret.

Configure Webhook

Add Webhook endpoint in application settings, select event types to monitor.

Configuration Steps

1

Step 1: Enter Payment Platform Management

In admin panel go to Payment Platform Management, find PayPal configuration item.

2

Step 2: Fill in Credential Information

Fill in Client ID and Client Secret.

3

Step 3: Select Environment Mode

Test environment (prod_mode: false) uses sandbox credentials, production environment uses live credentials.

4

Step 4: Configure Callback URLs

Return URL: https://yourdomain.com/payment/paypal/return Cancel URL: https://yourdomain.com/payment/paypal/cancel

5

Step 5: Save and Test

Use PayPal sandbox account to test payment process.

Sandbox Test Account

Create sandbox buyer account in PayPal developer portal for testing:

  • Log in to developer.paypal.com
  • Go to Sandbox -> Accounts
  • Use pre-created buyer account or create new test account

Notes

  • Sandbox environment credentials differ from production environment credentials
  • Production environment must use HTTPS
  • Webhook endpoint needs to be publicly accessible
  • PayPal payment may take longer to confirm

FAQ

Order status not updated after payment?

Check if Webhook is correctly configured, confirm receiving PAYMENT.CAPTURE.COMPLETED event.

How to get Webhook ID?

In developer portal application settings, Webhook ID will be displayed after creation.