付款产品
更新时间：2024.06.07 06:34:47
付款产品
代付 (Payout)
接口说明
对于已经结算至代付余额的金额，您可以通过代付接口实现转账或申请提现。
请注意：
- 此 API 默认不开通，若需要开通请联系 yong.hang@transsion.com 。
接口地址
https://api.paynicorn.com/trade/v3/transaction/payout
接口参数
字段填写要求 M:mandatory 必填，O：optional 条件选填
| 字段名 | 类型 | 填写要求 | 描述 |
|---|---|---|---|
| orderId | String(64) | M | 商户付款订单号 |
| currency | String(3) | M | 币种代码(CurrencyCode)，参见附录国家币种对照表 |
| amount | String(32) | M | 金额 |
| countryCode | String(2) | M | 国家代码(CountryCode)，参见附录国家币种对照表 |
| payoutMethod | String(64) | M | 转账类型（CARD,MTN,MPESA,PAYNICORNPAY,AIRTEL...） |
| name | String(64) | M | 收款人名字 |
| account | String(64) | M | 收款账户 |
| bankCode | String(64) | O | 银行码(转账类型为银行卡时必填)参见附录银行代码 |
响应参数
| 字段名 | 类型 | 填写要求 | 备注 |
|---|---|---|---|
| code | String(16) | M | 状态码参见 状态码 |
| message | String(256) | M | 消息参见 状态码 |
| status | String(2) | M | 订单状态(-1：处理中；0：失败) |
| txnId | String(64) | O | 交易单号 |
报文示例
Request Body
{
"account": "2254630776",
"amount": "100",
"appKey": "70kP76p4j3894oNO926h",
"bankCode": "NG037", // 银行映射表
"countryCode": "NG",
"currency": "NGN",
"name": "zhang zhongming",
"orderId": "12428512966672483",
"payoutMethod": "CARD"
}
Response
{
"code": "0000",
"message": "success",
"status": "-1", //-1: 退款处理中，1: 退款成功，0：退款失败
"txnId": "62428512966672847"
}
查询交易结果接口 (Query)
接口说明
对于无法及时获得 API 调用结果与 API 调用超时的场景，您可以通过本 API 查询最新的结果。
接口地址
https://api.paynicorn.com/trade/v3/transaction/query
请求参数
字段填写要求 M:mandatory 必填，O：optional 条件选填
| 字段名 | 类型 | 填写要求 | 描述 |
|---|---|---|---|
| orderId | String(64) | M | 商户订单号 |
| txnType | String(8) | M | 交易类型 |
响应参数
| 字段名 | 类型 | 填写要求 | 备注 |
|---|---|---|---|
| code | String(16) | M | 状态码参见 状态码 |
| message | String(256) | M | 消息参见 状态码 |
| txnId | String(64) | M | 交易单号 |
| status | String(4) | M | 支付结果 |
| completeTime | String(16) | O | 交易处理完成时间 |
报文示例
Request Body
{
"appKey": "7971100",
"orderId": "92428512966672483",
"txnType": "payout"
}
Response
{
"code": "0000",
"completeTime": "",
"message": "success",
"status": "-1", //-1: 支付处理中，1: 支付成功，0：支付失败
"txnId": "32428513799242015"
}
本文导读