机票项目接口文档.docVIP

机票行业解决方案接口文档 版本 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,2) 单位为RMB Yuan 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，两者任何一个。 卖家ID seller_id String(30) 买家Email buyer_email String(100) 买家在支付宝的注册Email或注册ID，如果买家还没有确定可以为空。 买家ID buyer_id String(30) 买家留言 buyer_msg String(200) 提成类型 royalty_type String(2) 目前只支持一种类型：卖家给第三方提成（10） 提成信息集 royalty_parameters String(500) 帐号1^提成金额1^说明1|帐号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 通知时间（支付宝时间），格式： YYYY-MM-DD hh:mm:ss N 签名 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 0.01～100000000.00 N 购买数量Number(6,0) 0 N 交易金额 total_fee Number(13,2) 单位为RMB Yuan 0.01～1000000.00 N 交易状态信息 交易状态 trade_status String 见交易状态枚举表 N 物流信息 物流类型 logistics_type String 见物流类型枚举表 Y 物流费用 logistic