version | string | Yes | 接口版本 当前值为:1.1 | |
keyVersion | string | Yes | 密钥版本 当前值为:1 | |
requestTime | string | Yes | 请求时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss.SSSXXX 时间需要在当前时间两分钟内 | |
appId | string | Yes | 商户应用Id,PayerMax分配给商户应用的唯一标识 | |
merchantNo | string | No | 商户号,商户与PayerMax业务签约时生成的唯一标识 | |
data | object | Yes | 请求数据体 | |
data.merchantLinkId | string | Yes | 商户链接唯一订单号 | |
data.linkType | string | Yes | 枚举值:ONETIME,当前仅支持ONETIME | ONETIME |
data.expiresTime | string | No | 链接有效时长,单位为秒,最长可30天,默认24h,最小1h | |
data.country | string | Yes | 国家代码,大写字母,如果所传的国家代码与币种不匹配,则以货币代码对应的地区展示收银台。国家上送参见【交易支持国家/地区与币种】 | |
data.currency | string | Yes | 标价币种,大写字母,参见【交易支持国家/地区与币种】 | |
data.totalAmount | string | Yes | 标价金额,金额的单位为元。 除以下国家外,按照各国币种支持的小数点位上送 注意:巴林、科威特、约旦、阿曼、突尼斯,本币只支持两位小数; 印尼、中国台湾、韩国、越南、智利、巴基斯坦、哥伦比亚、日本、冰岛、巴拉圭,本币不支持带小数金额。 | |
data.language | string | No | 链接页面语言,默认英语 | |
data.description | string | Yes | 订单描述,在链接页面展示给用户 | |
data.linkDescription | string | No | 链接描述,不展示给用户,用于商户备注 | |
data.userInfo | object | Yes | 用户信息 | |
data.userInfo.userId | string | Yes | oneTime类可传入,用户在商户侧唯一id | |
data.userInfo.username | string | No | oneTime类可传入,用户姓名 | |
data.goodsDetails | array[object] | Yes | 商品信息,支持传多个。 | |
data.goodsDetails[].goodsName | string | Yes | 商品名称 | |
data.goodsDetails[].goodsDescription | string | Yes | 商品描述。 | |
data.goodsDetails[].quantity | string | Yes | 商品数量 | |
data.goodsDetails[].price | string | Yes | 商品价格,商户系统的报价 | |
data.goodsDetails[].goodsCurrency | string | Yes | 商品报价币种,大写字母。参见【交易支持国家/地区与币种】 | |
data.goodsDetails[].showUrl | string | Yes | 商品展示地址 | |
data.merchantInfo | object | Yes | 链接页面展示商户信息 | |
data.merchantInfo.logoUrl | string | No | 链接页面展示的商户logo图片 | |
data.merchantInfo.contactEmail | string | Yes | 用户联系商户邮箱 | |
data.notifyUrl | string | Yes | 服务端回调通知URL,以http/https开头,可以通过MerchantDashboard平台配置商户通知地址,如果订单中上送,则以此为准 | |