Skip to main content

PaidLys API Documentation

Welcome to the PaidLys API documentation. PaidLys is a crypto payment gateway that enables merchants to accept cryptocurrency payments from their clients.

Quick Overview​

PaidLys provides a complete payment processing solution:

  • Invoice Creation — Create and manage crypto invoices (regular, any-amount, or business) via API
  • Webhooks — Real-time notifications about invoice status changes
  • Withdrawals — Withdraw funds to external wallets or fiat requisites
  • Auto-conversion — Automatic asset swapping on the backend

Getting Your API Key​

  1. Register in the PaidLys Merchant Dashboard
  2. Reach "Advanced" verification status by passing PaidLys security checks
  3. Navigate to Settings → Tokens → Public Token
  4. Use this token as your Bearer token for API requests

Authentication​

All authenticated API requests require a Bearer token in the Authorization header:

curl -X POST https://my.paidlys.com/api/invoices/v1/unlimited \
  -H "Authorization: Bearer YOUR_PUBLIC_TOKEN" \
  -H "Content-Type: application/json"

Once an invoice is created, share the payment link with your client:

https://pay.paidlys.com/{invoice_id}

Next Steps​