Create Card API

The Create Card API to generate a new card and subsequently associate it with a customer account. It leverages the Customer ID parameter to establish the necessary linkage between the newly generated card and the respective customer.

Environment


Sandbox	https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/issuance/v3/createCard \
Production	Contact your WIBMO KAM or support.

Sample request

curl --request POST \
     --url https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/issuance/v3/createCard \
     --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": "TVI6w+zbfFA9pBE4c3zSjyNutEWuwI3MiQ54cvtADERCi7Uq9GECHHEJWlHqlOrjf6fR4YnbUXV6ubofEfJL7RocA2XPyf169Z2Oe2QPnYetvIjMjub40YkenTlAHDY/U1AfnhQ3eiZCQoET+uv3OPupdzXrVdoARbQEixNqR7R8vBQycrVBrBgDT9h1BOf46RG3q+ELnHc9YzH5PIqz23h3Gn35dVO1NoFWW4UhiJHUdEKv/oLKx2fcH731C4QshhWWlFlIKFRw52BWrRJv5nzhg3t6f8QtBan1ndgJDrBwp2zhCc9RLSLXZufEjeZS"
}
'

Response parameters

Attribute	Type	Parameter Requirement	Description
messageCode	Numeric (4)	Mandatory	Code to Identity “Create Card” API response
clientTxnId	String (100)	Mandatory	Echoed from the request.
description	String(100)	Mandatory	Field to send the description of the API.
cardDetailsList.urn	Numeric (12)	Mandatory	A unique reference number for the generated card. This urn is used in place of the actual 16-digit card number created for customer identification.
cardDetailsList. cardCVV2	Numeric (12)	Mandatory	Encrypted CVV
cardDetailsList. cardNumber	String (50)	Mandatory	Masked Card Number
cardDetailsList.cardExpiry	String (100)	Mandatory	Masked expiry of the card

Sample response (Decrypted)

{
	"description": "Card Creation",
	"responseCode": "201",
	"messageCode": 1011,
	"clientTxnId": "CreateCard_20240219101007",
	"clientId": "2030",
	"responseDateTime": "20240219154550",
	"responseMessage": "CARD_CREATED_SUCCESSFULLY",
	"bankId": 7030,
	"cardDetailsList": [
		{
			"urn": 70000001328,
			"cardNumber": "4550XXXXXXXX2606",
			"cardExpiry": "XXXX",
			"cardCVV2": " D5LypgiZjzy3oABrMUxA35q2117nnUeeIzVTT0r/OfU="
		}
	]
}

Error codes

Error Code	Description
1	CARD ALREADY CREATED
201	CARD_CREATED_SUCCESSFULLY
1003	ERROR CARD CREATION
1031	INVALID BANK ID
1032	INVALID CLIENT CHANNEL
1052	SYSTEM ERROR
1056	INVALID MESSAGE CODE
1088	INVALID DATE FORMAT
1093	INVALID CLIENT TXN ID
1093	INVALID CLIENT TXN ID
1275	INVALID CUSTOMER ID
1283	LOGIN SERVICE INTEGRATION CALL FAILURE
1289	PROGRAM_NOT_ALLOWED_FOR_PRODUCT
1293	INVAILD_CARD_STATUS
1320	REQ DATE TIME IS MANDATORY
1366	PROGRAM IS INACTIVE
1501	SYSTEM ERROR
7960	CARD CREATION NOT SUPPORTED
9343	CLIENT TXN ID IS MANDATORY
10239	PRODUCT ID IS MANDATORY
10240	INVALID FIELD NEW CARD STATUS
10099	DATABASE ERROR
303178	REQUEST DATE TIME INVALID LENGTH
303193	BLANK MESSAGE CODE

Request parameters