Credit Card Bill Payment API allows individuals and businesses to make credit card bill payments electronically, without the need for physical cash or cheque payments. Instantpay Credit Card Bill Payment API offers a secure and convenient way to make credit card payments. We accepts all Visa, Master, Diners & Amex card.
Header Parameters
| Name | Type | Description | Mandatory (M) , Optional (O) | Provided by INSTANTPAY (Y/N) |
|---|---|---|---|---|
| X-Ipay-Auth-Code | String | Auth Code -1 (Fixed) | M | Y |
| X-Ipay-Client-Id | String | Unique Client ID | M | Y |
| X-Ipay-Client-Secret | String | Unique secret key | M | Y |
| X-Ipay-Endpoint-Ip | String | End Customer IP Address | M | N |
Info :
Click Here to know how to get the Credentials.
Request Parameters
| Parameter Name | Type | Requirement | Description |
|---|---|---|---|
| payer | Array | Mandatory | Payer details |
| payer.bankProfileId | String | Mandatory | Bank Profile Id will be 0 |
| payer.accountNumber | String | Mandatory | Instantpay Registered Mobile Number |
| payee | Array | Mandatory | Payee details |
| payee.name | String | Mandatory | Account Holder Name |
| payee.accountNumber | String | Mandatory | Credit Card Number in aes-256-cbc encryption |
| transferMode | String | Mandatory | Modes Will be CREDITCARD |
| transferAmount | String | Mandatory | Amount to be transferred |
| externalRef | String | Mandatory | Your unique transaction Id |
| latitude | String | Mandatory | End Customer Latitude. |
| longitude | String | Mandatory | End Customer Longitude. |
| Remarks | String | Optional | Payment Remarks |
| alertEmail | String | Optional | Email of the end user. If passing the email, then Instantpay will send the email notification. |
Sample Request
curl --location --request POST 'https://api.instantpay.in/payments/payout' \
--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 '{
"payer": {
"bankProfileId": "0",
"accountNumber": "7428585742"
},
"payee": {
"name": "Instantpay India Ltd",
"accountNumber": "L3SdKhkUvb18gqdhXcQ0WMlL7qYny3azGcqyQh+dFs/ZZny2WNiY/dZ1GE2ZGN/i",
},
"transferMode": "CREDITCARD",
"transferAmount": "1.00",
"externalRef": "BILLPAY1",
"latitude": "20.1236",
"longitude": "78.1228",
"remarks": "Credit Card BILL",
"alertEmail": ""
}'
POST /payments/payout 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
{
"payer" : {
"payer": {
"bankProfileId": "0",
"accountNumber": "7428585742"
},
"payee": {
"name": "Instantpay India Ltd",
"accountNumber": "L3SdKhkUvb18gqdhXcQ0WMlL7qYny3azGcqyQh+dFs/ZZny2WNiY/dZ1GE2ZGN/i",
},
"transferMode": "CREDITCARD",
"transferAmount": "1.00",
"externalRef": "BILLPAY1",
"latitude": "20.1236",
"longitude": "78.1228",
"remarks": "Credit Card BILL",
"alertEmail": ""
}
Response Parameters
| Parameter Name | Type | Description |
|---|---|---|
| statuscode | String | InstantPay Status Code |
| actcode | String | Action Code |
| status | String | Status message |
| data | Array | Response Data (If Present) |
| timestamp | String | Response 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 |
| internalCode | String | It will be null |
Sample Response
{
"statuscode": "TXN",
"actcode": null,
"status": "Transaction Successful",
"data": {
"externalRef": "TX1223323",
"poolReferenceId": "1211112165649WFTYK",
"txnValue": "4.00",
"txnReferenceId": "00",
"pool": {
"account": "7428585742",
"openingBal": "3697.27",
"mode": "DR",
"amount": "9.90",
"closingBal": "3687.37"
},
"payer": {
"account": "7428585742",
"name": "Sample Store"
},
"payee": {
"account": "3798XXXXXXXX2004",
"name": "Instantpay India Ltd"
}
},
"timestamp": "2022-03-15 18:08:13",
"ipay_uuid": "h00595d34e99-1646-4838-93bc-8ab6ca4d8f06",
"orderid": "1211112165649WFTYK",
"environment": "LIVE",
"internalCode": null
}
Note :
1 - Latitude and Longitude must be represented in degrees with 4 digits after decimal.
2- externalRef must be unique and in alpha numeric characters.
3- Remarks should be in alphabet and it can be of maximum 20 characters.
4- Consider the Transaction as Pending when you get No Response or Timeout Response and then check the status of the transactions through Transaction Status API.
Note :
Before initiating Credit Card Payment verify the card details through Card BIN Checker API. Click Here for API Documents.
Encryption of Card number should be done in aes-256-cbc encryption using the encryption key which you will get from the credentials page.