Encrypt API for Requesting Physical Card

The Encrypt API request parameters varies based on the API with which it is used for. This section describes the Encrypt API used with Request Physical Card API.


Sandbox	payusandbox-kong.pc.enstage-sas.com/api/v2/encrypt
Production	Contact your WIBMO KAM or support.

Request Parameters

Parameter	Type	Parameter Requirement	Description
messageCode	numeric (4)	Mandatory	API Unique IDentifier. 3620
clientTxnId	string (100)	Mandatory	Unique ID generated by the calling application for each API request.
requestDateTime	numeric (14)	Mandatory	Request local timestamp in YYYYMMDDHHMMSS with time in 24-hour format.
customerId	string(20)	conditional	Unique identifier for the customer.
cardUrn	numeric(11)	Mandatory	Unique reference number for the customer’s card.
programId	numeric (5)	Mandatory	Unique Program or Product ID where the customer will be enrolled. Wibmo to share.
nameOnCard	string(50)	Mandatory	Name to be printed on the physical card.
cardFee	string(12)	Mandatory	Default value `0`
address.name	string (50)	Mandatory	Name of the customer.
address.addressLine1	string (200)	Mandatory	Address Line 1 of the customer.
address.city	string (50)	Mandatory	City of the customer. (Only a-z A-Z and no spaces)
address.state	string (50)	Mandatory	state of the customer. (Only a-z A-Z and with spaces)
address.country	string (12)	Mandatory	Country of the customer.
address.zipCode	string (15)	Mandatory	Valid PIN/Zipcode
reserveField1	string(50)	Optional	Reserve field1
reserveField2	string(50)	Optional	Reserve field2
reserveField3	string(50)	Optional	Reserve field3

Sample request

curl --request POST \
     --url https://payusandbox-kong.pc.enstage-sas.com/api/v2/encrypt \
     --header 'content-type: application/json' \
     --header 'x-api-key: 4A02C4267C9A97A1488AB3259FD1A725' \
     --data '
{
    "messageCode": 3620,
    "clientTxnId": "Req_Phy_Card04758474s291ram682",
    "requestDateTime": "20240429120000",
    "customerId": "000000000429",
    "cardUrn": "10000810",
    "programId": "1",
    "address": {
        "name": "Ajay Kumar",
        "addressLine1": "Munnekollal",
        "city": "Bangalore",
        "state": "Karnataka",
        "country": "India",
        "zipCode": "560013"
    },
    "nameOnCard": "Ajay Kumar",
    "cardFee": "0"
}
'

Sample response

{
  "token": "e3ln1sSCTF9rgy9AjN5QNAkJruloChEdm7C39FVnfczb5gfIGv/Vg6iSM0ZmzgSwF64Z7yRQ8C+jmDZEUC2rmuM9CCqk5qMQD/AUI7IrXMnSZFV1rEhbGRMJVg0MGxbAa+7+N+Ea1HZk72TlSxUbZsSeRHedWZ+3GsiqU42TRYwQNl5crWPKxtpXRpv9LudcLo56rL5xtHGrNyIzown1d2ah3Lvo4LAQg+6gEyopi+qt6Fl11MJINPAA50OZ5bUkKz8IZq4lTVEMiF7t4BaSpXjv0/FLDG2C4vGtzqU10lyWd2KC+/SZjIpVLQuP7iIk"
}

Error codes

Error Code	Description
1262	CLIENT ID NOT PRESENT IN THE REQUEST
1264	BANK ID NOT PRESENT IN THE REQUEST
1310	XCONSUMERKEY NOT PRESENT IN REQUEST
1311	SECURE CODE NOT PRESENT IN REQUEST