m2pfintech
API LibraryCard Order Management

Create Card Order With File Upload For PGK Kits

Creates a new card order with file upload for PGK (Pre-Generated Kit) cards. This API is similar to the standard card order creation but includes a fileName field referencing a previously uploaded file via the uploadFile endpoint. The file contains pre-generated card data that will be used for the order. Use the uploadFile endpoint first to upload the file, then reference its name in this request.

POST
/card-order/withFile

Authorization

tenantAuth
tenant<token>

The DCMS tenant name for multi-tenant isolation. Every API call must include this header to identify the client organization.

In: header

Header Parameters

tenant*string

The DCMS client or tenant name for multi-tenant isolation.

Request Body

application/json

orderId?string

Unique order identifier.

fileName?string

Name of the previously uploaded file to associate with this order.

branchInfo?object

Branch details for the order (same structure as card-order).

address?string

Delivery address with fields separated by tilde (~).

pinCode?string

Postal code for delivery.

orderingPartyInfo?object

Details about who placed the order.

metaValues?object

Custom metadata key-value pairs.

processStartTime?string

Scheduled processing start time.

validity?integer

Order validity period in days.

products?array<unknown>

List of products to order (same structure as card-order).

Response Body

application/json

curl -X POST "https://api.dcms.example.com/v1/card-order/withFile" \  -H "tenant: ACME_BANK" \  -H "Content-Type: application/json" \  -d '{}'
{
  "result": "success",
  "exception": null,
  "pagination": null
}

Create Card Order for DC Kits POST

Creates a new card order without file upload for debit card (DC) kits. Allows branch users to place bulk card orders by specifying branch details, product information, delivery preferences, and scheduling. The order supports multiple products with different BINs and configurations. Each product can have its own quantity, plastic code, PAN length, and PIN generation settings. The order goes through processing stages including RECEIVED, PENDING, PROCESSED, and may end in SUCCESS or FAILED.

Get Card Order Status POST

Retrieves the current status of a card order including details about each product in the order. Shows the overall order status as well as individual product-level statuses. Common statuses include PENDING, PROCESSED, SUCCESS, and FAILED.