get
https://api.banking.netevia.dev/settings/cardProductSettings
Get Card Product Settings
This endpoint returns the card product settings configured for the authenticated partner, including transaction limits for ATM, POS, and ACH operations, as well as the associated funding, income, and reserve account identifiers. It is a read-only GET request that requires a valid Bearer token.
Endpoint
GET /settings/cardProductSettings
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 to retrieve the current transaction limit settings and account configuration for a card product. This is useful during partner onboarding, compliance audits, or when building admin dashboards that display current card program parameters. It can also be used to verify applied settings after a configuration change.
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 (max 100) | Display name of the card product |
productFundingAccountId | string (max 100) | ID of the account used to fund card product transactions |
incomeAccountId | string (max 100) | ID of the account that receives fee and interest income |
reserveAccountId | string (max 100) | ID of the reserve account held against potential losses |
negativeBalanceReserveAccountId | string (max 100) | ID of the account used to cover negative balances |
partnerProfileId | integer | Internal partner profile identifier associated with the card product |
balanceLimit | integer (int64) | Maximum balance allowed on the card, in cents |
achLimitTxn | integer (int64) | Per-transaction ACH 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 POS purchase limit, in cents |
posLimitDaily | integer (int64) | Daily POS purchase limit, in cents |
posLimitMonthly | integer (int64) | Monthly POS 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) | Limit on incoming account-to-account transfers, in cents |
{
"cardProductId": "cp_abc123xyz",
"commercial": true,
"name": "Netevia Business Debit",
"productFundingAccountId": "fa_001funding",
"incomeAccountId": "fa_002income",
"reserveAccountId": "fa_003reserve",
"negativeBalanceReserveAccountId": "fa_004negreserve",
"partnerProfileId": 42,
"balanceLimit": 500000,
"achLimitTxn": 100000,
"atmLimitDaily": 50000,
"atmLimitMonthly": 300000,
"posLimitTxn": 25000,
"posLimitDaily": 100000,
"posLimitMonthly": 500000,
"a2aLimitTxn": 200000,
"a2aLimitDaily": 500000,
"a2aLimitWeekly": 1000000,
"a2aLimitMonthly": 3000000,
"a2aLimitIncoming": 5000000
}Error Codes
| Code | When it happens |
|---|---|
| 401 | Token missing, expired, or invalid |
| 403 | Authenticated user does not have permission to view card product settings |
| 404 | No card product settings found for the authenticated partner |
| 500 | Internal server error |
Common Mistakes
- Omitting the
Authorizationheader or using an expired token, resulting in a 401 response. - Assuming limit values are in dollars — all monetary limit fields are returned in cents (e.g.,
50000= $500.00). - Treating
nullfields (such asreserveAccountId) as an error; nullable fields indicate the feature or account link is not configured for this card product.
Related Endpoints
GET /settings— Retrieve general partner account settingsPOST /settings/cardProductSettings— Create or update card product settingsGET /cards— List cards issued under the card product
Example
curl -X GET https://api.banking.netevia.dev/settings/cardProductSettings \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json"