Wallet Limits

Returns card creation restrictions and the list of BINs available for issuing cards from this wallet.

---

Endpoint

GET /api/v2/organizations/{org_id}/wallets/{wallet_id}/limits

Path Parameters

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

---

Request

curl "https://api.4pay.cc/api/v2/organizations/{org_id}/wallets/{wallet_id}/limits" \
  -H "Authorization: Bearer YOUR_API_KEY"

---

Response

200 OK

{
  "data": {
    "limits": [
      {
        "type": "daily_limit",
        "amountMin": "10.00",
        "amountMax": "10000.00"
      },
      {
        "type": "monthly_limit",
        "amountMin": "100.00",
        "amountMax": "50000.00"
      },
      {
        "type": "transaction_limit",
        "amountMin": "1.00",
        "amountMax": "5000.00"
      }
    ],
    "binList": [
      {
        "cardProviderBinId": "ff246e21-3bda-4e47-83fb-05203939fe5b",
        "bin": "411111",
        "cardNetwork": "Visa",
        "categoryIds": ["7c9e6679-7425-40de-944b-e07fc1f90ae7"]
      }
    ],
    "cardBalance": true
  }
}

Response Fields

Field	Type	Description
limits	array	Allowed ranges for card spending limits
limits[].type	string	Limit type: daily_limit, monthly_limit, transaction_limit, etc.
limits[].amountMin	string	Minimum value when setting this limit on a card
limits[].amountMax	string	Maximum value when setting this limit on a card
binList	array	BINs available for card issuance from this wallet
binList[].cardProviderBinId	string	Use this ID when issuing a card
binList[].bin	string	First 6 digits of the card number
binList[].cardNetwork	string	Visa or Mastercard
binList[].categoryIds	array	BIN category IDs this BIN belongs to
cardBalance	boolean	Whether cards from this wallet have individual balances

Use this endpoint before issuing cards

Check limits to validate that your card spending limits fall within the allowed ranges, and use binList to pick the right cardProviderBinId for card issuance.