High Level User Flow
This page describes the complete end-to-end payment lifecycle in PaidLys.
Payment Flow Steps
- Merchant registers in the PaidLys system
- Merchant reaches "Advanced" verification status by passing PaidLys security checks
- Merchant configures business account:
- Receiving assets
- Auto-conversion settings
- Underpayment limits
- Default asset
- Auto-withdrawals (API only)
- Default fee-payee
- Merchant creates an invoice
- Merchant shares the invoice link with the client
- Client fills in their email and selects the payment asset (if not pre-defined by the merchant)
- Client sees the payment amount, fees, and deposit address
- Client pays the invoice from an external wallet or exchange
Payment Outcomes
| Scenario | Result |
|---|---|
| Correct amount (or within underpayment limit) | Invoice → Done |
| Underpayment below limit | Invoice → Wrong |
| Merchant accepts "Wrong" invoice | Invoice → Done |
| Merchant declines "Wrong" invoice | Webhook → Refunded |
| Overpayment | Invoice → Done with "Overpayment" mark |
Post-Payment Steps
- (Optional) Merchant swaps received amount to any supported asset
- Merchant withdraws assets to an external wallet