Skip to main content
PATCH
Update a wallet

Authorizations

Authorization
string
header
required

API key authentication. Pass your API key as a Bearer token.

Headers

Alguna-Version
enum<string>
required
Available options:
2026-04-01
Idempotency-Key
string

A unique string used to ensure the request is processed exactly once. If you retry a request with the same idempotency key within 24 hours, the original response is returned without re-executing the operation.

Maximum string length: 255
Example:

"ik_a1b2c3d4e5f6"

Path Parameters

id
string
required

Unique identifier for the wallet

Body

application/json
active
boolean | null

Whether the wallet is active

currency
string | null

Currency code

name
string | null

Name of the wallet

product_ids
string[] | null

Product IDs that can be purchased with this wallet

Response

Success

active
boolean
required

Whether the wallet is active

Example:

true

created_at
string<date-time>
required

Timestamp when the wallet was created

Example:

"2026-04-01T10:00:00Z"

currency
string
required

Currency code

Example:

"USD"

current_balance
string
required

Current balance of the wallet

customer_id
string
required

Identifier of the customer that owns this wallet

Example:

"cust_01H2ABC"

id
string
required

Unique identifier for the wallet

Example:

"wlt_01H1VECT"

name
string
required

Name of the wallet

Example:

"Main Wallet"

updated_at
string<date-time>
required

Timestamp when the wallet was last updated

Example:

"2026-04-01T12:30:00Z"

product_ids
string[]

Product IDs that can be purchased with this wallet