📘
Header Parameters
For Header references Click here

Request Parameters

Name	Type	Mandatory (M), Optional (O)	Description
oldKitNumber	String	M	Kit Number of the Old Card
oldShortCardNumber	String	M	Last Four Digit of the Old Card
newKitNumber	String	M	Kit Number of the New Card
newShortCardNumber	String	M	Last Four digit of the New Card
iPin	String	M	Instantpay 4 Digit Security Pin

Sample Request

curl --location --request POST 'https://api.instantpay.in/cards/gift/replace' \
--header 'X-Ipay-Auth-Code: {{authCode}}' \
--header 'X-Ipay-Client-Id: {{clientId}}' \
--header 'X-Ipay-Client-Secret: {{clientSecret}}' \
--header 'X-Ipay-Endpoint-Ip: {{endPointIP}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "oldKitNumber" : "3**0000005",
    "oldShortCardNumber" : "0**0",
    "newKitNumber" : "31***00006",
    "newShortCardNumber" : "0**8",
    "iPin" : "**17"
}'

POST /cards/gift/replace HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: {{authCode}}
X-Ipay-Client-Id: {{clientId}}
X-Ipay-Client-Secret: {{clientSecret}}
X-Ipay-Endpoint-Ip: {{endPointIP}}
Content-Type: application/json

{
    "oldKitNumber" : "3**0000005",
    "oldShortCardNumber" : "0**0",
    "newKitNumber" : "31***00006",
    "newShortCardNumber" : "0**8",
    "iPin" : "**17"
}

Response Parameters

Name	Type	Description
statuscode	String	InstantPay Status Code
actcode	String	Action Code
status	String	Status Message
data	Array	Response Data (If Present)
timestamp	String	Current time (YYYY-MM-DD HH:II:SS)
ipay_uuid	String	Request Reference Number
orderid	String	Transaction Id ( If transaction otherwise it is null )
environment	String	Live/Sandbox

Sample Response

{
    "statuscode": "TXN",
    "actcode": null,
    "status": "Card successfully replaced",
    "data": null,
    "timestamp": "2022-02-23 16:49:56",
    "ipay_uuid": "**********-****-****-****-**********",
    "orderid": null,
    "environment": "LIVE",

}

200200

400400