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

分润接口参数和实例文档 最后修改时间：2008-8-21修改 by：甘宁 分润接口 接口类型 系统调用 输入参数 字段名 变量名 类型 说明 可空 协议参数 接口名称 service String distribute_royalty N 签名 sign String 见签名机制 N 签名方式 sign_type String 见签名方式 N 合作伙伴ID partner String(16) 合作伙伴在支付宝的用户ID N 通知URL notify_url URL 针对该交易的交易状态异步通知接收URL。 N 业务参数 外部交易号 out_trade_no String(64) 外部交易号（商户网站订单 Y 支付宝交易号 trade_no String(16) Y 外部分润号 out_bill_no String(20) 外部单据号,一个合作伙伴中唯一 N 提成类型 royalty_type String(2) 目前只支持一种类型： 10 Y 提成信息集 royalty_parameters String(500) 分润收款账号1^提成金额1^说明1|分润付款账号2^分润收款账号2^提成金额2^说明2 单次条数不超过10条 说明不能超过30个字符，不能有^和|符号 注意:当分润信息中没有显式指明分润付款账号时,分润付款账户默认为卖家账户 Y 输出参数 response返回: 字段名 变量名 类型 说明 可空 协议参数 是否成功 is_success String T,F Y 错误码 error String 错误原因,当is_success为F时不可为空 Y 使用说明 何时使用: 买家付完款后,交易未超时,且交易未关闭时可以调用 注意事项: royalty_parameters分润参数,分润参数顺序问题: 分润顺序按参数传入顺序执行,所有分润必须满足”入大于出,先入后出”原则; 每次调用分润接口进行分润时必须传入out_bill_no用以标识, 当同一out_bill_no之前已分润成功,重复调用时返回成功(前后两次的分润参数必须完全相同)。 附录： 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 交易总金额小于等于0 TOTAL_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_SUP