Skip to main content
lago_id
string<uuid>
required

Unique identifier of the payment request, created by Lago.

Example:

"1a901a90-1a90-1a90-1a90-1a901a901a90"

email
string<email> | null
required

The email address used for sending dunning notifications. It defaults to the customer's own email address, and is null when the customer has none.

Example:

"dinesh@piedpiper.example"

amount_cents
integer
required

The amount the payment request collects, expressed in cents. It is the sum of the amounts still due on the invoices it covers, minus the credit notes offset against those invoices.

Example:

100

amount_currency
enum<string>
required

The currency of the payment request.

Available options:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BIF,
BMD,
BND,
BOB,
BRL,
BSD,
BWP,
BYN,
BZD,
CAD,
CDF,
CHF,
CLF,
CLP,
CNY,
COP,
CRC,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
ISK,
JMD,
JPY,
KES,
KGS,
KHR,
KMF,
KRW,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRO,
MUR,
MVR,
MWK,
MXN,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SEK,
SGD,
SHP,
SLL,
SOS,
SRD,
STD,
SYP,
SZL,
THB,
TJS,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
UYU,
UZS,
VND,
VUV,
WST,
XAF,
XCD,
XOF,
XPF,
YER,
ZAR,
ZMW
Example:

"EUR"

payment_status
enum<string>
required

The status of the payment associated with the payment request. It can have one of the following values:

  • pending: the payment has not been processed yet. A payment request starts with this status.
  • succeeded: the payment of the payment request has been successfully processed.
  • failed: the payment of the payment request has failed or encountered an error during processing.
Available options:
pending,
succeeded,
failed
Example:

"succeeded"

created_at
string<date-time>
required

The date and time when the payment request was created. It is expressed in UTC format according to the ISO 8601 datetime standard. This field provides the timestamp for the exact moment when the payment request was initially created.

Example:

"2022-04-29T08:59:51Z"

customer
object
required

The customer on which the payment request applies. It refers to the customer account or entity associated with the payment request.

invoices
object[]
required

The overdue invoices the payment request collects the payment for.