一城卡-星尚爱你网合作接口规范V11.doc

一城卡商务合作接口规范V1.1 ?Page  PAGE \* MERGEFORMAT 8 of  SECTIONPAGES 7 FILENAME \* MERGEFORMAT 3780193-58fc381b3a86c.doc  一城卡商务合作接口规范 版本：V1.0  历史版本 日期版本新增或修订背景叙述制作核准2010-09-01V1.0初拟易玮2010-09-13V1.1加入商户管理地址、账户和密码易玮目 录  TOC \o 1-3 \h \z   HYPERLINK \l _Toc271116487 历史版本  PAGEREF _Toc271116487 \h 1  HYPERLINK \l _Toc271116488 1. 一城卡支付接口说明  PAGEREF _Toc271116488 \h 3  HYPERLINK \l _Toc271116489 1.1. 页面支付接口说明  PAGEREF _Toc271116489 \h 3  HYPERLINK \l _Toc271116490 1.1.1. 调用地址  PAGEREF _Toc271116490 \h 3  HYPERLINK \l _Toc271116491 1.1.2. 基本流程  PAGEREF _Toc271116491 \h 3  HYPERLINK \l _Toc271116492 1.1.3. 测试参数  PAGEREF _Toc271116492 \h 8  HYPERLINK \l _Toc271116493 1.1.4. 正式环境参数  PAGEREF _Toc271116493 \h 8  一城卡支付接口说明 页面支付接口说明 调用地址 测试地址：/selfhelp/payOrderInput.action 正式地址：/selfhelp/payOrderInput.action 基本流程 流程图 流程说明 一城卡用户在商户方进行消费后（包括线上和线下各种消费），选择一城卡支付。 商户根据用户消费信息生成订单号，支付金额，回调地址等信息（详细参数见下表）。 商户将订单号、金额等参数提交到一城卡支付接口的支付接收页面。 支付接收页面判断商户签名及参数的正确性，如果合法则出现输入卡号、支付密码、支付金额的页面（如果是通过内嵌方式的线上消费，则卡号自动绑定，无需输入）。否则在页面输入错误。 用户输入卡号、密码进行验证。。 如果验证失败（卡号密码错误、余额不足等）也直接在页面上输出错误。 进行扣款。 返回商户的回调页面并传入支付状态等参数（具体参数见下表）。Get方式返回。 商户根据支付状态向用户显示消费结果。 支付接口具体参数列表 操 作一城卡支付类 型页面跳转支付，Post数据交易页面Form参数规范： 名称类型含义格式示例备注merchantNoString商户号一城卡提供。888888880175001必需orderIdString订单号商户生成201005061254必需serialNoString支付流水号（可以用当前时间）hhmmss130542必需amountString订单未付金额（必须为两位小数）单位为元265.23必需，最低金额为0.1元callBackUrlString回调地址，支付成功将向该地址发送支付结果等信息必需isFullString是否全额支付（0为部分支付，1为全额支付）1位字符格式的数字，目前为全额支付1必需terminalNoString终端号一城卡提供必需merchantDecodedDataString密文MD5序列bb015bee93310e9e0341c58f250f8faf必需回调页面接收参数规范： 名称类型含义格式示例备注merchantNoString商户号商户传入。888888880175001必需terminalNoString终端号商户传入必需orderIdString订单号商户传入的201005061254必需serialNoString支付流水号商户传入的130542必需amountString扣款金额（两位小数）实际支付金额265.23必需，最低金额为0.1元isFullString