机票项目接口文档.docx

机票行业解决方案接口文档 版本 0.1 修订历史 版本号  作者  修订章节  修订原因  修订日期 0.1  杨彬  2008-03-10 业务场景 接口定义 标准即时到账接口 接口类型 页面跳转 输入参数 字段名 变量名 类型 说明 协议参数 接口名称 service String create_direct_pay_by_user 合作伙伴 ID partner String(16) 合作伙伴在支付宝的用户 ID 通知 URL notify_url URL 针对该交易的交易状态同步通 知接收 URL 。 返回 URL return_url URL 结果返回 URL ，仅适用于立即 返回处理结果的接口。支付宝 处理完请求后，立即将处理结 果返回给这个 URL 。 代理商 ID agent String(16) 如果一些交易网站的交易，有 一定的“代理”所属关系，代 理商可以在交易中传递该参 数，来表明代理的身份。这里 传送的值，请使用代理商所属 支付宝账户的 PartnerID 。 签名 sign String 见签名机制 签名方式 sign_type String 见签名方式 业务参数 商品名称 subject String(256) 商品描述 body String(400) 外部交易号 out_trade_no String(64) 合作伙伴交易号（确保在合作 伙伴系统中唯一） 交易金额 total_fee Number(8,2 单 位 为 RMB Yuan 0.01 ～ ) 1000000.00, 上限取决于买卖 双方的即时交易金额限制 商品单价 price Number(13, 单位为 RMB Yuan 2) 0.01 ～ 100000000.00 购买数量 quantity Number(6,0 0 ) 支付类型 payment_type String 见支付类型表 默认支付方 paymethod String bankPay( 网 银 );cartoon( 卡 式 通 ); directPay( 余额 ) 默认网银 defaultbank String 见银行表 买家买家信息 卖家 Email seller_email String(100) 卖家在支付宝的注册 Email 或 卖家 ID seller_id String(30) 注册 ID ，两者任何一个。 买家 Email buyer_email String(100) 买家在支付宝的注册 Email 或 买家 ID buyer_id String(30) 注册 ID ，如果买家还没有确定 可以为空。 买家留言 buyer_msg String(200) 提成类型 royalty_type String(2) 目前只支持一种类型：卖家给 第三方提成（ 10 ） 提成信息集 royalty_parame String(500) 帐号 1^ 提成金额 1^ 说明 1| 帐 ters 号 2^ 提成金额 2^ 说明 2| 帐号 3^ 提成金额 3^ 说明 3 做多传入 5 个 说明不能超过 30 个字符， 不能 有^和|符号 输出参数 notify_url,return_url 返回 字段名 变量名 类型 说明 可空 协议参数 通知类型 notify_type String trade_status_sync N 通知 ID notify_id String 支付宝通知流水号， 合 N 作伙伴可以用这个流 水号询问支付宝该条 通知的合法性 通知时间 notify_time Timestamp 通知时间（支付宝时 N 间），格式： YYYY-MM-DD hh:mm:ss 签名 sign String 见 HTTP 参数签名机 N 制 签名方式 sign_type String 见签名方式 N 业务参数 支付宝交 trade_no String(64) 该交易在支付宝系统 N 易号 中的交易流水号 外部交易 out_trade_no String(64) 该交易在合作伙伴系 N 号 统的流水号 支付类型 payment_type String 见支付类型枚举表 N 商品名称 subject String(256) N 商品描述 body String(400) Y 商品单价 price Number(13,2) 单位为 RMB Yuan N 0.01 ～ 100000000.00 购买数量 quantity Number(6,0) 0 N 交易金额 total_fee Number(13,2) 单位为 RMB Yuan N 0.01 ～ 1000000.00 交易状态信息 交易状态 trade_st