Skip to content

Set USD wallet card policy

PATCH
/dashboard/v1/merchants/{merchantId}/{mode}/card-wallets/{id}/policy
curl --request PATCH \
--url https://api.xaalis.org/dashboard/v1/merchants/example/test/card-wallets/example/policy \
--header 'Content-Type: application/json' \
--header 'idempotency-key: example' \
--cookie better-auth.session_token=<better-auth.session_token> \
--data '{ "max_intent_amount": 1, "auto_daily_amount": 1, "max_daily_amount": 1, "no_intent_amount": 0 }'
merchantId
required
string
mode
required
string
Allowed values: test live
id
required
string
idempotency-key
required

Required retry-safe key; reuse it only for the same operation and request body

string
>= 1 characters <= 255 characters

Required retry-safe key; reuse it only for the same operation and request body

Media typeapplication/json
object
max_intent_amount
required
integer
>= 1 <= 100000000
auto_daily_amount
required
integer
>= 1 <= 100000000
max_daily_amount
required
integer
>= 1 <= 100000000
no_intent_amount
integer
0 <= 100000000

USD policy

Media typeapplication/json
object
max_intent_amount
required
integer
>= 1 <= 100000000
auto_daily_amount
required
integer
>= 1 <= 100000000
max_daily_amount
required
integer
>= 1 <= 100000000
no_intent_amount
integer
0 <= 100000000
object
required
string
Allowed values: agent_card_policy
wallet_id
required
string
currency
required
string
Allowed values: USD
Example
{
"no_intent_amount": 0,
"object": "agent_card_policy",
"currency": "USD"
}

Validation error

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
details
Examplegenerated
{
"error": {
"code": "example",
"message": "example",
"details": "example"
}
}

Authentication required

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
details
Examplegenerated
{
"error": {
"code": "example",
"message": "example",
"details": "example"
}
}

Forbidden

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
details
Examplegenerated
{
"error": {
"code": "example",
"message": "example",
"details": "example"
}
}

Not found

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
details
Examplegenerated
{
"error": {
"code": "example",
"message": "example",
"details": "example"
}
}

Idempotency conflict or invalid state

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
details
Examplegenerated
{
"error": {
"code": "example",
"message": "example",
"details": "example"
}
}

Policy limit or insufficient funds

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
details
Examplegenerated
{
"error": {
"code": "example",
"message": "example",
"details": "example"
}
}

Rate limited

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
details
Examplegenerated
{
"error": {
"code": "example",
"message": "example",
"details": "example"
}
}

Service unavailable

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
details
Examplegenerated
{
"error": {
"code": "example",
"message": "example",
"details": "example"
}
}