退款和预授权

交易类型

交易类型	类型描述
REFUND	退款，针对普通交易或是预授权已确认的交易进行退款操作，支持多次退款， 每次退款金额<=当前剩余交易金额
CAPTURE	预授权确认，针对预授权交易进行确认操作，仅支持一次确认，确认金额<= 预授权金额
VOID	预授权取消，针对预授权交易进行取消操作，仅支持单次全额取消，取消金额 =预授权金额

注意 : 在PingPongPay商户后台发起的退款，不会发送退款异步通知。

请求地址

https://{host}/v2/payment/{transactionId}

请求参数

参数字段	参数类型	参数属性	参数说明
transactionId	String(64)	M	PingPong

注意 : 地址参数在加签过程中也需要归入加签串。

参数字段	参数类型	参数属性	参数说明
accId	String(64)	M	PingPong 商户店铺编号
merchantTransactionId	String(64)	M	商户网站交易流水号，每次请求的唯一标识，可用于后续订单查询和对账
paymentType	String(18)	M	交易类型:REFUND-退款 CAPTURE-预授权确认 VOID-预授权取消 APPROVE-审核通过 REJECT-审核拒绝
amount	String(14)	M	交易金额，小数点后保留两位，如 10.12，部分交 易币种如 JPY、KRW 其最小单位为元，也要求上送两位小数，如 29.00
currency	String(3)	M	交易币种，ISO 4217 三位币种，具体支持币种⻅ 附件《交易币种》表
signType	String(8)	M	签名规约，支持 MD5、SHA256，具体⻅本文“签名规约”一栏
sign	String(256)	M	签名内容，具体⻅本文“签名规约”一栏
notificationUrl	String(200)	O	由商户自定义本次交易结果通知的地址，一旦填写该参数，pingpong checkout 将通过 Post 方式异步推送交易结果到该地址
reviewSystem	String(64)	O	审核系统
reviewer	String(64)	O	审核人
reviewComment	String(64)	O	审核备注

响应参数

参数字段	参数属性	参数说明
clientId	M	PingPong
accId	M	PingPong
transactionId	M	PingPong 交易流水号
relateTransactionId	M	当前交易关联的 PingPong 交易流水号
merchantTransactionId	M	商户网站的的交易流水号
code	M	结果状态码
description	M	结果描述
paymentType	M	交易类型: REFUND-退款CAPTURE-预授权确认 VOID-预授权取消 APPROVE-审核通过 REJECT-审核拒绝
currency	M	交易币种
amount	M	交易金额
transactionTime	M	交易发起时间，yyyyMMddHHmmss
completeTime	O	交易处理完成时间，yyyyMMddHHmmss
status	M	SUCCESS-成功 FAILED-失败 PROCESSING-进行中
signType	M	签名规约，支持 MD5、SHA256，具体⻅本文“签名规约” 一栏
sign	M	签名内容
remark	C	商户扩展字段