Skip to main content

Paidlys API Documentation

Welcome to the Paidlys API documentation. It's a crypto payment gateway that enables merchants to accept cryptocurrency payments from their clients.

Quick Overview​

The platform 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 Merchant Dashboard
  2. Reach "Advanced" verification status by passing 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:

POST/api/invoices/v1/unlimited
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:

PAYMENT LINK
https://pay.my.paidlys.com/{invoice_id}

Next Steps​