Update Wallet

Updates a wallet's name, custom fee settings, or BIN configurations. This is an async operation.

---

Endpoint

PATCH /api/v2/organizations/{org_id}/wallets/{wallet_id}

Path Parameters

Parameter	Type	Required	Description
org_id	string	Yes	Your organization ID
wallet_id	string	Yes	Wallet UUID

---

Request Body

{
  "name": "Business Expenses",
  "fees": {
    "cardTransactions": {
      "type": "percent",
      "percent": "2.5"
    },
    "cardIssuing": {
      "type": "amount",
      "amount": "5.00",
      "currency": "USD"
    }
  },
  "accountBinDirections": [
    {
      "categoryId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "cardProviderBinIds": [
        "ff246e21-3bda-4e47-83fb-05203939fe5b"
      ]
    }
  ]
}

Fields

Field	Type	Required	Description
name	string	Yes	Wallet name (2–40 chars, Latin letters, digits, spaces, dashes, parentheses)
fees	object	No	Custom fee overrides
fees.cardTransactions	object	No	Fee per card transaction — percent or fixed amount
fees.cardIssuing	object	No	Fixed fee per card issued
fees.topUpsAllocation	object	No	Percentage fee on top-up allocation
accountBinDirections	array	No	BIN configs — which BINs are available per category

Fee Types

Percentage fee:

{
  "type": "percent",
  "percent": "2.5"
}

Fixed amount fee:

{
  "type": "amount",
  "amount": "5.00",
  "currency": "USD"
}

---

Request

curl -X PATCH "https://api.4pay.cc/api/v2/organizations/{org_id}/wallets/{wallet_id}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Business Expenses",
    "fees": {
      "cardTransactions": {
        "type": "percent",
        "percent": "2.5"
      }
    }
  }'

---

Response

204 No Content

Async operation

After 204, poll Get Wallet Details to verify the changes were applied.