交易退款

介绍

商家已支付成功的交易进行退款操作,支持部分退款。

请求地址

POST

https://pay.scanforpay.com/api/common/refund
业务请求数据
名称 参数名 数据类型 必填 说明
商户订单号 partnerOrderNo String (32) Y 由商户生成
20180802100000001
退款订单号 refundNo String (32) Y 由商户生成
退款金额 orderAmount int Y 交易币种的最小单位
如果商家币种是人民币,则100表示100分=1元;如果商家币种是日元,则100表示日元的 100元
操作员 operatorId String(20) N 100001
终端编号 terminalNo String(20) N 100002
请求示例
{
    "request": {
        "header": {
            "requestTime": "2018-07-25T18:06:05+08:00",
            "partnerNo": "10001",
            "signType": "SHA256",
            "version": "1.0",
            "reqMsgId": "fd03f269-3180-4575-8af0-8f6cf324fb0f"
        },
        "body": {
            "partnerOrderNo": "p20180725180605466813",
            " refundNo ": "201807251800023",
            "orderAmount": 100,
            "operatorId": "211918",
            "terminalNo": "123456",
        }
    },
    "signature": "2d2d5c66a67a24b5e13705cc38f34d93c395a7d9e0e4ff9425c9ce07b806a1cc"
}
响应数据
名称 数据标识 数据类型 必填 说明
响应码 code int(5) Y 1:成功 其他为交易失败
响应信息 msg varchar (100) Y 响应信息
退款金额 orderAmount int Y 交易币种的最小单位
如果商家币种是人民币,则100表示100分=1元;如果商家币种是日元,则100表示日元的 100元
退款状态 status int Y 0:处理中
1:退款成功
2:退款失败
退款币种 currency varchar(5) Y JPY
响应示例
成功响应实例
{
    "response": {
        "header": {
            "partnerNo": "10001",
            "respTime": "2018-07-25T18:06:12+08:00",
            "signType": "SHA256",
            "version": "1.0",
            "reqMsgId": "213ca19e-c75f-450d-9acf-46e860570bb9"
        },
        "body": {
            "code": 1,
            "msg": "success",
            "orderAmount ": 100,
            "status": 1,
            "currency": "JPY"
        }
    },
    "signature": "0710b2630b467c14b3d54295def7f89be61097c21472547823b43c58f3466b08"
}
失败响应实例
{
    "response": {
        "header": {
            "partnerNo": "10001",
            "respTime": "2018-07-25T17:37:14+08:00",
            "signType": "SHA256",
            "version": "1.0",
            "reqMsgId": "c11fe1c7-069b-4399-be00-31830a5de63d"
        },
        "body": {
            "code": 30
            "msg": "订单不存在",
        }
    },
    "signature": "5719065ecea463366cbf39b728b9b8cba940365c0c053dd96effde57f7edc1f8"
}

results matching ""

    No results matching ""