Guides
Home

Card Program

Card programs are designed to meet the diverse needs of cardholders while aligning with the strategic objectives of the card issuer

A card program outlines the specific features, functionalities, terms, and conditions associated with the cards. It serves as a blueprint for offering various types of payment cards, such as credit cards, debit cards, prepaid cards, and other specialized cards.

Key components of a card program

  • Card Types: Specifies the different types of cards offered under the program, such as debit cards, prepaid cards, or specialty cards like travel cards, rewards cards, or business cards.
  • Target Audience: Outlines the terms and conditions that cardholders must adhere to when using the cards. This includes details about interest rates, fees, grace periods, and other contractual obligations.
  • Card Design and Branding: Describes the visual aspects of the cards, including their design, color scheme, and any branding elements. Co-branded cards may feature logos of partnering companies.
  • Lifecycle Management: Covers the entire lifecycle of the cards, including issuance, activation, usage, renewal, replacement, and, if necessary, blocking or termination

Card Program Initialization

The Create New Card program API allows you to initiate new card program request, and request will send to the administrator to approval.

Authentication

Authentication is required to access this API*. You'll need to provide an API key/token in the request headers.

API Endpoint

The create new card program API endpoint is:

http://api-dev.accelerationcloud.com/api/v1/cores/card-issue/card-programs

HTTP Method

Use the HTTP POST method to initiate a new card program.

Request Headers

Include the following headers in your API request:

Authorization: Provide your API key/token for authentication.
Content-Type: Set this to application/json to indicate the request body format.

Request Body

The request body should be a JSON object with the following fields:

  • program_name: The name of the card program.
  • card_type: An array specifying the supported card types with their respective features.
  • currency: The currency in which fees are charged.
  • target_audience: A description of the target audience for the card program.
  • program_start_date: The start date of the card program.
  • program_expire_date: The expiration date of the card program.
  • mobile_available: Indicates whether a mobile app is available for the card program.
  • minimum_credit_score: The minimum credit score required for eligibility.

Example request body:

{
  "program_name": "PlatinumCardProgram",
  "card_type": "Debit",
  "currency": "USD",
  "target_audience": "Premium Customers",
  "program_start_date": "2023-01-01",
  "program_expire_date": "2038-12-31",
  "network": "VISA",
  "mobile_available": "true",
  "minimum_credit_score": "650"
}

Response Format

The response will be in JSON format and will include information about the cancellation request status.

Example response:

{
  "status": "pending_approval",
  "id":"a365x00627112",
  "create_date":"",
  "program_name": "PlatinumCardProgram",
  "card_type": "Debit",
  "currency": "USD",
  "target_audience": "Premium Customers",
  "program_start_date": "2023-01-01",
  "program_expire_date": "2038-12-31",
  "program_start_date": "VISA",
  "mobile_available": "true",
  "minimum_credit_score": "650"
}

Error Handling

In case of errors, the response will include error information, such as error codes and messages. Refer to the Error Handling section in the Developer Portal for details on error codes and their meanings.

Rate Limits

The API has rate limits to prevent abuse