lago_id
string
required

Unique identifier assigned to the wallet within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the wallet's record within the Lago system.

lago_customer_id
string
required

Unique identifier assigned to the customer within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the customer's record within the Lago system.

external_customer_id
string
required

The customer external unique identifier (provided by your own application)

status
enum<string>
required

The status of the wallet. Possible values are active or terminated.

Available options:
active,
terminated
currency
enum<string>
required

The currency of the wallet.

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,
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,
SZL,
THB,
TJS,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
UYU,
UZS,
VND,
VUV,
WST,
XAF,
XCD,
XOF,
XPF,
YER,
ZAR,
ZMW
name
string

The name of the wallet.

rate_amount
string
required

The rate of conversion between credits and the amount in the specified currency. It indicates the ratio or factor used to convert credits into the corresponding monetary value in the currency of the transaction.

credits_balance
string
required

The current wallet balance expressed in credits. This reflects the available balance after all transactions are settled.

balance_cents
integer
required

The current wallet balance expressed in cents. This reflects the available balance after all transactions are settled.

consumed_credits
string
required

The number of consumed credits.

created_at
string
required

The date of the wallet creation, represented in ISO 8601 datetime format and expressed in Coordinated Universal Time (UTC).

expiration_at
string | null

The date and time that determines when the wallet will expire. It follows the ISO 8601 datetime format and is expressed in Coordinated Universal Time (UTC).

last_balance_sync_at
string | null

The date and time of the last balance top-up. It follows the ISO 8601 datetime format and is expressed in Coordinated Universal Time (UTC).

last_consumed_credit_at
string | null

The date and time of the last credits consumption. It follows the ISO 8601 datetime format and is expressed in Coordinated Universal Time (UTC).

terminated_at
string | null

The date of terminaison of the wallet. It follows the ISO 8601 datetime format and is expressed in Coordinated Universal Time (UTC).

invoice_requires_successful_payment
boolean

A boolean setting that, when set to true, delays issuing an invoice for a wallet top-up until a successful payment is made; if false, the invoice is issued immediately upon wallet top-up, regardless of the payment status. Default value of false.

recurring_transaction_rules
object[]

List of recurring transaction rules. Currently, we only allow one recurring rule per wallet.

ongoing_balance_cents
integer
required

The ongoing wallet balance expressed in cents. This represents the balance_cents minus the ongoing_usage_balance_cents, showing the real time balance after accounting for current usage including taxes.

ongoing_usage_balance_cents
integer
required

The ongoing usage balance of the wallet, expressed in cents. This reflects all current usage including taxes.

credits_ongoing_balance
string
required

The ongoing wallet balance expressed in credits. This represents the credits_balance minus the credits_ongoing_usage_balance, showing the real time balance after accounting for current usage including taxes.

credits_ongoing_usage_balance
string
required

The ongoing usage balance of the wallet, expressed in credits. This reflects all current usage including taxes.