Open API
English
  • English
  • 简体中文
API DOC
API DOC
English
  • English
  • 简体中文
English
  • English
  • 简体中文
  1. Asynchronous notification description v2
  • Open API
    • Document Revision History
    • Overview of Study Abroad Payment API Access
    • API Call Address
    • Request for serial number generation instructions
    • API Request Parameter Description
    • API Response Parameter Description
    • Interface encryption and signing steps
    • Interface decryption and verification process
    • Constant Description
      • pay_type description
      • order_status description
      • status_code description
      • fee_type description
      • attachment_type description
      • country_code description
      • currency_code description
      • Gender Description
      • ID type Description
      • Funding Source Description
      • Payer Relationship To Student Description
    • API
      • Order interface
      • Attachment upload interface
      • Interface for obtaining payment address
      • Order batch query interface
      • Get exchange rate interface
      • Obtain estimated amount
      • Refund application interface
    • [Legacy] Asynchronous notification description v1
      • [Successful Payment] Asynchronous notification parameter description for successful payment
      • Explanation of Asynchronous Notification Signature Generation Process
    • Asynchronous notification description v2
      • Asynchronous Notification Description
      • Asynchronous Notification Signature Generation Process
      • [Successful Payment] Asynchronous notification parameter description for successful payment
      • [Order Status Change] Asynchronous notification parameter description for order status change
      • Asynchronous notification of refund result
API DOC
API DOC
English
  • English
  • 简体中文
English
  • English
  • 简体中文
  1. Asynchronous notification description v2

Asynchronous notification of refund result

CAUTION
Please note that the asynchronous notification interface does not use a universal request data template
There are two asynchronous notification modes for refund results:
The first method of calling the refund interface: If the user applies for a refund, the notification service will notify the merchant in real time after the refund is successful/failed.
The second type of ordering interface sends a refund notification address: After the refund is successful, the notification service will notify the merchant in real time.

Request:#

FieldTypeDescRemark
order_idStringOrder IDET Order Id。
refund_order_idStringRefund Order IdMerchant's refund order id, if in the second mode, the refund order number is ET OrderId
refund_resultIntRefund result1 refund successful, 0 refund failed
refund_amountFloatRefund AmountFloating point number, such as 10000.00.
refund_datetimeStringRefund DatetimeString type, such as 2024-01-01 10:00:00.
extend_infoStringExtend InfoReserved for future use
signStringSignatureUse MD5 to generate signatures. For detailed procedures, please refer to the asynchronous notification signature generation process instructions

Sample Request Json:#

{
    "order_id": "ET00000000000000001",
    "refund_order_id": "xxxxxxxxxxx"
    "refund_result": 1,
    "refund_amount": 10000.00,
    "refund_datetime": "2024-01-01 10:00:00",
    "extend_info": "",
    "sign": "xxx"
}

Response:#

FieldTypeDescRemark
order_idStringOrder IdET Order Id。
notify_resultStringnotify resultIf "OK" is returned, the notification is successful and no more notifications are sent. If other result are returned, the notifications continue to be sent.
signStringSignatureUse MD5 to generate signatures. For detailed procedures, please refer to the asynchronous notification signature generation process instructions

Sample Response Json:#

{
    "order_id": "ET00000000000000001",
    "notify_result": "OK",
    "sign": "xxxxxxxx"
}
Modified at 2025-09-17 14:20:38
Previous
[Order Status Change] Asynchronous notification parameter description for order status change
Built with