LogoLogo
NymCardAPI catalogContact usnFront catalog
  • NYMCARD DOCUMENTATION
  • Get Started
    • nCore API Quick Tutorial
    • API Core Principles
    • Program management
      • Manage documents by APIs
      • User KYB process
      • Necessary parameters per user type
      • User ID verification by SDK
      • User KYC process
    • Issuance
      • Users
      • Cards
    • Issuing Physical Cards
      • Individual card issuance
      • Bulk card issuance
      • Card fulfillment
      • Card PIN management
      • Card replacement
      • Proxy number usage
    • Issuing Virtual Cards
      • Migration of virtual to physical card
    • Funding and transfers
      • Funding
      • Internal funding source
      • External funding source
        • From card
        • From bank account
        • Lean API flow
        • DAPI direct API flow
      • Transfers
      • Western Union APIs
    • Product Management
      • Card product
      • Balance limits
      • Velocity limits
      • Fees
      • Charges
      • Multi-currency
      • Authorization controls
        • Enhancements for MCC list management
    • Transactions
      • Payment ecosystem
      • Transaction lifecycle
      • Transaction types
      • Transaction endpoints scenarios
      • Multi-clearing process
    • Webhooks
      • Introduction to webhooks
      • nCore webhook events
      • Steps to configure a webhook
      • Webhooks samples
      • Webhook changes for simulation
      • Webhooks management
    • Security
      • PCI widget
      • 3D Secure
      • OTP SMS templates
    • Release announcements
      • Embedded Lending Release Notes
      • Changes in the release on 13/07/2023
      • Changes in the release on 23/05/2023
      • Changes in the release on 04/04/2023
  • For developers
    • nCore API catalog
    • nFront API catalog
Powered by GitBook
On this page
  • Create balance limit
  • Retrieve balance limits
  • Update a balance limit
  • Link balance limit with a card product
  • Unlink a balance limit from a card product
  • Retrieve linked balance limits
  • Link balance limit to account
  • Unlink balance limit to account
  • Get balance limits linked to account

Was this helpful?

  1. Get Started
  2. Product Management

Balance limits

PreviousCard productNextVelocity limits

Last updated 9 months ago

Was this helpful?

The balance limit feature in nCore platform enables you to define the maximum and/or minimum limit on the funds an individual account can hold. Balance limit that you define shall be tied with the card product. Balance limit shall become applicable to the accounts associated with the card product.

Create balance limit

You can create a new balance limit as per your requirement by sending a POST request to /balancelimits endpoint as shown below.

{ "description": "The balance limit – For account", "type": "PER_ACCOUNT", "min_amount": 1500, "max_amount": 1500, "currency": "USD" }

Retrieve balance limits

nCore offers two balance limits retrieval options.

Retrieve all balance limits

You can retrieve all existing balance limits by sending a GET request to /balancelimits endpoint shown below.

Retrieve a specific balance limit

You can retrieve a specific balance limit by sending a GET request to /balancelimits/{id} endpoint, where id is the balance limit id.

Update a balance limit

You can update a balance limit by sending a PUT request to /balancelimits/{id} endpoint as shown below.

Link balance limit with a card product

You can associate a balance limit to your card product by sending a POST requests to /cardproducts/{id}/balancelimits:link endpoint as shown below.

Unlink a balance limit from a card product

You can unlink a balance limit from a card product by sending a POST request to /cardproducts/{id}/balancelimits:unlink endpoint as shown below.

Retrieve linked balance limits

You can retrieve all balance limits which are linked with your card product. Send a GET request to /cardproducts/{id}/balancelimits endpoint as shown below.

Link balance limit to account

You can link balance limit to the specific account. Send a POST request to /accounts/{id}/balancelimits:link endpoint as shown below.

Unlink balance limit to account

You can unlink balance limit from the specific account. Send a POST request to /accounts/{id}/balancelimits:unlink endpoint as shown below.

Get balance limits linked to account

You can get list of balance limits linked to specific account. Send a GET request to /accounts/{id}/balancelimits endpoint as shown below.

POST /balancelimits
GET /balancelimits
GET /balancelimits/{id}
PUT /balancelimits/{id}
POST /cardproducts/{id}/balancelimits:link
POST /cardproducts/{id}/balancelimits:unlink
GET /cardproducts/{id}/balancelimits
POST /accounts/{id}/balancelimits:link
POST /accounts/{id}/balancelimits:unlink
GET /accounts/{id}/balancelimits