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.

Sandboxpayusandbox-kong.pc.enstage-sas.com/api/v2/encrypt
ProductionContact your WIBMO KAM or support.

Request Parameters

ParameterTypeParameter RequirementDescription
messageCodenumeric (4)MandatoryAPI Unique IDentifier.

3620
clientTxnIdstring (100)MandatoryUnique ID generated by the calling application for each API request.
requestDateTimenumeric (14)MandatoryRequest local timestamp in YYYYMMDDHHMMSS with time in 24-hour format.
customerIdstring(20)conditionalUnique identifier for the customer.
cardUrnnumeric(11)MandatoryUnique reference number for the customer’s card.
programIdnumeric (5)MandatoryUnique Program or Product ID where the customer will be enrolled. Wibmo to share.
nameOnCardstring(50)MandatoryName to be printed on the physical card.
cardFeestring(12)MandatoryDefault value 0
address.namestring (50)MandatoryAddress of the customer.
address.addressLine1string (200)MandatoryAddress Line 1 of the customer.
address.citystring (50)MandatoryCity of the customer. (Only a-z A-Z and no spaces)
address.statestring (50)Mandatorystate of the customer. (Only a-z A-Z and with spaces)
address.countrystring (12)MandatoryCountry of the customer.
address.zipCodestring (15)MandatoryValid PIN/Zipcode
reserveField1string(50)OptionalReserve field1
reserveField2string(50)OptionalReserve field2
reserveField3string(50)OptionalReserve 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",
    "cardTheme": "Blue",
    "cardFee": "0"
}
'

Sample response

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

Error codes

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