This plugin realizes the "personal version" online Payment collection capability based on PayPal IPN (Instant Payment Notification), and is suitable for scenarios that do not have the PayPal Commercial Billing SDK. The plugin jumps to PayPal through a standard form to complete the payment, and verifies the payment result with an IPN asynchronous callback. It safely stores the order in the database and flows it as paid.

Functional features

• Managed payment jump: Click the "Pay with PayPal" button on the checkout page to jump to the PayPal page with one click to complete the payment
• IPN asynchronous notification: After the transaction is completed, the PayPal server calls back the IPN interface, and the system conducts a secondary verification and updates the order status
• Order verification: Verify the payment_status, receiving email, amount and currency to ensure the credibility of the payment result
• Sandbox support: Supports the PayPal Sandbox environment for convenient integration and testing
• Multilingual: Buttons and prompt text have been integrated into multilingual (zh-cn/en) and can be extended to other languages

Installation and Activation

• Back-end → Plugin Management → Install PayPal(Personal Edition) plugin
• Enable the plugin (type=payment will appear in the payment method list on the checkout page)
• On the checkout page, select the payment method "PayPal(Personal Version)"

Configuration item

• Receiving email (business_email) : The PayPal account email used for receiving payments
• sandbox: Whether to enable the PayPal Sandbox environment (Yes/No)

It takes effect after saving. When initiating the checkout, the receiving email address and the callback address will be submitted to PayPal together.

Callback

• IPN callbackPOST domain name /callback/paypalipn/ipn

Account Registration and Sandbox Testing (Steps)

Free PayPal personal account upgrade to business account (without business license) + Simple steps to activate IPN
The entire process does not require a business license. Only personal identity information is needed to complete the upgrade. After the upgrade, the account retains the personal payment attribute, with no annual fees or additional charges, and unlocks the full IPN function.

I. Core Premises

PayPal Premier accounts have been gradually integrated into the Business account system. You can directly upgrade your Business account. The process is simpler, the functions are the same, and it fully supports IPN configuration.

Step 1: Upgrade your personal account to a business account for free (without a business license)

Log in to your PayPal personal account (official website access, domestic access requires a compliant network);
Click the gear icon (Settings) in the upper right corner, and in the left menu bar, find the Account and Security/Account options (the interface names may vary slightly in different versions).
Find the option "Upgrade to a Business Account" and click it;
Fill in the upgrade information (Key: Special filling method for those without a business license) :
Store/enterprise name: Fill in your real personal name directly (no need for the name on the business license);
Industry/Category: Optional (such as "Retail/Personal Goods", "Services/Personal Services");
Business description: Simply fill in (such as "Personal online product sales" or "Personal digital service provision");
For all other required fields marked with *, please fill in your personal identity information (consistent with the real-name information of your personal account).
After confirming the information and submitting, the upgrade will take effect immediately without the need for review. The account will be automatically converted to a commercial account, and the rules for receiving payments and withdrawals are the same as those for the original personal account.

Step 2: After the upgrade, activate and configure IPN (Instant Payment Notification)

【 Formal environment configuration (directly available for production) 】

Keep the PayPal business Account login status, click the gear icon (Settings) in the upper right corner → select Account Settings;
Click "Notifications" in the left menu bar, find "Instant payment notifications", and click "Update" on the right.
Click "Choose IPN Settings" at the bottom of the page;
Core configuration information:
Notification URL: Enter the address of your public network accessible IPN callback interface (such as domain name /callback/paypalipn/ipn, which should be able to receive PayPal POST requests);
Check Receive IPN messages (Enabled);
Click "Save", and the IPN function will be immediately activated. Subsequently, PayPal will automatically push callback information to this URL for all transactions.

【 Sandbox Test Environment Configuration (Optional for development/debugging) 】

If it is necessary to test the IPN logic first without real transactions, a sandbox environment can be configured:
Visit the PayPal Developer Platform and log in directly with your PayPal business account.
Click on "Sandbox" → "Accounts" on the left side. The system will automatically generate a sandbox Business account (Business) and record the account/password.
Visit the sandbox PayPal backend and log in with your sandbox business account.
Repeat steps 1 to 5 of the formal environment, fill in the IPN callback URL of your test environment, and the sandbox IPN configuration will be completed.
Sandbox IPN dedicated verification address:https://ipnpb.sandbox.paypal.com/cgi-bin/webscr?cmd=_notify-validate.

V. Verification of whether IPN has been successfully activated

Log in to your PayPal business account, go to Account Settings → Notifications → Instant Payment Notifications, and you can directly view the enabled status.
The PayPal IPN history can be accessed (sandbox:https://www.sandbox.paypal.com/merchantnotification/ipn/history) to see all the callback records, including successFailure log, which can quickly identify problems.

Q&A

• IPN did not callback or the callback wasINVALID
  • Confirm that the sandbox/production switch is consistent with the PayPal account environment
  • If production is used, please ensure that the site is accessible on the public network and has not been blocked by a firewall
  • "Checknotify_urlWhether it is an accessible HTTPS address
• The order is not set as paid
  • Verificationreceiver_emailWhether it is consistent with the payment email configured in the plugin