Callback notification interface (customized by the merchant)

POST

notifyUrl

Signature rules: After converting the request parameters to JSON (parameters are ordered), the obtained signature is placed in the header, and the signature is obtained directly from the response header. The signature verification method uses verifyEcdsaSignature() in the tool class.

This interface is implemented by the merchant. After receiving our callback, it has nothing to do with the business status. Once you receive our notification, please return the string OK. There is no need to return JSON format data. The merchant guarantees the idempotence of the business. Multiple notifications are only processed once.

Request

Header Params

Body Params application/json

Example

{
    "bizType": 2,
    "currency": "KRW",
    "failReason": "payment failed",
    "fee": "6973",
    "mchNo": "M1696154848",
    "mchOrderNo": "1184196902791413760",
    "orderAmount": "31500",
    "payAmount": "31500",
    "payOrderId": "P1734517376779485186",
    "state": 3
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'notifyUrl' \
--header 'X-RESP-SIGNATURE: 3046022100ae8634a9db66c069030483012e7d0e38ebca6d924b82d8bb2e240764dafeb4f3022100ba3e3bd90346652e681b4b1b25e55d983002d84160fb9c696fb20ea3e4742e76' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bizType": 2,
    "currency": "KRW",
    "failReason": "payment failed",
    "fee": "6973",
    "mchNo": "M1696154848",
    "mchOrderNo": "1184196902791413760",
    "orderAmount": "31500",
    "payAmount": "31500",
    "payOrderId": "P1734517376779485186",
    "state": 3
}'

Responses

🟢200成功

application/json

Body

Example

OK

Modified at 2025-08-20 11:23:58

Query balance