Run your Payclio business from your own system.

curl -X POST https://payclio.com/api/v2/product-links \
  -H "Authorization: Bearer $PAYCLIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "walletId": 12,
    "title": "Coffee beans, 1 kg",
    "description": "Single origin, roasted this week.",
    "amountType": "FIXED",
    "amount": 240.00,
    "allowQuantity": true,
    "maxQuantity": 10,
    "collectPhone": "REQUIRED",
    "collectAddress": true,
    "noteMode": "OPTIONAL",
    "reusable": true,
    "expiresOn": "2026-12-31",
    "returnUrl": "https://example.com/thanks"
  }'

# 200
{ "id": 88, "token": "a1b2c3", "url": "https://app.payclio.com/req/a1b2c3",
  "status": "PENDING", "currency": "NAD", "title": "Coffee beans, 1 kg",
  "paymentCount": 0, "collected": 0.00, ... }

# 1. Save a draft
curl -X POST https://payclio.com/api/v2/invoices \
  -H "Authorization: Bearer $PAYCLIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "walletId": 12,
    "customerId": 31,
    "lines": [
      { "description": "Website hosting, November", "quantity": 1, "unitPrice": 350.00, "taxRate": 15 },
      { "description": "Domain renewal", "quantity": 1, "unitPrice": 180.00 }
    ],
    "issueDate": "2026-11-04",
    "dueDate": "2026-11-18",
    "memo": "Thank you for your business.",
    "sendReminders": true
  }'

# 2. Number it, open it for payment and email it
curl -X POST https://payclio.com/api/v2/invoices/204/send \
  -H "Authorization: Bearer $PAYCLIO_KEY" -H "Content-Type: application/json" -d '{}'

# 200
{ "id": 204, "number": "INV-0042", "status": "OPEN", "total": 582.50,
  "payerUrl": "https://app.payclio.com/i/kq81...", ... }

# 1. A plan: NAD 199 a month, 7 days free
curl -X POST https://payclio.com/api/v2/subscription-plans \
  -H "Authorization: Bearer $PAYCLIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Gym membership", "amount": 199.00, "currency": "NAD",
        "interval": "MONTH", "trialDays": 7 }'

# 200
{ "id": 14, "url": "https://app.payclio.com/sub/k2m9...", "status": "ACTIVE",
  "summary": "Free for 7 days, then NAD 199.00 every month until you cancel", ... }

# 2. A sign-up link for one of your members
curl -X POST https://payclio.com/api/v2/subscriptions/checkout \
  -H "Authorization: Bearer $PAYCLIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "planId": 14, "customerName": "Sam Example", "customerEmail": "sam@example.com",
        "referenceType": "member", "referenceId": "M-42",
        "returnUrl": "https://example.com/welcome" }'

# 200
{ "token": "x7p...", "hostedUrl": "https://app.payclio.com/sub/c/x7p...",
  "expiresAt": "2026-11-05T18:00:00Z", "status": "OPEN", "subscriptionId": null, ... }

curl -X POST https://payclio.com/api/v2/transactions/4821/refund \
  -H "Authorization: Bearer $PAYCLIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "customer_request", "message": "Order cancelled before dispatch." }'

# 200
{ "reason": "CUSTOMER_REQUEST", "reasonLabel": "The customer asked for a refund",
  "by": "You", "method": "Card", "amount": 49.99, "fee": 0.50,
  "debited": 50.49, "at": "2026-11-04T13:10:00Z" }

curl -X POST https://payclio.com/api/v2/payouts \
  -H "Authorization: Bearer $PAYCLIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "walletId": 12,
    "rows": [
      { "payeeId": 7, "amount": 1500.00, "reference": "Invoice 118", "myReference": "Supplier Oct" },
      { "payeeId": 9, "amount": 250.00, "reference": "Commission" }
    ]
  }'

# 200
{ "batchId": 15, "currency": "NAD", "total": 1760.00, "feeTotal": 10.00,
  "rows": [ { "payeeId": 7, "method": "BANK", "amount": 1500.00, "fee": 10.00, "status": "PENDING", ... },
            { "payeeId": 9, "method": "PAYCLIO", "amount": 250.00, "fee": 0, "status": "COMPLETED", ... } ] }