Monkeys Commerce PayPal

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/webhook

Installation

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.