发起退款

正式环境

https://api.diandianpay.com

POST

/api/v1/refund

DianDianPay的退款接口采用异步受理模式。发起退款时没有同步结果，系统只会同步返回 ACCEPTED（已受理）状态。

请求参数

Header 参数

Body 参数application/json

示例

{
    "merchant_id": "1",
    "id": "pi_4nkrKVoo0EuVjEvmCa854q8R",
    // "merchant_order_id":"test_123456",
    "merchant_refund_id": "f79e158a43ff425bacb9593662b04e2f",
    "refund_amount": 264,
    "refund_reason": "test"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.diandianpay.com/api/v1/refund' \
--header 'signature: *********' \
--header 'timestamp: 1743487706607' \
--header 'timezone: Asia/Shanghai' \
--header 'Content-Type: application/json; charset=UTF-8' \
--data '{
    "merchant_id": "1",
    "id": "pi_4nkrKVoo0EuVjEvmCa854q8R",
    // "merchant_order_id":"test_123456",
    "merchant_refund_id": "f79e158a43ff425bacb9593662b04e2f",
    "refund_amount": 264,
    "refund_reason": "test"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "data": {
        "merchant_refund_id": "f79e158a43ff425bacb9593662b04e2f",
        "refund_amount": 5000,
        "refund_id": "2026061518167472230534135463936",
        "result": {
            "result_code": "ACCEPTED",
            "result_status": "S"
        }
    }
}

查询订单

查询退款