Set Physical Card Pin


Header Parameters

For Header Reference Click here

Request Parameters

NameTypeMandatory (M) , Optional (O), Conditional (C)Description
kitNumberStringMKit number of physical card
cardPinStringOEncrypted New PIN Number
cardExpiryStringOEncrypted Card expiry in MM/YY
otpStringC6 digit number. In the first case this field is not mandatory . If a customer received OTP then send the same the request again.

Sample Request

curl --location '' \
--header 'X-Ipay-Auth-Code: 1' \
--header 'X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=' \
--header 'X-Ipay-Client-Secret: 679db35f926b8d0240a8c0d28729528ee8e6d5effa5fa0b20c04454004d2d825' \
--header 'X-Ipay-Endpoint-Ip:' \
--header 'X-Ipay-Request-Hash: 123456789|123456789|123456789|123456789|123456789|123456789|1234' \
--header 'X-Ipay-Request-Timestamp: 1631081674077' \
--header 'X-Ipay-Hash-Check: OFF' \
--header 'User-Agent: InstantPayAPITest/1.0.0' \
--header 'Content-Type: application/json' \
--data '{
    "kitNumber": "1700025373",
    "cardPin": "72y987/jdfgujbhj30",
    "cardExpiry": "04/26"
POST /cards/prepaid/setPhysicalCardPin HTTP/1.1
X-Ipay-Auth-Code: {{authCode}}
X-Ipay-Client-Id: {{clientId}}
X-Ipay-Client-Secret: {{clientSecret}}
X-Ipay-Endpoint-Ip: {{endPointIP}}
Content-Type: application/json

    "kitNumber": "1700025373",
    "cardPin": "72y987/jdfgujbhj30",
    "cardExpiry": "04/26"


Response Parameters

For Response Reference Click here

Sample Response

   "statuscode": "TXN",
   "actcode": null,
   "status": "PIN Successfully Changed",
   "data": null,
   "timestamp": "2023-04-24 21:56:20",
   "ipay_uuid": "h0059be29cf0-9bc1-49ed-86bd-36ca6d0f6ed9-LmzZmBCOb7tc",
   "orderid": "1230424215619QEDEL",
   "environment": "LIVE",
   "internalCode": null



Action Code Details

For Action Code details Click here

Click Try It! to start a request and see the response here!