厦门托付科技有限公司厦门托付支付平台商户接入手册 (V8.0) 1

Size: px

Start display at page:

Download "厦门托付科技有限公司厦门托付支付平台商户接入手册 (V8.0) 1"

球龟霍
5 years ago
Views:

1 厦门托付支付平台商户接入手册 (V8.0) 1

2 1. 概述商户网站与托付支付网关接口规范商户网站与托付支付网关接口规范对接说明提交率接口 V8.0 支付接口数据字典币种代码表语言代码表

3 1. 概述托付支付 ( ) 是中国专业的独立第三方支付公司公司位于中国五大经济特区之一 ( 风光秀丽的厦门 ) 厦门作为海峡西岸经济区中最具活力和影响力的城市, 毗邻中国制造业和对外贸易最为发达的城市圈之一 ( 厦漳泉闽南金三角 ) 成立以来, 公司已为数千家企业提供了金融整体解决方案托付支付已成为海西经济区中信息化金融服务行业的领导者托付支付为提高商户接入的效率, 降低商户技术投入成本, 已针对当前通用的网站开源框架提供了接口程序, 商户可以在厦门托付商户管理后台直接下载对应不同框架的接口程序 3

4 2. 商户网站与托付支付网关接口规范 2.1 商户网站与托付支付网关接口规范对接说明托付外卡支付接口使用 HTTP POST 方式连接并发送信息, 信息放在 HTTP 的消息体中每个 HTTP POST 请求发送后, 接收端在接收并处理请求时提取商户提供的订单信息订单信息需经过 MD5 加密, 然后再进行提交之后经过后台处理, 托付网关获取结果参数进行 MD5 加密并与系统 Md5 签名字段进行比较, 如果校验一致, 则把订单结果信息通知给商户或用户当发送端接收到确认信息后, 才认为整个请求被成功发送在某些要求务必送达的请求中, 上述通知 - 确认流程必须由接收端确保, 如果发送端不能接收到正确响应将会按照一定的逻辑重复发送请求提交率接口接口地址 : ction.monitoraction.do 功能 : 计算提交率的辅助接口, 为了更好的反映网站情况, 请务必对接当用户进入支付页面时, 对接此接口参数 : 4

5 参数说明 CartID AcctNo Framework IVersion OrderUrl ( 必填 ) 购物车编码 ( 必填 ) 网站接入号 ( 必填 ) 网店框架名称 ( 必填 ) 版本 (V8.0) ( 必填 ) 网店域名返回结果 : 参数 status date msg 说明返回状态 ;0000 表示成功,0001 表示失败返回订单数据返回状态说明例子 : 成功 : { status : 0000, date :, msg : success } 失败 : { status : 0001, date :, msg : NullPoint } V8.0 支付接口接口地址 : ction.newsubmitaction.do 5

6 Httppost form 表单形式传至 V8.0 支付接口, 参数如下 : 参数名称类型 ( 长度 ) 备注 OrderID 订单号 CHAR(30) 必填项目 ; 商户的订单号 CartID 购物车编码 CHAR(30) 必填项目 CurrCode 货币代码 CHAR(8) 必填项目 ; 货币代码 ( 参考 2.1) Amount 交易金额 CHAR(20) 必填项目 ; 商家交易的金额 ( 以分为单位上传, 不保留小数点 ) CardPAN 卡号 CHAR(16) 必填项目 ExpirationMonth 有效期月份 CHAR(2) 必填项目 ExpirationYear 有效期年份 CHAR(2) 必填项目 CVV2 卡片安全码 CHAR(3) 必填项目 IPAddress 持卡人的 ip 地址 CHAR(20) 必填项目 CName 收货人姓名 CHAR(16) 必填项目 BAddress 收货人地址 CHAR(32) 必填项目 BCity 收货人所在城市 CHAR(32) 必填项目 Bstate 收货人州 ( 省 ) CHAR(32) 必填项目 Bcountry 收货人国家 CHAR(32) 必填项目 BCountryCode 国家代码 CHAR(2) 必填项目 PostCode 邮编 CHAR(32) 必填项目邮箱地址 CHAR(32) 必填项目 Telephone 电话号码 CHAR(20) 必填项目 6

7 Pname 产品和品牌 CHAR(32) 必填项目 IFrame 是否内嵌框架 CHAR(1) 必填项目 ; 值都为 1 即可 URL 商户网站网址 CHAR(32) 必填项目 OrderUrl 同 URL CHAR(32) 必填项目 callbackurl 用于更新网店订单状态的地址 CHAR(50) 可为空 Framework 网店框架类型 CHAR(20) 例如 : Zencart IVersion 版本 CHAR(10) 例如 : V8.0 Language 语言 ( 国际化 ) CHAR(2) 必填项目可选值 : da: 丹麦 de: 德国 en: 英国 es: 西班牙 fr: 法国 in: 印度尼西亚 it: 意大利 iw: 希伯来 ja: 日本 ms: 马来西亚 nl: 荷兰 nn: 挪威 pl: 波兰 ru: 俄罗斯 sv: 瑞典 tr: 土耳其若参数不匹配则使用英文 HashValue 加密数据 CHAR(500) 必填项目注 : 1) 备注栏目中为必填项的在接口数据包中必须填写对应的真实取值 7

8 2) 备注栏目中为可选项的在接口数据包中可以设为 NULL 3) 商户要保证订单号的唯一性 4) HashValue 计算方式以 PHP 为例子 ( asp 的网站只需要标准 md5 加密 ) 组成 //$input 由商户密钥 + 商户交易号 + 订单号 + 交易金额 + 币种代码 $md5hex = md5($input); $len = strlen($md5hex) / 2; $md5raw = ""; for ($i = 0; $i < $len; $i++) { $md5raw = $md5raw. chr(hexdec(substr($md5hex, $i * 2, 2))); } $keymd5 = base64_encode($md5raw); return $keymd5; V8.0 支付接口返回 json 字符串, 返回的参数包括如下 : status msg ispendingpayment( 表示是否可以二次上送 ) data 0000 success false 如下 8

9 0001 失败说明 true/false 如下 0002 请求超时 true/false 如下 Json 返回例子如下 : 成功 : { status : 0000, msg : success, ispendingpayment :false, data :{ orderstatus : Pay for success, // 订单状态 orderno : , // 订单号 curr_code : USD, // 货币代码 amount : , // 金额 hashvalue : 9lhnAd9xNCBpgTSDYynP4A==, // 哈希值 rout url : e=payment/pay/callback, // 回调地址 9

10 par1 :null, // 交易号 par2 : , // 订单号 par3 : pkid, // 交易流水号 par4 : 00, // 返回的 code par5 : succeed, // 返回的信息 par6 : USD // 返回货币代码 } } 失败 : { status : 0001, msg :false, ispendingpayment :true, data :null } 2.2 数据字典 10

11 2.2.1 币种代码表币种代码币种国家 036 AUD 澳元 124 CAD 加元 153 CNY 人民币 208 DKK 丹麦克朗 344 HKD 港元 356 INR 印度卢比 360 IDR 印尼卢比 376 ILS 以色列新锡克尔 392 JPY 日元 410 KRW 韩元 446 MOP 澳门币 458 MYR 马来西亚元 578 NOK 挪威克朗 608 PHP 菲律宾 643 RUB 俄罗斯 702 SGD 新加坡元 710 ZAR 南非兰特 752 SEK 瑞典克朗 756 CHF 瑞士法郎 826 GBP 英镑 840 USD 美元 11

12 901 TWD 台币 949 TRY 土耳其里拉 978 EUR 欧元 554 NZD 新西兰元 484 MXN 墨西哥披索 986 BRL 巴西 032 ARS 阿根廷披索 604 PEN 秘鲁披索 990 CLF 智利披索 170 COP 哥伦比亚比索 862 VEF 委内瑞拉披索语言代码表语言代码 da de en es fr in it iw ja ms 语言丹麦德国英国西班牙法国印度尼西亚意大利希伯来日本马来西亚 12

13 nl nn pl ru sv tr 荷兰挪威波兰俄罗斯瑞典土耳其 13

客户(网关接口参数（中文）

客户(网关接口参数（中文）厦门托付支付平台商户接入手册 (V7.0) 目录一概述... 3 二商户网站与托付支付网关接口规范... 4 1 商户网站至托付支付网关接口规范... 4 1.1 对接说明... 4 1.2 前置接口... 4 1.2 提交率接口... 6 1.3 V7.0 支付接口... 7 2 相关数据... 11 2.1 币种代码表... 11 2.1 语言代码表... 12 一概述托付支付 (

厦门托付科技有限公司 厦门托付支付平台 商户接入手册 (V8.0) 1

厦门托付科技有限公司厦门托付支付平台商户接入手册 (V8.0) 1