PayPal Complete Payments Setup

GateFuz connects with PayPal using the official PayPal REST v2 Orders and Subscriptions API with cryptographic webhook validation.

Gateway Configuration Console

Navigate to GateFuz → Gateways → PayPal to configure Smart Payment Buttons, dual-key credentials, and isolated Webhook IDs:

Configuration Fields

Setting	Type	Description
Enable Gateway	Select	Toggle whether PayPal buttons appear in the checkout modal.
Environment Mode	Select	Switch between Sandbox / Test Mode and Live Production.
Sandbox Client ID	String	Developer Sandbox App client ID.
Sandbox Secret	Password	Developer Sandbox App secret key.
Sandbox Webhook ID	String	Alphanumeric webhook ID generated in PayPal Developer Dashboard for Sandbox webhook verification.
Live Client ID	String	Production PayPal Live client ID.
Live Secret	Password	Production PayPal Live secret key.
Live Webhook ID	String	Alphanumeric webhook ID generated in PayPal Live Dashboard for production verification.

---

Retrieving PayPal Credentials

1. Log in to the PayPal Developer Dashboard.
2. Navigate to Apps & Credentials.
3. Under REST API apps, select your app (or click Create App).
4. Copy your Client ID and Secret Key.
5. Switch between Sandbox and Live tabs to retrieve credentials for both modes.
6. In WordPress, go to GateFuz → Gateways → PayPal and enter your credentials.

---

Configuring Webhooks & Webhook ID

1. In the PayPal Developer Dashboard under your app details, click Add Webhook.
2. Enter your GateFuz PayPal Webhook URL:

   https://example.com/wp-json/gatefuz/v1/webhook/paypal

3. Check the recommended events:
   • PAYMENT.CAPTURE.COMPLETED
   • PAYMENT.CAPTURE.PENDING
   • PAYMENT.CAPTURE.REFUNDED
   • PAYMENT.CAPTURE.DENIED
   • BILLING.SUBSCRIPTION.ACTIVATED
   • BILLING.SUBSCRIPTION.CANCELLED
4. Save the webhook. PayPal will generate a Webhook ID (e.g. 4HY87654CD2109876).
5. Copy this Webhook ID into GateFuz → Gateways → PayPal → Webhook ID (Sandbox and Live fields available).