PayPal Plugin

Accept PayPal payments in your nSelf-powered app. Create payment orders, capture funds, and handle webhooks — with transactions stored in your local database.

Overview

• Orders API — create, capture, and refund payment orders
• Webhooks — receive and verify PayPal IPN / webhook events
• Transaction Log — all transactions stored in np_paypal_transactions
• Sandbox Support — switch between sandbox and live with a single env var
• Currency Support — any currency PayPal supports

Installation

nself plugin install paypal

nself plugin status paypal

Configuration

# PayPal REST API credentials
# Get from: developer.paypal.com > My Apps & Credentials
PAYPAL_CLIENT_ID=your_client_id
PAYPAL_CLIENT_SECRET=your_client_secret

# Environment: sandbox or live (default: sandbox)
PAYPAL_ENV=sandbox

# Webhook ID (from PayPal dashboard)
PAYPAL_WEBHOOK_ID=your_webhook_id

Create a Payment (API)

POST /api/paypal/orders
{
  "amount": "29.99",
  "currency": "USD",
  "description": "ɳSelf+ annual subscription"
}

# Returns: { "order_id": "...", "approval_url": "https://paypal.com/..." }