Bulk Card Order API

The Bulk Card Order API processes orders through its endpoint, generating personalized files based on the provided data. The API facilitates seamless order handling and the dynamic creation of personalized files in response to incoming requests.

Environment


Sandbox	https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/issuance/v1/cards/order
Production	Contact your WIBMO KAM or support.

Sample request

curl --request POST \
     --url https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/issuance/v1/cards/order \
     --header 'X-Consumer-Custom-ID: F42BC4E7B801C834B630DE498473533F' \
     --header 'bankId: 6060' \
     --header 'clientId: 1060' \
     --header 'content-type: application/json' \
     --header 'entityId: 100' \
     --header 'secureCode: pu8gSMLNE7pNv36IlUmstU' \
     --header 'x-api-key: 4A02C4267C9A97A1488AB3259FD1A725' \
     --data '
{
  "token": "3Q0dOvrhH5Ae97TDWhp/ZJ61YyhW/8q2fpE93WQWeNm+rSW7gJtwtxykXw+WhY46p/vRBRluijdvVDTmegWbdn4gkVqwCgDLjX9gGDOaDEaFdYdXmCjp/D5flamNTeDgZk7AhebphjnAAuFJQaSt6AonxEJAu+sDP4dbw4r0WYqHK1mRDlex41edf6alDswjMnm8YVVB7fCRdF7M+bdX92B3BpNC4j3n/3x/Aoq7jo4mgfDn0p71aFDX0om/4EosRMSr13F+er38XCXhIZ8h8BxFuAv00moXR0TLUl8ekRke/FPYkgMDHN9tQ2qCba8iIU6tqWbO8h6xw/4CTKzxdiSh1VZxD1wGFCUkn13I6Z+2aPbrctOpVLan3HNAd9nFaeg38cx7VfxFjuyRPTIGReqOSJrgu3G7/brs7ndaR2iAhtGJDwh2ZJtdUF0xQEEb54nTPBFnXvCI8EfdiXDMnOoHjsEhUD2+2e0FV3+u48ZQiNjEN0gPvJaltwMnT4tKOEs8yWAk94mDIy/DP0eLoH/k932Q6UHHJfsSiJ+uRRgRBGGwD4OndZwSCKey1/uv5rwe1kbpA1PAhqx0nCymR0SK9z6i1ZyXoD07gm69iy+4pnOT/yOWvrPh3k4lO0NA"
}
'

Response parameters (Decrypted)

This API will provide a token in the response that must be decrypted using the Decrypt API. The decrypted response is similar to the following:

Attribute	Type	Parameter Requirement	Description
messageCode	numeric(4)	Mandatory	API response identifier
clientTxnId	string(100)	Mandatory	Echoed from the request.
bankId	Numeric(4)	Mandatory	Echoed from the request header.
clientId	String(15)	Mandatory	Echoed from the request header.
responseDateTime	numeric(14)	Mandatory	Response date time in the format YYYYMMDDHHMMSS with time in 24-hour format
responseCode	string(4)	Mandatory	Represents the status of the transaction.
responseMessage	string(100)	Mandatory	Response message based on the response code.
orderId	Numeric	Mandatory	Unique order ID generated.
programId	String	Mandatory	Product ID aka Program ID. Wibmo to share.
entityType	String	Mandatory	Echoed from the request.
noOfCards	String	Mandatory	Echoed from the request.
deliveryAddress	Object	Mandatory	Echoed from the request.
requestorId	String	Optional	Echoed from the request.
requestorContact	String	Optional	Echoed from the request.

Sample response (Decrypted)

{
	"responseCode": "00",
	"messageCode": 3601,
	"clientTxnId": "dfsdf0000dfsdfsd2402",
	"clientId": "1040",
	"responseDateTime": "20240103155004",
	"responseMessage": "SUCCESS",
	"bankId": 6010,
	"programId": "60",
	"noOfCards": "10",
	"orderId": "439",
	"entityType": "agent",
	"deliveryAddress": {
		"address1": "Room- No.421,",
		"address2": "Apt 4B",
		"city": "NewYork",
		"state": "NY",
		"country": "USA",
		"zipCode": "10001"
	},
	"requestorId": "10",
	"requestorContact": "919140593787"
}

Error codes

Error Code	Description
00	SUCCESS
1031	INVALID BANK ID
1032	INVALID CLIENT CHANNEL
1049	INVALID SECURE CODE
1052	SYSTEM ERROR
1056	INVALID MESSAGE CODE
1081	OPERATION NOT ALLOWED
1088	INVALID DATE FORMAT
1093	INVALID CLIENT TXN ID
5003	BANK ID NOT WITH CLIENT
8014	INVALID ADDRESS LINE1
8015	INVALID ADDRESS LINE2
8017	INVALID CITY
8018	CITY IS MANDATORY
8019	INVALID STATE
8020	STATE IS MANDATORY
8021	INVALID COUNTRY
9313	ADDRESS LINE1 CANNOT BE BLANK
9316	COUNTRY CANNOT BE BLANK
9343	CLIENT TXN ID IS MANDATORY
9346	ENTITY TYPE IS MANDATORY
9347	INVALID ENTITY TYPE
9348	NO OF CARDS IS MANDATORY
9349	INVALID NO OF CARDS
9350	INVALID REQUESTOR ID
9351	CARD TYPE IS MANDATORY
9352	INVALID CARD TYPE
9353	COMMENTS LENGTH EXCEEDED
9354	RESERVED FIELD LENGTH EXCEEDED
9355	PERSO VENDOR IS MANDATORY
9356	INVALID PERSO VENDOR
9357	PERSO TEMPLATE IS MANDATORY
9358	INVALID PERSO TEMPLATE
9359	ADDRESS IS MANDATORY

Request parameters