Payment Notify Request

POST

merchant_url

📌

Use this API to receive payment status notifications from Enkash. You must develop this API on your backend to handle incoming payment updates (such as success or failure). Provide the endpoint URL in the Create Order API so Enkash can notify your system when the payment status changes.

Request

Body Params application/json

Example

{
    "surcharge": 0.0000,
    "surchargeGst": 0.0000,
    "amount": "500.00",
    "finalAmount": "500.00",
    "paymentMode": "PREPAID_CARD",
    "bankCode": null,
    "bankName": null,
    "cardScheme": null,
    "currency": "INR",
    "checksum": null,
    "status": "SUCCESS",
    "transactionId": "EK1738916997652yh8GL",
    "txnMsg": "Transaction successful.",
    "txnDate": "2025-02-07 14:00:05",
    "uniqueTransactionId": "EK66674UU7T",
    "maskedCardNumber": "XXXX XXXX XXXX 9015",
    "cardHolderName": "NA",
    "paymentToken": "9ceac38e65db443d5f48",
    "bankTransactionId": null,
    "mdr": null,
    "mdrGst": null,
    "transactionAmount": null,
    "orderId": null,
    "orderStatus": null,
    "transactionStatus": null
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://test.your-api-server.commerchant_url' \
--header 'Content-Type: application/json' \
--data-raw '{
    "surcharge": 0.0000,
    "surchargeGst": 0.0000,
    "amount": "500.00",
    "finalAmount": "500.00",
    "paymentMode": "PREPAID_CARD",
    "bankCode": null,
    "bankName": null,
    "cardScheme": null,
    "currency": "INR",
    "checksum": null,
    "status": "SUCCESS",
    "transactionId": "EK1738916997652yh8GL",
    "txnMsg": "Transaction successful.",
    "txnDate": "2025-02-07 14:00:05",
    "uniqueTransactionId": "EK66674UU7T",
    "maskedCardNumber": "XXXX XXXX XXXX 9015",
    "cardHolderName": "NA",
    "paymentToken": "9ceac38e65db443d5f48",
    "bankTransactionId": null,
    "mdr": null,
    "mdrGst": null,
    "transactionAmount": null,
    "orderId": null,
    "orderStatus": null,
    "transactionStatus": null
}'

Responses

🟢200Success

application/json

Body

Example

{}

Modified at 2025-10-07 10:51:20

All Merchant Settlement Transactions