Kobble

Update wallet

PATCH

/customers/v1/wallets/{id}

Wallets

Update the status of a wallet by its ID.

Request

Path Params

string

required

Wallet id

Header Params

Content-Type

string

required

Example:

application/json

Authorization

string

required

Example:

Bearer eyJraWQiOiJqdzdJN05LSDJpRENORlJiNHA2UVRxRTNcL3paWWJaam9lbFZ5YnAwMlwvZ2M9IiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiIzamNoN2UxYmE5Y3BoNW9uZjN0ZHM4amRjMSIsInRva2VuX3VzZSI6ImFjY2VzcyIsInNjb3BlIjoiYWRtaW5pc3RyYXRvclwvd3JpdGUiLCJhdXRoX3RpbWUiOjE3MzM3MjM3NDYsImlzcyI6Imh0dHBzOlwvXC9jb2duaXRvLWlkcC5hcC1zb3V0aGVhc3QtMi5hbWF6b25hd3MuY29tXC9hcC1zb3V0aGVhc3QtMl9nSHlTRGhpY2siLCJleHAiOjE3MzM3MjczNDYsImlhdCI6MTczMzcyMzc0NiwidmVyc2lvbiI6MiwianRpIjoiODVlZGI4MGQtMmNiZS00NzUwLWJmNTktMzZlMDg1ZjM0ZmNjIiwiY2xpZW50X2lkIjoiM2pjaDdlMWJhOWNwaDVvbmYzdGRzOGpkYzEifQ.Y-_ZYC7BR8v_sEYmZey_0upML7y2ZvNSR70dhUnx077cpntLubpMt1EBjPsiKGanArzZSH2kaG5EqawoflwfHRH7iEKVYqDuScqr62lxmlScrYMeT48lQaaxaltt_iqtEWS00GG8ymuCT2hnrLgEsUQlTiRPcpucd4YDhz7BJ6HJxYpcmSFbXCfVpuhXd966iBvhg06vr2rojln6GXAki7-VCwmbrgOxQvqbfAAm9h6YkhwpbBD_kKeo2X8y8oTm777ZEctTF-9lWopfKPP2O2lBgZe6aUnTUPWqpoj1vVItk8mWZBwFhma0YVN3B8Vt43yftGMZsIo8wqNk2H-VnA

Body Params application/json

status

string

required

ACTIVE,INACTIVE,SUSPENDED

Example

{
    "status": "ACTIVE"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH '/customers/v1/wallets/' \
--header 'Authorization: Bearer eyJraWQiOiJqdzdJN05LSDJpRENORlJiNHA2UVRxRTNcL3paWWJaam9lbFZ5YnAwMlwvZ2M9IiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiIzamNoN2UxYmE5Y3BoNW9uZjN0ZHM4amRjMSIsInRva2VuX3VzZSI6ImFjY2VzcyIsInNjb3BlIjoiYWRtaW5pc3RyYXRvclwvd3JpdGUiLCJhdXRoX3RpbWUiOjE3MzM3MjM3NDYsImlzcyI6Imh0dHBzOlwvXC9jb2duaXRvLWlkcC5hcC1zb3V0aGVhc3QtMi5hbWF6b25hd3MuY29tXC9hcC1zb3V0aGVhc3QtMl9nSHlTRGhpY2siLCJleHAiOjE3MzM3MjczNDYsImlhdCI6MTczMzcyMzc0NiwidmVyc2lvbiI6MiwianRpIjoiODVlZGI4MGQtMmNiZS00NzUwLWJmNTktMzZlMDg1ZjM0ZmNjIiwiY2xpZW50X2lkIjoiM2pjaDdlMWJhOWNwaDVvbmYzdGRzOGpkYzEifQ.Y-_ZYC7BR8v_sEYmZey_0upML7y2ZvNSR70dhUnx077cpntLubpMt1EBjPsiKGanArzZSH2kaG5EqawoflwfHRH7iEKVYqDuScqr62lxmlScrYMeT48lQaaxaltt_iqtEWS00GG8ymuCT2hnrLgEsUQlTiRPcpucd4YDhz7BJ6HJxYpcmSFbXCfVpuhXd966iBvhg06vr2rojln6GXAki7-VCwmbrgOxQvqbfAAm9h6YkhwpbBD_kKeo2X8y8oTm777ZEctTF-9lWopfKPP2O2lBgZe6aUnTUPWqpoj1vVItk8mWZBwFhma0YVN3B8Vt43yftGMZsIo8wqNk2H-VnA' \
--header 'Content-Type: application/json' \
--data-raw '{
    "status": "ACTIVE"
}'

Responses

🟢200OK

application/json

Body

A wallet represents a store of value for a specific holder.

string <uuid>

required

The unique identifier of the wallet.

external_id

string | null

required

An external reference ID for the wallet.

created_at

string <date-time>

required

The timestamp when the wallet was created.

updated_at

string <date-time>

required

The timestamp when the wallet was last updated.

holder_id

string <uuid>

required

The unique identifier of the wallet holder.

asset

enum<string>

required

The type of asset held in the wallet.

Allowed value:

AUD

asset_class

enum<string>

required

The class of the asset.

Allowed value:

CURRENCY

status

enum<string>

required

The current status of the wallet.

Allowed values:

ACTIVEINACTIVESUSPENDED

partner_product

enum<string>

required

The partner product associated with the wallet.

Allowed value:

KOBBLE_AUD_1

total_amount

number <float>

required

The total amount of the asset in the wallet.

amount

number <float>

required

The available amount of the asset in the wallet.

reserved_amount

number <float>

required

The reserved amount of the asset in the wallet.

Example

{
    "id": "1bbba11b-81b2-46aa-8498-982c29465a37",
    "external_id": "11111",
    "created_at": "2025-01-14T16:57:27.650Z",
    "updated_at": "2025-01-14T16:57:27.650Z",
    "holder_id": "0e3810f0-7960-437d-ab99-7cb6fb954fbf",
    "asset": "AUD",
    "asset_class": "CURRENCY",
    "status": "SUSPENDED",
    "partner_product": "KOBBLE_AUD_1",
    "total_amount": 1,
    "amount": 1,
    "reserved_amount": 0
}

Get wallet by ID

Relays API