异步通知接口 (Postback)
接口说明
异步交易结果通知,收款和授权支付不能立即获取交易结果的,在交易状态发生改变的时候,paynicorn会调用商户设置的异步通知结果,将最新的订单状态通知商户服务端。
接口地址
商户提供,通过商户平台配置,参见 设置应用回调地址
请求参数
响应参数
参数名 | 类型 | 填写要求 | 备注 |
---|---|---|---|
txnId | String(64) | M | 支付单号 |
orderId | String(64) | M | 交易流水号 |
amount | String(32) | M | 实际支付金额 |
pricingAmount | String(32) | M | 下单金额 |
currency | String(3) | M | 实际支付币种 |
pricingCurrency | String(32) | M | 下单币种 |
countryCode | String(2) | M | 国家码 |
payMethod | String(32) | O | 支付方式,支付成功状态下会有 |
status | String(4) | M | 支付状态 |
code | String(6) | M | 状态码 |
message | String(256) | M | 消息 |
memo | String(1024) | O | 备注信息 |
referenceNo | String(32) | M | 原始交易凭证 |
警告
商户收到回调通知后,需要按照 Paynicorn 的要求进行响应
HttpsStatus=200代表接受到通知并返回字符串success_{txnId},其他代表通知失败
没有返回success_{txnId}的会继续通知,直到成功,最多7次,通知间隔时间按照10*2^(n-1)递增(单位:分,n代表通知次数),频率是:10min, 20min, 40min, 80min, 160min, 320min