Plugipay

Plugipay Documentation

Payment orchestration for the Forjio commerce suite. Subscriptions, invoicing, dunning, and a double-entry ledger on top of Xendit, Midtrans, and PayPal.

Plugipay is not a Merchant of Record — your customer contracts, your taxes, your refund decisions. We sit one layer above the payment gateways and handle the parts that otherwise turn into 900 lines of retry logic.

Start here

Quickstart → · Take your first payment in 10 minutes. Create an account, connect a provider (or use Plugipay managed), create a Plan, make a checkout session.

Quickstart (dev) → · Install the CLI, create a sandbox token, and script a checkout + webhook listener in three commands.

Core

Concepts → · Plan, Price, CheckoutSession, Subscription, Invoice, Ledger, PortalSession, PaymentToken, Dunning. One paragraph each.

Pricing → · Tiers, platform fee, worked examples. Plugipay doesn't markup gateway fees.

Providers

Four paths to take payments. Plugipay managed is the easiest — zero setup, no provider account needed.

Plugipay managed → · Automatic Xendit sub-account. Recommended default. 2-minute setup.

Bring your own Xendit → · Paste your Xendit secret key + callback token. Keep your existing account.

Bring your own Midtrans → · Paste your Midtrans server key. Use Midtrans as your primary gateway.

Bring your own PayPal → · Paste your PayPal REST client credentials. For cross-border flows.

Reference

API Reference · Envelope, authentication, endpoints. (coming soon)

CLI Reference · @forjio/plugipay-cli commands. (coming soon)

Get help

API version v1 · Last reviewed 2026-04-20.

Plugipay — Payments that don't tax your success