How to Set Up International Payments (PayPal, Stripe)

Choose one first

Prerequisites

• An e-commerce online purchase has been set up, and the platform has enabled international online payments. If not enabled, the PayPal and Stripe tabs in the payment section will display "Not enabled by platform"; please contact the platform.
• Only the site owner can edit fields like Key and Secret. If you cannot see the fields or save, please use the site owner's account.
• A PayPal merchant account or Stripe account has been applied for. Do not paste the keys into chat software or other public places.

Path

Set up PayPal

1. Turn on the PayPal (International Payment) switch.
2. Select Environment as Sandbox (Testing) first.
3. Go to PayPal Developer Dashboard → Apps & Credentials to create a REST App, and paste the Client ID and Client Secret into the corresponding fields. The credentials for sandbox and production environments are different.
4. Click Save at the bottom. The Webhook URL will appear on the card.
5. Return to the PayPal App's Webhooks, add this URL, and subscribe to the events listed on the card (Checkout order approved, Payment capture completed/pending/denied/declined/refunded).
6. Paste the Webhook ID displayed by PayPal back into the card, and save it again.

Set up Stripe

1. Turn on the Stripe (International Credit Card) switch. The yellow prompt at the top of the card will remind you of the application conditions again.
2. Select Sandbox (Testing) for the Environment first.
3. Go to Stripe Dashboard → Developers → API keys to copy the Secret key, and paste it into Secret Key. Test environment keys start with sk_test_, while production environment keys start with sk_live_; you can also use a Restricted key with limited permissions (starting with rk_).
4. Click Save at the bottom. The Webhook URL will appear on the card.
5. Go to Stripe Dashboard → Developers → Webhooks to add an endpoint, paste this Webhook URL, and check the four events listed on the card: checkout.session.completed, checkout.session.async_payment_succeeded, checkout.session.async_payment_failed, refund.created.
6. On that endpoint page, click Reveal to obtain the Signing secret (starting with whsec_), paste it into Webhook Signing Secret, and save again.

• If the keys and environment do not match (for example, if the environment is set to live but sk_test_ is pasted), saving will not be possible. If you want to change the environment to live later, please also switch to the sk_live_ key.
• Saving will not be possible if the Signing secret does not start with whsec_.

How customers can pay.

1. Customers select PayPal or International Credit Card on the checkout page and submit the order.
2. The page will redirect to the payment page of PayPal or Stripe.
3. After payment is completed, return to the order completion page, and the order status will change to paid.

Testing (must do)

1. Both environments should first use Sandbox.
2. PayPal uses a PayPal sandbox buyer account for payment; Stripe uses the test card numbers provided in the Stripe documentation for payment.
3. In the backend, Orders should change to paid, and the event log should show payment success.
4. After confirming everything is correct, change the environment to Production and replace it with the official certificate (the Stripe Webhook must also be added again in the production environment, as the Signing secret will be different), then proceed with a small real order verification.

Refund

Unsupported situations

• POS Cash Register payment links will not use PayPal or Stripe.
• When the shopping cart contains frozen or refrigerated items, payment can only be made using PAYUNi, and PayPal or international credit cards will not appear.

Common issues

Related instructions

• How to set up payment and invoicing
• How to set up international shipping rates
• How to handle orders
• Members and permissions