统一退款

开发中

POST

/api/refund/refundOrder

商户业务系统通过统一退款接口发起退款请求，支付网关会根据商户发起的支付订单号，找到对应到支付通道发起退款。
请求类型：application/json 或 application/x-www-form-urlencoded
文档地址：https://ndpay.qyyapp.com/api/2.%E9%80%80%E6%AC%BE%E6%8E%A5%E5%8F%A3/1.html

请求参数

Body 参数application/json

mchNo

string

商户号

必需

appId

string

应用ID

必需

payOrderId

string

可选

支付中心生成的订单号，与mchOrderNo二者传一即可

mchOrderNo

string

可选

商户生成的支付订单号，与payOrderId二者传一即可

mchRefundNo

string

商户生成的退款单号

必需

refundAmount

string

退款金额

必需

currency

string

必需

三位货币代码,人民币:cny

refundReason

string

退款原因

必需

clientIp

string

客户端IPV4地址

可选

notifyUrl

string

可选

退款完成后回调该URL,只有传了该值才会发起回调

channelExtra

string

可选

特定渠道发起的额外参数,json格式字符串.详见渠道参数说明

extraParam

string

可选

商户扩展参数,回调时会原样返回

reqTime

string

必需

请求接口时间,13位时间戳

version

string

必需

接口版本号，固定：1.0

sign

string

必需

签名值，详见签名算法 https://ndpay.qyyapp.com/api/rule.html

signType

string

必需

签名类型，目前只支持MD5方式

示例

{
  "mchNo": "string",
  "appId": "string",
  "payOrderId": "string",
  "mchOrderNo": "string",
  "mchRefundNo": "string",
  "refundAmount": "string",
  "currency": "string",
  "refundReason": "string",
  "clientIp": "string",
  "notifyUrl": "string",
  "channelExtra": "string",
  "extraParam": "string",
  "reqTime": "string",
  "version": "string",
  "sign": "string",
  "signType": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://pay.jeepay.vip/api/refund/refundOrder' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mchNo": "string",
    "appId": "string",
    "payOrderId": "string",
    "mchOrderNo": "string",
    "mchRefundNo": "string",
    "refundAmount": "string",
    "currency": "string",
    "refundReason": "string",
    "clientIp": "string",
    "notifyUrl": "string",
    "channelExtra": "string",
    "extraParam": "string",
    "reqTime": "string",
    "version": "string",
    "sign": "string",
    "signType": "string"
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

获取渠道用户ID

查询订单