ResourcesWallet

Wallet settings

Retrieve and update wallet availability, top-up limits, expiration, and payment methods.

GET
/v2/wallet/settings

Authorization

bearerAuth storeAuth
AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

X-STORE<token>

Select the SellApp store for this API request.

In: header

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://sell.app/api/v2/wallet/settings"
{
  "data": {
    "enabled": true,
    "minimum_top_up_cents": 1,
    "maximum_top_up_cents": 1,
    "expiration_days": 1,
    "payment_methods": [
      "string"
    ]
  }
}
{
  "message": "Unauthenticated."
}
{
  "message": "This action is unauthorized."
}
{
  "message": "The given data was invalid.",
  "errors": {
    "data": [
      "The data field is required."
    ]
  }
}
PUT
/v2/wallet/settings

Authorization

bearerAuth storeAuth
AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

X-STORE<token>

Select the SellApp store for this API request.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X PUT "https://sell.app/api/v2/wallet/settings" \  -H "Content-Type: application/json" \  -d '{    "enabled": true,    "minimum_top_up_cents": 1,    "maximum_top_up_cents": 1,    "expiration_days": 1,    "payment_methods": [      "string"    ]  }'
{
  "data": {
    "enabled": true,
    "minimum_top_up_cents": 1,
    "maximum_top_up_cents": 1,
    "expiration_days": 1,
    "payment_methods": [
      "string"
    ]
  }
}
{
  "message": "Unauthenticated."
}
{
  "message": "This action is unauthorized."
}
{
  "message": "The given data was invalid.",
  "errors": {
    "data": [
      "The data field is required."
    ]
  }
}

When no payment-method restriction has been saved, payment_methods contains every currently configurable top-up method. Sending that response back to PUT /v2/wallet/settings preserves those methods; sending an empty array disables wallet top-ups through every method.