收款 (Payment)
接口说明
收款作为商户发起收款业务场景的入口，由商户服务端向Paynicorn发起收款请求，Paynicorn会根据的参数封装支付方式列表，并返回收银台链接或者直接发起支付
接口地址
https://api.paynicorn.com/trade/v3/transaction/pay
请求参数
字段填写要求 M:mandatory 必填，O：optional 条件选填
| 字段名 | 类型 | 填写要求 | 描述 |
|---|---|---|---|
| amount | String(32) | M | 本币最小单位，保留两位小数，参见附录 国家币种对照表 |
| countryCode | String(2) | M | 国家代码(CountryCode)，参见附录 国家币种对照表 |
| orderId | String(64) | M | 唯一请求流水号，幂等处理依据，同一个流水号重复请求会被拒绝 |
| orderDescription | String(1024) | M | 交易描述 |
| currency | String(3) | M | 币种代码(CurrencyCode)，参见附录 国家币种对照表 |
| referenceNo | String(32) | O | 原始票据单号，支付关联业务的唯一凭证，支付成功后回调回包含该字段 |
| payMethod | String(64) | O | 支付方法编码，指定则使用该支付方法，不进入paynicorn收银台，不指定则进入paynicorn收银台选择支付方法 参见附录 支付方法列表 |
| language | String(8) | O | 预设收银台语言，不传就使用系统语言 |
| cpFrontPage | String(1024) | O | 前端接受支付结果页地址，如提供，支付完成后，页面会自动重定向到该地址 |
| palmAuthCode | String(8) | O | 通过PalmID授权认证,提供授权支付功能.(需要:1 集成PalmID, 2 联系Paynicorn运营人员开通授权支付权限) |
| String(128) | O | 用户邮箱，如提供，则需要使用用户邮箱的渠道会直接使用提供的邮箱，跳过用户填写邮箱页面 | |
| phone | String(32) | O | 用户手机号 (不含国家区号)，如提供，则需要使用用户手机号码的渠道会直接使用提供的手机号，跳过用户填写手机号页面 |
| cnic | String(32) | O | 巴基斯坦支付特有字段，巴基斯坦电子身份证号码 |
| payByLocalCurrency | Boolean | O | 是否采用本地币支付,默认为false,当为true并且currency不是countryCode本地币种的时候会尝试将非本地币转为本地币进行支付 |
| memo | String(1024) | O | 扩展信息 (存放JSON字符串)，paynicorn不做处理，回调透传 |
响应参数
| 字段名 | 类型 | 备注 |
|---|---|---|
| code | String(16) | 状态码参见 状态码 |
| message | String(256) | 消息参见 状态码 |
| txnId | String(64) | 交易单号 |
| status | String(2) | 订单状态(1:成功；-1：处理中；0：失败) |
| webUrl | String(64) | H5支付地址 |
info
针对收款接口，可以通过传入payMethod 指定该次支付使用的支付方式，跳过 Paynicorn 收银台选择支付方式的页面
PAYNICORN的收银台 建议商户都用手机浏览器加载打开 不要用WEBVIEW加载 否则WEBVIEW页面跳转的功能需要商户进行适配
如果该支付方式需要用户的手机号码，可以通过 phone 传入手机号码，跳过 Paynicorn 收银台的输入手机号码页面
通过提供相应的参数，可以跳过 Paynicorn 收银台的 Web 页面，直接发起相应支付，在这种情况下，Paynicorn 响应参数中的 webUrl 为空，商户可以自行实现相关的前端页面
具体支持的支付方法以及相关方法需要传入的参数可以参考 支付方法列表