三方凭证发放

通知商家发放三方凭证

注意：

发码成功，则必须在响应中直接返回正确的券码。商户返回参数错误或发码失败，支付宝侧会在5分钟内多次重试发码请求。5分钟后仍然发码失败，则支付宝侧会发起退款处理。

请求地址

环境	HTTPS请求地址
正式环境	https://openapi.alipay.com/gateway.do

公共请求参数

业务请求参数

展开所有属性

body参数

biz_type**｜凭证关联的主体类型**必选string(32)

【描述】发放凭证时所代表的业务主体类型，如支付宝商品。由商家传入支付宝，并在此接口将相关数据返回，标识需要发放的凭证类型。

【枚举值】

支付宝商品: ALIPAY_MERCHANDISE

【示例值】ALIPAY_MERCHANDISE

order_id**｜支付宝订单号**必选string(64)

【描述】购买商家业务主体时的营销订单号，如购买商品的订单号。

【示例值】2015042321001004720200028594

user_id**｜用户id**必选string(32)

【描述】用户uid 想了解openid？

【示例值】2088XXXX

order_amount**｜订单金额**可选price(16)

【描述】商品订单金额

【示例值】30.00

trade_no**｜支付宝交易流水号**可选string(64)

【描述】购买订单的交易流水号

【示例值】2021042322001426261436764012

send_item_info_list**｜待发放的商品信息**可选SendItemInfo[]

【描述】凭证所关联的商品信息，传入信息与商家申报进入支付宝的商品信息一致，商家依据此数据生成商家的三方凭证。

子属性

phone_number**｜用户手机号**可选string(512)

【描述】用户在下单时传入的手机号码

【注意事项】手机号码为加密数据，加解密请参考文档https://opendocs.alipay.com/common/02mse3，请商家/服务商保护好用户手机号码的数据安全和隐私。

【示例值】12312341234

公共响应参数

业务响应参数

展开所有属性

user_id**｜支付宝uid**必选string(32)

【描述】购买商家业务主体的用户uid 想了解openid？

【示例值】2088xxxx

result_code**｜发放凭证结果**必选string(16)

【描述】商家发放凭证的结果，支付宝会依此字段决策是否处理结果。

【枚举值】

发码成功: SUCCESS

发码失败: FAIL

【示例值】SUCCESS

send_code_result_list**｜商家发放券码结果列表**特殊可选SendCodeResult[]

【描述】商家发放券码结果列表，需要和要求发码数量的结果保持一致，否则会认为发码失败

子属性

order_no**｜支付宝订单号**可选string(64)

【描述】购买商家业务主体的营销订单号。

【注意事项】已废弃，该字段无需返回

【示例值】2015042321001004720200028594

响应示例

正常示例

异常示例

{
    "response": {
        "code": "10000",
        "msg": "Success",
        "order_no": "2015042321001004720200028594",
        "user_id": "2088xxxx",
        "result_code": "SUCCESS",
        "send_code_result_list": [
            {
                "code": "123AB",
                "out_item_id": "123",
                "item_id": "2023010122000000000001",
                "out_sku_id": "12346",
                "sku_id": "2023010123000000000001",
                "qr_code": "alipays://platformapi/startapp?appId=XXX"
            }
        ]
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

**说明：**本示例仅供参考。

公共错误码

前往查看

业务错误码

错误码	错误描述	解决方案
SYSTEM_ERROR	系统繁忙	可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试
INVALID_PARAMETER	参数有误,请检查参数	请根据接口返回的参数非法的具体错误信息，修改参数后进行重试
CERTIFICATE_SEND_FAIL	凭证发放失败	凭证发放操作失败，可以用同样的请求发起重试

三方凭证发放

请求地址#

公共请求参数#

业务请求参数#

公共响应参数#

业务响应参数#

公共错误码#