Monkeys Commerce PayPal
This module integrates PayPal's latest Orders API with Drupal, offering a secure checkout experience that supports various payment methods like Pay Later and Venmo. It fully handles the payment lifecycle, including authorization, capture, and refunds, directly within the Drupal administration interface. The integration also includes robust handling of PayPal webhook events for real-time transaction updates.
MonkeysCommerce Payment: PayPal
PayPal Orders API v2 integration with OAuth2 authentication. Supports standard PayPal checkout, Pay Later, Venmo, credit/debit cards, and full authorize → capture → refund lifecycle.
This is an official payment gateway for MonkeysCommerce. It implements the PaymentGatewayInterface plugin system — providing createPayment, capture, refund, and handleWebhook methods.
Features
- Orders API v2: The latest, most secure standard for PayPal integrations — replaces the legacy Payments API.
- OAuth2 Authentication: Uses client credentials grant for secure server-to-server communication.
- Pay Later / Venmo: Automatically surfaces Pay Later and Venmo options based on customer region.
- Full Lifecycle: Supports Authorize → Capture → Refund directly from Drupal admin.
- Webhook Events: Handles
PAYMENT.CAPTURE.COMPLETED,PAYMENT.CAPTURE.REFUNDED,CHECKOUT.ORDER.APPROVED, and more. - Lightweight: Built directly on Guzzle HTTP — no bulky PayPal SDK dependency.
Configuration
Navigate to Administration → Commerce → Payment settings → Configure and enter:
- Client ID — PayPal app client ID
- Client Secret — PayPal app secret
- Mode — Sandbox or Live
- Webhook ID — For webhook signature verification
Webhook Endpoint
POST /payment/paypal/webhookInstallation
composer require drupal/mkc_payment_paypal drush en mkc_payment_paypal -y
Requirements
- Drupal 11.3+ or 12, PHP 8.2+
- MonkeysCommerce with mkc_payment enabled
Built with ❤️ by MonkeysCloud — empowering next-generation digital experiences.