创建账单 - 支付宝

创建账单

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/ebpp/bill/add' \ --header 'Content-Type: application/json' \ --data-raw '{ "bank_bill_no": "20130916", "bill_date": "201203", "bill_key": "3388102012376451", "charge_inst": "BJCEB", "extend_field": "{\"key1\":\"value1\",\"key2\":\"value2\",\"key3\":\"value3\",\"key4\":\"value4\"}", "merchant_order_no": "201203031234567", "mobile": "15987838584", "order_type": "JF", "owner_name": "织绫", "pay_amount": "23.45", "service_amount": "8", "sub_order_type": "WATER", "traffic_location": "浙江,杭徽高速", "traffic_regulations": "闯红灯" }'

{ "alipay_order_no": "201203088888888", "bank_bill_no": "20130705", "bill_date": "201203", "bill_key": "3388102012376451", "charge_inst": "BJCEB", "charge_inst_name": "北京光大", "extend_field": "20140504", "merchant_order_no": "201203031234567", "order_type": "JF", "owner_name": "织绫", "pay_amount": "23.45", "service_amount": "8", "sub_order_type": "WATER" }

请求参数

Query 参数

auth_token

string

用户授权令牌

可选

Body 参数application/json

bank_bill_no

string

外部订单号

可选

示例值:

20130916

bill_date

string

可选

账单的账期，格式为 yyyyMMdd。例如：202012表示2020年12月的账单。

示例值:

201203

bill_key

string

可选

账单单据号，例如水费单号，手机号，电费号，信用卡卡号。没有唯一性要求。

示例值:

3388102012376451

charge_inst

string

可选

支付宝给每个出账机构指定了一个对应的英文短名称来唯一表示该收费单位。

示例值:

BJCEB

extend_field

string

扩展属性

可选

示例值:

{"key1":"value1","key2":"value2","key3":"value3","key4":"value4"}

merchant_order_no

string

可选

输出机构的业务流水号，需要保证唯一性

示例值:

201203031234567

mobile

string

用户的手机号

可选

示例值:

15987838584

order_type

string

可选

支付宝订单类型。枚举支持： *JF：公共事业缴纳。 *WUYE：物业缴费。 *HK：信用卡还款。 *TX：通讯缴费。

示例值:

owner_name

string

可选

拥有该账单的用户姓名

示例值:

织绫

pay_amount

string

可选

缴费金额。用户支付的总金额。单位为元（人民币）。取值范围为[0.01，100000000.00]，精确到小数点后两位。

示例值:

23.45

service_amount

string

账单的服务费。

可选

示例值:

sub_order_type

string

可选

子业务类型是业务类型的下一级概念。枚举支持： *WATER：缴水费。 *ELECTRIC：缴电费。 *GAS：缴燃气费。 *COMMUN：缴固话宽带费。 *CATV：缴有线电视费。 *WUYE：缴物业费。 *RC：定期还车贷代扣。 *RH：定期还房贷代扣。 *RR：定期还房租代扣。 *RN：定期还网贷代扣。 *CZ：手机充值代扣。例如：WATER表示JF下面的水费。

示例值:

WATER

traffic_location

string

可选

交通违章地点，sub_order_type=TRAFFIC时填写。

示例值:

浙江,杭徽高速

traffic_regulations

string

可选

违章行为，sub_order_type=TRAFFIC时填写。

示例值:

闯红灯

示例

返回响应

🟢200common response

application/json

Body

alipay_order_no

string

可选

支付宝的业务订单号，具有唯一性。

示例值:

201203088888888

bank_bill_no

string

可选

外部订单号，由于对账时回传给外部商户

示例值:

20130705

bill_date

string

可选

账单的账期，格式为 yyyyMMdd。例如：202012表示2020年12月的账单。

示例值:

201203

bill_key

string

可选

账单单据号，例如水费单号，手机号，电费号，信用卡卡号。没有唯一性要求。

示例值:

3388102012376451

charge_inst

string

可选

支付宝给每个出账机构指定了一个对应的英文短名称来唯一表示该收费单位。

示例值:

BJCEB

charge_inst_name

string

出账机构中文名称。

可选

示例值:

北京光大

extend_field

string

可选

扩展属性，该属性值现在用于确保只有一个人可以支付成功用法：多个人对同一笔外部欠费单创建多个账单时，确保该值不变

示例值:

20140504

merchant_order_no

string

可选

输出机构的业务流水号，需要保证唯一性。

示例值:

201203031234567

order_type

string

可选

支付宝订单类型。枚举支持： *JF：公共事业缴纳。 *WUYE：物业缴费。 *HK：信用卡还款。 *TX：通讯缴费。

示例值:

owner_name

string

可选

拥有该账单的用户姓名

示例值:

织绫

pay_amount

string

可选

缴费金额。用户支付的总金额。单位为元（人民币）。取值范围为[0.01，100000000.00]，精确到小数点后两位。

示例值:

23.45

service_amount

string

账单的服务费

可选

示例值:

sub_order_type

string

可选

示例值:

WATER

🔴500请求失败