退款交易

信息

将已结算交易的全部或部分资金退还给持卡人的卡。如果交易尚未结算，请参考撤销。 与撤销不同，退款后，持卡人的账单上将同时记录初始扣款和退款的信息。

端点

https://ccapi.iotpaycloud.com/v3/cc_refund

方法

POST

头部

Content-Type: application/json;charset=UTF-8

请求

名称	必需	类型	示例	描述
mchId	y	String(30)	10000701	由 IOTPay 分配
mchRefundNo	y	String(30)	R1234567890abc	由商户分配的订单号（不可重复）
loginName	y	String(12)	jack_chen	由商户分配的订单号（不可重复），等同于 jobNo
refundAmount	y	Int	100	以分为单位
payOrderId	y	String(30)
sign	y	String(32)	C380BEC2BFD727A4B6845133519F3AD6	签名算法

响应

名称	必需	类型	示例	描述
retCode	y	String	SUCCESS 或 FAIL
retMsg	y	String
retData	y	JSON		如果 retCode=SUCCESS，则返回订单详细信息

retData 包含订单信息:

名称	必需	类型	示例	描述
payOrderId	y	String	RP20240101215009579871439079	由 IOTPay 生成
mchId	y	String	10000701	由 IOTPay 分配
mchOrderNo	y	String	R1234567890abc	由商户分配的订单号（不可重复）的 mchRefundNo
originalOrderId	y	String	PC20240101215009579871439079	退款的原始支付订单 ID
currency	y	String	CAD	仅支持 'CAD'
amount	y	Int	100	以分为单位
payType	y	String	refund	对于成功的退款交易，为 refund
refundable	y	Int	0	退款订单无法再次退款（如果仍然有资金，原始订单仍可以退款）
status	y	Int	0,1,2,9	0 = 待处理订单，1 = 未知，2 = 成功，9 = 失败
paySuccTime	y	String	2021-04-07 19:44:51	支付成功的时间戳
cardNum	y	String	432567******2266	用于交易的卡的卡号
expiryDate	y	String	0725	用于交易的卡的到期日期
invoiceNum	y	String
authNum	y	String
transNum	y	String
channel	y	String	PF_CC	PF_CC 或 UPI_EX