统一收单交易支付接口
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/trade/pay
alipay.trade
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/trade/pay' \
--header 'Content-Type: application/json' \
--data-raw '{
"agreement_params": {
"agreement_no": "20170322450983769228",
"apply_token": "MDEDUCT0068292ca377d1d44b65fa24ec9cd89132f",
"auth_confirm_no": "423979",
"deduct_permission": "2021571176714791277815457854545"
},
"bkagent_req_info": {
"acq_code": "string",
"device_type": "string",
"location": "string",
"merch_code": "string",
"serial_num": "string"
},
"business_params": {
"actual_order_time": "string",
"campus_card": "string",
"card_type": "string",
"enterprise_pay_amount": "string",
"enterprise_pay_info": "string",
"good_taxes": "string",
"mc_create_trade_ip": "string",
"tiny_app_merchant_biz_type": "string"
},
"ext_user_info": {
"cert_no": "string",
"cert_type": "string",
"fix_buyer": "string",
"identity_hash": "string",
"min_age": "string",
"mobile": "string",
"name": "string",
"need_check_info": "string"
},
"extend_params": {
"card_type": "string",
"hb_fq_num": "string",
"hb_fq_seller_percent": "string",
"industry_reflux_info": "string",
"royalty_freeze": "string",
"specified_seller_name": "string",
"sys_service_provider_id": "string",
"trade_component_order_id": "string"
},
"pay_params": {
"async_type": "NORMAL_ASYNC",
"retry_type": "NONE"
},
"promo_params": {
"actual_order_time": {}
},
"royalty_info": {
"royalty_detail_infos": [
{
"amount": "string",
"amount_percentage": "string",
"batch_no": "string",
"desc": "string",
"out_relation_id": "string",
"serial_no": 0,
"trans_in": "string",
"trans_in_type": "string",
"trans_out": "string",
"trans_out_type": "string"
}
],
"royalty_type": "string"
},
"settle_info": {
"settle_detail_infos": [
{
"actual_amount": "string",
"amount": "string",
"settle_entity_id": "string",
"settle_entity_type": "string",
"summary_dimension": "string",
"trans_in": "string",
"trans_in_type": "string"
}
],
"settle_period_time": "string"
},
"sub_merchant": {
"merchant_id": "string",
"merchant_type": "string"
},
"advance_payment_type": "ENJOY_PAY_V2",
"alipay_store_id": "2016041400077000000003314986",
"auth_code": "28763443825664394",
"auth_confirm_mode": "COMPLETE",
"auth_no": "2016110310002001760201905725",
"body": "Iphone6 16G",
"buyer_id": "2088202954065786",
"buyer_open_id": "074a1CcTG1LelxKe4xQC0zgNdId0nxi95b5lsNpazWYoCo5",
"disable_pay_channels": "credit_group",
"discountable_amount": "80.00",
"goods_detail": [
{
"alipay_goods_id": "string",
"body": "string",
"categories_tree": "string",
"goods_category": "string",
"goods_id": "string",
"goods_name": "string",
"out_item_id": "string",
"out_sku_id": "string",
"price": "string",
"quantity": 0,
"show_url": "string"
}
],
"is_async_pay": false,
"merchant_order_no": "201008123456789",
"notify_url": "string",
"operator_id": "yx_001",
"out_trade_no": "20150320010101001",
"passback_params": "merchantBizType%3d3C%26merchantBizNo%3d2016010101111",
"product_code": "FACE_TO_FACE_PAYMENT",
"request_org_pid": "2088201916734621",
"scene": "bar_code",
"seller_id": "2088102146225135",
"settle_currency": "USD",
"store_id": "NJ_001",
"subject": "Iphone6 16G",
"terminal_id": "NJ_T_001",
"terminal_params": "{\"terminalType\":\"IOT\",\"signature\":\"EXXXX\",\"apdidToken\":\"iBfdgYbXXX\",\"hardToken\":\"06014698AEFXXX\",\"time\":\"1533061133\",\"bizCode\":\"11002200020\",\"bizTid\":\"0100200mWXXX\",\"signedKeys\":\"authCode,totalAmount,apdidToken,hardToken,time,bizCode,bizTid\"}",
"timeout_express": "90m",
"total_amount": "88.88",
"trans_currency": "USD",
"undiscountable_amount": "8.88",
"query_options": "voucher_detail_list",
"time_expire": {}
}'响应示例响应示例
200 - 示例 1
{
"bkagent_resp_info": {
"bindclrissr_id": "string",
"bindpyeracctbk_id": "string",
"bindtrx_id": "string",
"bkpyeruser_code": "string",
"estter_location": "string"
},
"charge_info_list": {
"charge_fee": "string",
"charge_type": "string",
"is_rating_on_switch": "string",
"is_rating_on_trade_receiver": "string",
"original_charge_fee": "string",
"sub_fee_detail_list": [
{
"charge_fee": "string",
"original_charge_fee": "string",
"switch_fee_rate": "string"
}
],
"switch_fee_rate": "string"
},
"enterprise_pay_info": {
"biz_info": "string",
"invoice_amount": "string",
"is_use_enterprise_pay": true
},
"advance_amount": "88.8",
"async_payment_mode": "SYNC_DIRECT_PAY",
"auth_trade_pay_mode": "CREDIT_PREAUTH_PAY",
"business_params": "{\"data\":\"123\"}",
"buyer_logon_id": "159****5620",
"buyer_open_id": "074a1CcTG1LelxKe4xQC0zgNdId0nxi95b5lsNpazWYoCo5",
"buyer_pay_amount": "8.88",
"buyer_user_id": "2088101117955611",
"buyer_user_name": "菜鸟网络有限公司",
"buyer_user_type": "PRIVATE",
"can_turn_to_app_pay": "true",
"card_balance": "98.23",
"charge_amount": "8.88",
"charge_flags": "industry_special_00",
"credit_biz_order_id": "ZMCB99202103310000450000041833",
"credit_pay_mode": "creditAdvanceV2",
"discount_amount": "88.88",
"discount_goods_detail": "[{\"goods_id\":\"STANDARD1026181538\",\"goods_name\":\"雪碧\",\"discount_amount\":\"100.00\",\"voucher_id\":\"2015102600073002039000002D5O\"}]",
"fund_bill_list": [
{
"amount": "string",
"bank_code": "string",
"fund_channel": "string",
"fund_type": "string",
"real_amount": "string"
}
],
"hyb_amount": "10.24",
"invoice_amount": "12.50",
"mdiscount_amount": "88.88",
"open_id": "2088102122524333",
"out_trade_no": "6823789339978248",
"pay_amount": "580.04",
"pay_currency": "CNY",
"point_amount": "8.12",
"receipt_amount": "88.88",
"receipt_currency_type": "DC",
"settle_amount": "88.88",
"settle_currency": "USD",
"settle_trans_rate": "1",
"settlement_id": "2018101610032004620239146945",
"store_name": "证大五道口店",
"total_amount": "120.88",
"trade_no": "2013112011001004330000121536",
"trans_currency": "USD",
"trans_pay_rate": "6.5261",
"voucher_detail_list": [
{
"amount": "string",
"id": "string",
"memo": "string",
"merchant_contribute": "string",
"name": "string",
"other_contribute": "string",
"other_contribute_detail": [
{
"contribute_amount": "string",
"contribute_type": "string"
}
],
"purchase_ant_contribute": "string",
"purchase_buyer_contribute": "string",
"purchase_merchant_contribute": "string",
"template_id": "string",
"type": "string"
}
],
"gmt_payment": {}
}请求参数
Body 参数application/json