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
      • Checkout widget
    • 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
  • Sign up to get the API key
  • Run the API collection in Postman
  • Create a user
  • Retrieve a card product
  • Create a card
  • Get card account
  • Fund a card account
  • Check card account balance
  • Control spending

Was this helpful?

  1. Get Started

nCore API Quick Tutorial

PreviousNYMCARD DOCUMENTATIONNextAPI Core Principles

Last updated 4 months ago

Was this helpful?

By using this quick tutorial in our Getting Started Guide, you should understand how to:

Sign up to get the API key

Please click the ‘sign-up’ link below to create an account and get access to the nCore platform.

Run the API collection in Postman

You can run the NymCard API collection in Postman by clicking the following button:

In your Postman environment, you'll need to define the ‘apikey’ variable.

Create a user

You can create a user by sending a POST request to /users endpoint. After the user is created, save the received API response including the 'ID' field.

Retrieve a card product

The card product acts as a template that defines general features and behaviors that are applicable to the cards belonging to that card product. Card product defines currency, PIN, authorization & other card characteristics.

Before creating a card, you must select the card product for which you want to create the card. Send a GET request to /cardproducts endpoint to retrieve card products.

Create a card

A card generally refers to a payment instrument that allows its user to perform payment transactions at merchants. For example, a card type could be referred to as a virtual card or a physical card.

You can create a card by sending a POST request to /cards endpoint. You are required to include below details in your POST message body.

  • User ID - A unique ID of the user for whom you want to create a card

  • Card Product ID - A unique ID of the card product for which you want to create a card

After the card is created save the received API response, including the 'ID' field, as this is the card's unique Identification.

The code sample below is a request that creates a card.

Get card account

When you create a card, an account is usually automatically created and linked to that card. This account is where the balance is maintained. You need a Card ID to retrieve this card account.

Note, that you can create a card without an account. It is configured on the card product level, where you have to set the 'link_account_to_card' parameter as 'false'.

Fund a card account

This account needs to be funded before the card can be used for transactions. You can load funds to the card account by sending a POST request to the /accounts/{id}:loadfunds endpoint. This will load funds from the program funding account to the card account.

Check card account balance

After loading funds into the card account, you can check your balance by sending a GET request to the /accounts/{id} endpoint.

Control spending

You can control cardholder’s balance and spending using balance limits and velocity limits.

Balance limits controls how much balance the user can have in his/her account. Create a balance limit through sending a POST request to /balancelimits endpoint.

The code sample below is a request that creates a balance limit.

Velocity limits controls how much the cardholder can spend in one transaction. It also controls how much and/or how many transactions the cardholder can perform in a certain time period (daily, monthly, yearly or all time). Create a velocity limit by sending a POST request to /velocitylimits endpoint.

Note: If you want to use APIs from your client application or by directly using the URLs, then a valid API key is required. For reference on how to use this API key, please refer to section .

For more information refer to the Postman's documentation about .

{ "first_name": "John", "last_name": “Smith” }

Note: The APIs support pagination and sorting features, please refer to section

{ "user_id": "d089a80f-e641-4045-8a80-54841e4a7458", "card_type": “VIRTUAL”, "card_product_id": "b4eabfc-f839-4e51" }

{ "currency": "USD", "amount": 123.45 }

{ "description": "Some description of the balance limit", "type": "PER_ACCOUNT", "min_amount": 1500.1, "max_amount": 1500.1, "currency": "USD" }

{ "description": "Some description of the velocity Limit", "type": "PER_TRANSACTION", "min_amount": 1500.1, "max_amount": 1500.1, "currency": “USD”, "frequency": 0, “period”: “DAILY” }

nCore Platform sign-up
managing environments
POST /users
GET /cardproducts
POST /cards
GET /cards/{id}/accounts
POST /accounts/{id}:loadfunds
GET /accounts/{id}
POST /balancelimits
POST /velocitylimits
Drawing
AUTHENTICATION
PAGINATION AND SORTING.