| 参数名称 |
参数中文名称 |
类型& 长度 |
参数说明 |
是否必填 |
| merchantId |
商户编号 |
varchar(9) |
商户在首信易系统的唯一身份标识，商户完成首信易系统注册后可登录商户后台商户服务查看。 |
M |
| orderAmount |
订单金额 |
decimal(18) |
以元为单位，保留 2 位小数,例如10.00 |
M |
| orderCurrency |
订单币种 |
varchar(15) |
CNY 为人民币，USD 为美元，EUR 为欧元，GBP 为英镑，JPY 为日元，KRW为韩元， RUB 为卢布，CHF 为瑞士法郎，HKD 为港币，SGD 为新加坡元，MOP 为澳门元，CAD 为加元，NZD 为新西兰元，TWD 为新台币，AUD 为澳大利亚元 |
M |
| requestId |
订单号 |
varchar(50) |
该参数格式为：订单生成日期-商户编号-商户流水号。例如：20170101-888-12345。商户流水号为数字，每日内不可重复，并且不能包括除数字、英文字母和“-”外以其它字符。流水号可为一组也可以用“-”间隔成几组 |
M |
| notifyUrl |
通知地址 |
varchar(200) |
服务器通知：当订单状态为终态后会向该地址发送五次成功通知，该地址可以带参数，如:“https://www.5upay.com/callback.action?test=test”.注意：如不填 notifyUrl 的参数值支付成功后您的服务器将得不到支付成功的通知。 |
M |
| shipInfo |
风控送货信息 |
Json |
送货信息，见下表 |
M |
| billInfo |
风控账单信息 |
Json |
账单信息，见下表 |
M |
| terminalNo |
终端号 |
varchar(20) |
一个网站对应一个终端号，不超过20 位 |
M |
| remark |
备注 |
varchar(300) |
商户在首信易为订单进行备注，通过支付结果返回商户 |
O |
| firstName |
持卡人名 |
varchar(40) |
持卡人名，不可为空值，长度不超过 40 个字符 |
M |
| lastName |
持卡人姓 |
varchar(40) |
持卡人姓，不可为空值，长度不超过 40 个字符 |
M |
| cardNo |
卡号 |
varchar(16) |
信用卡卡号，不可为空值，为全数字格式，长度不超过 16 位数字 |
M |
| expireM |
卡有效期月份 |
varchar(2) |
卡有效期月份，不可为空值，格式为[mm]，例如 02 |
M |
| expireY |
卡有效期年份 |
varchar(2) |
卡有效期年份，不可为空值，格式为[yy]，例如 11 |
M |
| cardCvv2 |
卡 CVV2 码 |
varchar(4) |
卡 CVV2 码，不可为空值，对VISA/MASTER/JCB 卡是 3 位数字，AE 卡是 4 位数字 |
M |
| ordip |
客户支付IP地址 |
varchar(15) |
客户输入持卡人信息时使用的 IP地址。 |
M |
| callbackUrl |
回调地址 |
varchar(200) |
完成 3D 验证支付后的页面回调，会向该地址进行跳转，如:“https://www.5upay.com/callback.action?test=test”. |
M |
| browserInfo |
浏览器信息 |
Json |
浏览器信息，见下表 |
M |
| projectId |
项目编号 |
varchar(50) |
商户可以通过项目编号区分订单业务类型 |
O |
| hmac |
参数签名 |
varchar(500) |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
M |
| 参数名称 |
参数中文名称 |
类型& 长度 |
参数说明 |
是否必填 |
| acceptHeader |
浏览器头信息 |
String (300) |
从持卡人浏览器发送到 3DS 请求者的 HTTP ACCEPT 标头的确切内容。与 ACCEPT 标头不同的任何其他标头都将被拒绝。例如：application/json,text/plain,text/html,*/*。 |
M |
| javaEnabled |
是否支持Java |
String (10) |
布尔值，表示持卡人浏览器执行Java 的能力。 可以通过使用JavaScript 访问导航器的属性navigator.javaEnabled 来检索该值。例如：var javaEnabled=navigator.javaEnabled();//java_enabled |
M |
| terminalType |
终端类型 |
String (2) |
持卡人浏览器类型：枚举如下：01 PC 端 02 手机端例如：持卡人使用电脑浏览器传 01 |
|
| language |
浏览器语言 |
String (40) |
表示 IETF BCP47 中定义的浏览器语言的值。请注意，根据上述 IETF BCP47，将仅提交一种浏览器语言标签。 子标签中也允许使用数字字符，将代表区域。例如：en-GB、zh-guoyu、fil-PH、gsw、es-419、de-1996 等。可以通过访问以下属性来检索该值 带有 JavaScript 的导航器，navigator.language。例如：var language=navigator.language;//language |
M |
| colorDepth |
浏览器像素 |
String (10) |
表示用于显示图像的调色板位深度的值，以每像素位为单位。 使用screen.colorDepth 属性从持卡人浏览器获取。 根据 EMVCo 规范的值可以是 1、4、8、15、16、24、32、48 之一。如果确定了不支持的color_depth，则需要提交小于实际值的最接近的支持值 . 如果获取的值为 30，根据 EMVCo 规范不支持，则必须提交 24。例如：var color_depth=String(window.screen.colorDepth);//color_depth |
M |
| screenHeight |
屏幕高度 |
String (10) |
持卡人屏幕的总高度（以像素为单位）。例如：var screen_height=String(window.screen.height);// |
M |
| screenWidth |
屏幕宽度 |
String (10) |
持卡人屏幕的总宽度（以像素为单位）。例如：var screen_width=String(window.screen.width);//screen_width |
M |
| timeZoneoffset |
时区差 |
String (100) |
UTC 时间与持卡人浏览器本地时间之间的时差，以分钟为单位。 请注意，如果本地时区落后于 UTC，则偏移量为正，如果领先则为负。 如果 UTC -5 小时，则提交 300 或+300，如果 UTC +2 小时，则提交-120。 可以使用 Javascript getTimezoneOffset() 方法通过Date 对象检索该值。例如：var time_zone_offset=new Date().getTimezoneOffset();//time_zone_offset |
M |
| userAgent |
浏览器版本 |
String (300) |
HTTP 用户代理标头的确切内容例如： var userAgent=navigator.userAgent;//userAgent |
M |