支付宝即时分润接口文档.doc

分润接口参数和实例文档 最后修改时间：2008-8-21修改 by：甘宁1. 分润接口接口类型系统调用输入参数字段名变量名类型说明可空协议参数接口名称serviceStringdistribute_royaltyN签名signString见签名机制N签名方式sign_typeString见签名方式N合作伙伴IDpartnerString(16)合作伙伴在支付宝的用户IDN通知URLnotify_urlURL针对该交易的交易状态异步通知接收URL。N业务参数外部交易号out_trade_noString(64)外部交易号（商户网站订单）和外部交易号不可同时为空。二选其一即可Y支付宝交易号trade_noString(16)Y外部分润号out_bill_noString(20)外部单据号,一个合作伙伴中唯一N提成类型royalty_typeString(2)目前只支持一种类型： 10Y提成信息集royalty_parametersString(500)分润收款账号1提成金额1说明1|分润付款账号2分润收款账号2提成金额2说明2单次条数不超过10条说明不能超过30个字符，不能有和|符号注意:当分润信息中没有显式指明分润付款账号时,分润付款账户默认为卖家账户Y输出参数response返回:字段名变量名类型说明可空协议参数是否成功is_successStringT,FY错误码errorString错误原因,当is_success为F时不可为空Y使用说明何时使用:买家付完款后,交易未超时,且交易未关闭时可以调用注意事项:royalty_parameters分润参数,分润参数顺序问题:分润顺序按参数传入顺序执行,所有分润必须满足”入大于出,先入后出”原则;每次调用分润接口进行分润时必须传入out_bill_no用以标识,当同一out_bill_no之前已分润成功,重复调用时返回成功(前后两次的分润参数必须完全相同)。2. 附录：A.常见错误：错误代码（error_code）说明协议层错误代码ILLEGAL_SIGN签名验证出错ILLEGAL_ARGUMENT参数格式有问题ILLEGAL_SERVICE无效接口名称ILLEGAL_PARTNER无效合作伙伴IDILLEGAL_SIGN_TYPE无效签名方式ILLEGAL_CHARSET无效字符集HAS_NO_PUBLICKEY没有上传公钥HASH_NO_PRIVILEGE没有权限访问该服务SYSTEM_ERROR支付宝系统出错OUTBILLNO_TOO_LONG外部分润号大于16位TRADE_PASS_TIME_OR_NOT_SUCCESS交易超时或者没有成功，这个由于使用外部订单号导致TRADE_CAN_NOT_FOUND该交易不存在，这个由于使用外部订单号导致NOT_CREATE_BY_PARTNER合作partnerID和原来下订单的partnerID导致交易接口错误代码OUT_TRADE_NO_EXIST外部交易号已经存在TRADE_NOT_EXIST交易不错在ILLEGAL_PAYMENT_TYPE无效支付类型BUYER_NOT_EXIST买家不存在SELLER_NOT_EXIST卖家不存在COMMISION_ID_NOT_EXIST佣金收取帐户不存在COMMISION_SELLER_DUPLICATE收取佣金帐户和卖家是同一帐户COMMISION_FEE_OUT_OF_RANGE佣金金额超出范围BUYER_SELLER_EQUAL买家、卖家是同一帐户ILLEGAL_LOGISTICS_FORMAT无效物流格式TOTAL_FEE_LESSEQUAL_ZERO交易总金额小于等于0TOTAL_FEE_OUT_OF_RANGE交易总金额超出范围ILLEGAL_FEE_PARAM非法交易金额格式DONATE_GREATER_THAN_MAX小额捐赠总金额超出最大值限制DIRECT_PAY_AMOUNT_OUT_OF_RANGE快速付款交易总金额超出最大值限制DIGITAL_FEE_GREATER_THAN_MAX虚拟物品交易总金额超出最大值限制SELF_TIMEOUT_NOT_SUPPORT不支持自定义超时COMMISION_NOT_SUPPORT不支持佣金VIRTUAL_NOT_SUPPORT不支持虚拟发货方式B. 签名方式：签名方式表：说明MD5待签名数据 + securityCode值（支付宝为合作伙伴颁发的安全校验码）的MD5摘要作为签例如： 安全校验码是mysecurityCode，那么前面会员查询接口示例的待签名数据就email=&partner=2088006300000000&service=user_querymysecurityCode。 DSA合作伙伴发送请求时，使用自己的密钥对待签名数据进行DSA签名，支付宝使用合作伙伴钥进行校验；支付宝返回数据时，使用支付宝的密钥对待签名数据进行DSA签名，合作伙用支付宝的公钥进行校验。 DSA公私钥可以使用OpenSSL生成，如下： 1. 生成DSA参数 openssl dsaparam -out dsa_param.pem 1024 2. 生成私钥 openssl gendsa