API - 退款查询

GET

/v3/merchants/<merchant_id>/refunds/<merchant_transaction_id>

提示

该接口提供退款订单结果的查询，商家可以通过该接口主动查询订单状态，完成下一步的业务逻辑。

签名构建因子为 merchant_id，merchant_transaction_id;
访问时需要将<merchant_id>替换为商户号，<merchant_transaction_id>替换为商户支付交易ID；

环境域名地址

生产环境：https://gpapi.lianlianpay.com/v3/merchants/<merchant_id>/refunds/<merchant_transaction_id>
沙箱环境：https://celer-api.LianLianpay-inc.com/v3/merchants/<merchant_id>/refunds/<merchant_transaction_id>

接口协议结构体

详情可查看请求与响应结构

常见请求示例

https://gpapi.lianlianpay.com/v3/merchants/202103310000001001/refunds/20200808000000008

参数名	类型	示例值	说明
merchant_id	string	202103310000001001	商户号
merchant_transaction_id	string	20200808000000008	商户退款交易ID

请求参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://celer-api.LianLianpay-inc.com/v3/merchants/<merchant_id>/refunds/<merchant_transaction_id>' \
--header 'signature: XJqQTCs1QTsp+xO3iWrEMhMZUF9Wt+s2XTilT48lyv3zCmJS1+twA9cYsq9Bg9hfTnOFziCaU0OD3ddYWTMRf13uyLjwwOKD6LWyBCd+17Fq4bBdFcCwiuA6ZUkXbIWKiLACf8gY0JkKpuEvXSSrvHcpS9MPakuXKKwOBRY1UXBhWr2bL3qr8r4bLUk1A3 5ZU7Oj5r2xZV3JrdeFYqBLss1jbXNT9bS4J5JFoFKw/xBzoBkYh7btm28b8i8Q5lY2Vu7vZVK+BGKfBff2PQOJ347VGyR3+ch4qrw0ABRC52jEycWWoGQbnzs6W8DwBGg64/aR7GpNz9sHIy6YW8KwZg==' \
--header 'timezone: Asia/Hong_Kong' \
--header 'timestamp: 20211022160000'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

成功示例异常示例

{
    "return_code": "SUCCESS",
    "return_message": "Success",
    "trace_id": "15005.101.16413498061800009",
    "order": {
        "ll_transaction_id": "202106010096004",
        "merchant_transaction_id": "LLPR202106010096003",
        "original_transaction_id": "202105241431180744",
        "refund_data": {
            "refund_currency_code": "USD",
            "refund_amount": "19.00",
            "settlement_currency_code": "USD",
            "actual_refund_currency_code": "USD",
            "actual_refund_amount": "19.00",
            "refund_status": "RS"
        }
    }
}

API - 退款

API - 支付取消