paycools-my
Languages
Languages
  • 简体中文
  • English
Languages
Languages
  • 简体中文
  • English
  1. 5. Refund
  • Merchant Unified API Param
  • API Code Collection
  • Unified API Param
  • 1. Account
    • 1.1 Balance Inquiry
      POST
  • 2. Disbursement
    • Disburse API Supported Types
    • Account Verification Related Enum List
    • 2.1 Account Validation
      POST
    • 2.2 Check Account Validation Order Status
      POST
    • 2.3 Create Payout
      POST
    • 2.4 Check Payout Status
      POST
    • 2.5 Disburse callback notification api
      POST
  • 3. QR Code
    • QR Code Channel Code List
    • 3.1 QR Code Create
      POST
    • 3.2 QR Code Detail
      POST
    • 3.3 QR Code Payment List
      POST
    • 3.4 QR Code Payment Notification
      POST
  • 4. WebPay
    • WebPay Channel Code List
    • 4.1 WebPay Create
      POST
    • 4.2 Retrieve WebPay Status
      POST
    • 4.3 WebPay Payment Notification
      POST
  • 5. Refund
    • Refund Support Channel List
    • Refund Status Enum
    • 5.1 Refund
      POST
    • 5.2 Get Refund Payments
      POST
    • 5.3 Refund Notification
      POST
  1. 5. Refund

5.3 Refund Notification

POST
/callbacks/refund
This endpoint is implemented by the merchant. Its path and server are import placeholders.
param is a JSON-serialized string. The table below describes its decoded logical fields.
Parameter NameRequiredTypeDescription
eventNameYstringEvent name (payment.refund.success, payment.refund.failed, payment.refund.cancel)
mchRefundOrderIdYstringMerchant refund order id (unique for customer) format: letter + num, 1-32 characters: CCP20220428011068111
refundTransactionIdYstringPayCools Refund Transaction ID
originalTransactionIdYstringPayCools Origin Transaction ID
refundAmountYintRefund Amount
feeRefundedYintFee Refunded
refundStatusYstringRefund Status
refundCreateTimeYstringRefund Create Time
refundReturnTimeYstringRefund Return Time
refundReasonYstringRefund Reason
failedCodeNintFailed Code(Value present on failure.)
failedMessageNintFailed Message(Value present on failure.)
Source documentation: https://docs.paycools.com.my/en/refund/RefundCallback.html

请求参数

Body 参数application/json必填

示例
{
    "param": "{\"eventName\":\"payment.refund.success\",\"mchRefundOrderId\":\"18184914989277184\",\"originalTransactionId\":\"CU508022434763373688\",\"refundAmount\":10000,\"feeRefunded\":1000,\"refundCreateTime\":\"2024-07-31 11:38:54\",\"refundReturnTime\":\"2024-07-31 11:38:55\",\"refundStatus\":\"COMPLETE\",\"refundTransactionId\":\"1818491499290169344\"}",
    "sign": "W3j7iWptU5CDfXAAl9URzBzb2NpEaBTP4wnYTsv2XFuN70m+SJnlPVpByM7OR5w/zGQWAzmJGIYgJeNwPQDHzP24MPQDtWjPVIMPvzqlTNC2SKnzbhTPCjt3B8cgLc2o/oBhQ6nA9itk0A9lnhe5ZdOZnbOZmIO9Lq2VTEAG6lda5rEK7ycvGEp0t+MnC5rKYJsKS8OWklnB9oRnxd+vNLw+yOGGIExdn1WFrNnQnsNl86sqx7+NdBu0gK/EEvqhWAW+WronOS5I61ymSKNk4d3IGQxflgCsMsPQRBgU8Q6lnCflci7bMeT2gz3zevPZDXFxbtdg2PkEeWKHBXWg=="
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/callbacks/refund' \
--header 'Content-Type: application/json' \
--data '{
    "param": "{\"eventName\":\"payment.refund.success\",\"mchRefundOrderId\":\"18184914989277184\",\"originalTransactionId\":\"CU508022434763373688\",\"refundAmount\":10000,\"feeRefunded\":1000,\"refundCreateTime\":\"2024-07-31 11:38:54\",\"refundReturnTime\":\"2024-07-31 11:38:55\",\"refundStatus\":\"COMPLETE\",\"refundTransactionId\":\"1818491499290169344\"}",
    "sign": "W3j7iWptU5CDfXAAl9URzBzb2NpEaBTP4wnYTsv2XFuN70m+SJnlPVpByM7OR5w/zGQWAzmJGIYgJeNwPQDHzP24MPQDtWjPVIMPvzqlTNC2SKnzbhTPCjt3B8cgLc2o/oBhQ6nA9itk0A9lnhe5ZdOZnbOZmIO9Lq2VTEAG6lda5rEK7ycvGEp0t+MnC5rKYJsKS8OWklnB9oRnxd+vNLw+yOGGIExdn1WFrNnQnsNl86sqx7+NdBu0gK/EEvqhWAW+WronOS5I61ymSKNk4d3IGQxflgCsMsPQRBgU8Q6lnCflci7bMeT2gz3zevPZDXFxbtdg2PkEeWKHBXWg=="
}'

返回响应

🟢200
application/json
Business result
Bodyapplication/json

示例
{
    "code": 10000,
    "message": "Success"
}
修改于 2026-08-31 11:04:18
上一页
5.2 Get Refund Payments
Built with