Invoice Statuses

Every PaidLys invoice goes through a lifecycle of status changes. This page documents all possible statuses and their meanings.

Status Reference

Status	Description
created	Invoice has been created by a merchant but hasn't been filled with client's info (email, payment currency and its network)
pending	Client has filled invoice with their info and received the payment address for deposit to be made. Deposit is still not received
processing	Deposit receiving procedure has started and is in progress
done	Deposit is successfully received. One of: deposit amount equals or is greater than expected; previously "wrong" invoice accepted by merchant; deposit amount is lower than expected by a sum covered by underpayment limit
wrong	Deposit is successfully received, but its amount is lower than expected (lower than invoice total amount)
refunded	Previously "wrong"-statused invoice has been rejected by merchant
failed	Deposit receiving failed by the system due to technical issues
expired	Previously "pending"-statused invoice hasn't received payment till expiration time

Status Flow Diagram

┌─────────┐     Client fills     ┌─────────┐     Payment      ┌────────────┐
│ Created  │ ──────────────────► │ Pending  │ ──  detected ──► │ Processing │
└─────────┘                      └─────────┘                   └────────────┘
                                      │                              │
                                      │ timeout                      │
                                      ▼                              ▼
                                 ┌─────────┐               ┌──────────────┐
                                 │ Expired  │               │  Done / Wrong │
                                 └─────────┘               └──────────────┘
                                                                    │
                                                          (if Wrong) │
                                                    ┌───────────────┼───────────────┐
                                                    ▼                               ▼
                                              ┌──────────┐                   ┌──────────┐
                                              │   Done   │                   │ Refunded │
                                              │(accepted)│                   │(declined)│
                                              └──────────┘                   └──────────┘

Expiration Rules

Asset	Expiration Time
All assets except BTC	30 minutes
BTC	120 minutes

note

Expiration applies from the moment a payment address is assigned (when the invoice transitions to pending status).

Status Applicability by Invoice Type

Status	Regular	AnyAmount	Business
created	Yes	Yes	Yes
pending	Yes	Yes	Yes
processing	Yes	Yes	Yes
done	Yes	Yes	Yes
wrong	Yes	No	Yes
refunded	Yes	No	Yes
failed	Yes	Yes	Yes
expired	Yes	Yes	Yes

tip

AnyAmount invoices cannot have wrong or refunded statuses because there is no expected amount to compare against.