get
https://api.banking.netevia.dev/netevia/cardProducts/settings
Get Card Product's Settings
The /netevia/cardProducts/settings endpoint retrieves comprehensive configuration and settings information for a specific card product in the Netevia banking platform. It returns details such as transaction limits (ATM, POS, ACH, account-to-account), balance limits, and associated account identifiers. Partners and authorized users can use this endpoint to inspect how a card product is configured before issuing cards or making product-level decisions.
Endpoint
GET /netevia/cardProducts/settings
Authentication
Bearer token required. Obtain via:
POST https://api.banking.netevia.dev/api/auth/v2Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.
When to use
Use this endpoint when you need to display or audit the limits and configuration of a card product before issuing cards to customers. It is also useful for validating that a card product's limits align with your partner program requirements, or for surfacing card feature details within your application's UI.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| cardProductId | string | No | The unique identifier of the card product whose settings you want to retrieve. |
Response
200 OK
| Field | Type | Description |
|---|---|---|
| cardProductId | string | Unique identifier of the card product. |
| commercial | boolean | Indicates whether the card product is a commercial (business) card. |
| name | string | Display name of the card product (max 100 characters). |
| productFundingAccountId | string | Identifier of the funding account associated with the card product (max 100 characters). |
| incomeAccountId | string | Identifier of the income account used to collect fees or interest (max 100 characters). |
| reserveAccountId | string | Identifier of the reserve account for the card product (max 100 characters). |
| negativeBalanceReserveAccountId | string | Identifier of the account used to cover negative balances (max 100 characters). |
| partnerProfileId | integer (int32) | Numeric identifier of the partner profile associated with this card product. |
| balanceLimit | integer (int64) | Maximum allowed balance on the card, in cents. |
| achLimitTxn | integer (int64) | Per-transaction ACH transfer limit, in cents. |
| atmLimitDaily | integer (int64) | Daily ATM withdrawal limit, in cents. |
| atmLimitMonthly | integer (int64) | Monthly ATM withdrawal limit, in cents. |
| posLimitTxn | integer (int64) | Per-transaction point-of-sale purchase limit, in cents. |
| posLimitDaily | integer (int64) | Daily point-of-sale purchase limit, in cents. |
| posLimitMonthly | integer (int64) | Monthly point-of-sale purchase limit, in cents. |
| a2aLimitTxn | integer (int64) | Per-transaction account-to-account transfer limit, in cents. |
| a2aLimitDaily | integer (int64) | Daily account-to-account transfer limit, in cents. |
| a2aLimitWeekly | integer (int64) | Weekly account-to-account transfer limit, in cents. |
| a2aLimitMonthly | integer (int64) | Monthly account-to-account transfer limit, in cents. |
| a2aLimitIncoming | integer (int64) | Incoming account-to-account transfer limit, in cents. |
{
"cardProductId": "cp_7a3f2b19e4d8",
"commercial": true,
"name": "Netevia Business Debit",
"productFundingAccountId": "XXXXXXXXXX",
"incomeAccountId": "XXXXXXXXXX",
"reserveAccountId": "XXXXXXXXXX",
"negativeBalanceReserveAccountId": "XXXXXXXXXX",
"partnerProfileId": 1042,
"balanceLimit": 500000,
"achLimitTxn": 100000,
"atmLimitDaily": 50000,
"atmLimitMonthly": 300000,
"posLimitTxn": 75000,
"posLimitDaily": 200000,
"posLimitMonthly": 1000000,
"a2aLimitTxn": 100000,
"a2aLimitDaily": 250000,
"a2aLimitWeekly": 500000,
"a2aLimitMonthly": 1500000,
"a2aLimitIncoming": 200000
}Error Codes
| Code | When it happens |
|---|---|
| 400 | The cardProductId value is malformed or not a valid format |
| 401 | Token missing, expired, or invalid |
| 403 | Insufficient permissions to view this card product's settings |
| 404 | No card product found for the provided cardProductId |
| 500 | Internal server error |
Common Mistakes
- Omitting
cardProductIdmay return a default or empty response instead of a specific product's settings — always pass the intended product ID. - Limit values are returned in cents (integer), not dollars. Divide by 100 when displaying to end users.
- Do not confuse
partnerProfileId(the partner account) with the card holder's customer profile ID. - The
commercialflag distinguishes business card products from personal ones; ensure you are querying the correct product type for your use case.
Related Endpoints
GET /netevia/cardProducts— List all available card products for the partnerGET /netevia/cardProducts/{cardProductId}— Get detailed information about a specific card productPOST /netevia/cards— Issue a new card using a card productGET /netevia/cards/{cardId}/settings— Retrieve settings for an individual issued card
Example
curl -X GET "https://api.banking.netevia.dev/netevia/cardProducts/settings?cardProductId=cp_7a3f2b19e4d8" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json"