The wallet object

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.

balance_cents

integer

required

The current wallet balance expressed in cents.

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).

recurring_transaction_rules

object[]

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

recurring_transaction_rules.lago_id

string

required

A unique identifier for the recurring transaction rule in the Lago application. Can be used to update a recurring transaction rule.

recurring_transaction_rules.trigger

enum<string>

required

The trigger. Possible values are interval or threshold.

Available options:

interval,

threshold

recurring_transaction_rules.method

enum<string>

required

The method used for recurring top-up. Possible values are fixed or target.

Available options:

fixed,

target

recurring_transaction_rules.interval

enum<string>

required

The interval used for recurring top-up. It represents the frequency at which automatic top-up occurs. The interval can be one of the following values: weekly, monthly, quarterly or yearly. Required only if trigger is set to interval.

Available options:

weekly,

monthly,

quarterly,

yearly

recurring_transaction_rules.threshold_credits

string

required

The threshold for recurring top-ups is the value at which an automatic top-up is triggered. For example, if this threshold is set at 10 credits, an automatic top-up will occur whenever the wallet balance falls to or below 10 credits. Required only when trigger is set to threshold.

recurring_transaction_rules.paid_credits

string

required

The number of paid credits. Required only if there is no granted credits.

recurring_transaction_rules.granted_credits

string

required

The number of free granted credits. Required only if there is no paid credits.

recurring_transaction_rules.started_at

string

The effective start date for recurring top-ups. This date should be provided in ISO 8601 datetime format and expressed in Coordinated Universal Time (UTC).

recurring_transaction_rules.target_ongoing_balance

string

required

The target ongoing balance is the value set for the ongoing balance to be reached by the automatic top-up. Required only when trigger is set to target.

recurring_transaction_rules.created_at

string

required

The date of the metadata object creation, represented in ISO 8601 datetime format and expressed in Coordinated Universal Time (UTC). The creation_date provides a standardized and internationally recognized timestamp for when the metadata object was created

ongoing_balance_cents

integer

required

The wallet ongoing balance expressed in cents.

ongoing_usage_balance_cents

integer

required

The wallet ongoing usage balance expressed in cents.

credits_ongoing_balance

string

required

The wallet ongoing balance expressed in credits.

credits_ongoing_usage_balance

string

required

The wallet ongoing usage balance expressed in credits.

API Reference