直連被掃請(qǐng)求報(bào)文

好拓客 5個(gè)月前 ( 11-20 ) 223

說(shuō)明:被掃支付場(chǎng)景,可能存在支付中需要用戶輸入密碼的情況。該情況下一般交易會(huì)返回“DCP10000”-支付中狀態(tài)。在該場(chǎng)景下,建議發(fā)起方發(fā)起多次查詢,查詢頻率推薦1分鐘內(nèi)按 5s+5s+5s+5s+10S+10S+20S方式聯(lián)機(jī)查詢,并保留手工發(fā)起查詢的能力(在1分鐘內(nèi)客戶未完成密碼支付的場(chǎng)景下)

調(diào)用地址

使用HTTP協(xié)議,POST方式提交。

測(cè)試環(huán)境: https://test.wsmsd.cn/sit/api/v3/dcp/trans/micropay

生產(chǎn)環(huán)境: https://s2.lakala.com/api/v3/dcp/trans/micropay

請(qǐng)求報(bào)文

字段名中文名稱是否必填類型說(shuō)明
merchant_no商戶號(hào)MString(32)拉卡拉分配的商戶號(hào)
term_no終端號(hào)MString(32)拉卡拉分配的業(yè)務(wù)終端號(hào)
out_trade_no商戶交易流水號(hào)MString(32)商戶系統(tǒng)唯一,不可重復(fù)
auth_code支付授權(quán)碼MString(32)掃碼支付授權(quán)碼,設(shè)備讀取用戶APP中的條碼或者二維碼信息,用戶付款碼條形碼規(guī)則見(jiàn)說(shuō)明
total_amount金額MString(12)單位分,整數(shù)型字符
location_info地址位置信息MObject地址位置信息,風(fēng)控要求必送
subject訂單標(biāo)題CString(128)標(biāo)題,用于簡(jiǎn)單描述訂單或商品 (賬戶端控制該字段長(zhǎng)度,間連方式下該字段小于42位)
notify_url商戶通知地址CString(128)商戶通知地址,如上傳,且 pay_order_no 不存在情況下,且支付響應(yīng)報(bào)文是交易中狀態(tài)的場(chǎng)景下,則按此地址通知商戶
store_id商戶門店編號(hào)CString(32)商戶門店編號(hào)
store_name商戶門店名稱CString(64)商戶門店名稱
remark(待上線)備注CString(128)商戶交易備注信息
acc_busi_fields賬戶端業(yè)務(wù)信息域CObject賬戶端業(yè)務(wù)信息域

location_info字段說(shuō)明

字段名中文名稱是否必填類型說(shuō)明
request_ip請(qǐng)求方IP地址CString(64)請(qǐng)求方的IP地址,格式如36.45.36.95
request_ip、base_station、location必須上送一個(gè),建議優(yōu)先送request_ip
base_station基站信息CString(128)客戶端設(shè)備的基站信息(主掃時(shí)基站信息使用該字段)
location緯度經(jīng)度CString(32)商戶終端的地理位置,存在必填 格式:緯度,經(jīng)度,+表示北緯、東經(jīng),-表示南緯、 西經(jīng),精度最長(zhǎng)支持小數(shù)點(diǎn)后9位。舉例:+37.123456789,-121.123456789

支付寶支付情況下accBusiFields字段說(shuō)明

字段名中文名稱是否必填類型說(shuō)明
timeout_express下單有效時(shí)間CString(2)下單的訂單的有效時(shí)間,以分鐘為單位。如果在有效時(shí)間內(nèi)沒(méi)有完成付款,則在賬戶端該訂單失效。如果不上送,以賬戶端訂單失效時(shí)間為準(zhǔn)。 建議不超過(guò)15分鐘。不傳值則默認(rèn)5分鐘。
extend_params業(yè)務(wù)擴(kuò)展參數(shù)CString(1024)支付寶業(yè)務(wù)擴(kuò)展參數(shù) ,主要用于花唄分期,見(jiàn)extendParams字段
business_params商戶傳入業(yè)務(wù)信息CString(512)商戶傳入業(yè)務(wù)信息,應(yīng)用于安全,營(yíng)銷 等參數(shù)直傳場(chǎng)景,格式為 json 格式。
goods_detail商品詳情CString(6000)訂單包含的商品列表信息,Json格式。
alipay_store_id商戶門店編號(hào)CString(32)支付寶收單上送,送到支付寶store_id參數(shù)中
query_options支付寶查詢選項(xiàng)CList<>支付寶收單上送

支付寶extendParams字段說(shuō)明(該字段類型為String,非object,值為json字符串,需要加轉(zhuǎn)義)

字段名說(shuō)明必選類型備注
sysServiceProviderId服務(wù)商的PIDCString(64)系統(tǒng)商編號(hào),該參數(shù)作為系統(tǒng)商返傭數(shù)據(jù)提取的依據(jù),請(qǐng)?zhí)顚?xiě)系統(tǒng)商簽約協(xié)議的 PID
hbFqNum花唄分期期數(shù)MString(5)支付寶花唄分期必送字段: 花唄分期數(shù) 3:3期 6:6期 12:12期
hbFqSellerPercent賣家承擔(dān)手續(xù)費(fèi)比例MString(3)支付寶花唄分期必送字段: 賣家承擔(dān)收費(fèi)比例,商家承擔(dān)手續(xù)費(fèi)傳入100,用戶承擔(dān)手續(xù)費(fèi)傳入0,僅支持傳入100、0兩種,其他比例暫不支持 100:代表商家貼息 0:代表用戶承擔(dān)手續(xù)費(fèi)
dynamicTokenOutBizNo外部業(yè)務(wù)號(hào)CString(128)填寫(xiě)alipay.marketing.facetoface.decode.use接口中上送的sence_no字段,類型為String, 枚舉值20170718xxxxxxxx
presetPayTool支卡通相關(guān)參數(shù)CString(256)

業(yè)務(wù)可根據(jù)場(chǎng)景是否需要疊加營(yíng)銷,選擇以下兩種傳參方式。疊加營(yíng)銷場(chǎng)景:forceUse-N(支卡通可疊加營(yíng)銷,使用支卡通金額以異步通知為準(zhǔn))屏蔽營(yíng)銷場(chǎng)景:forceUse-Y(支卡通不可疊加營(yíng)銷,使用支卡通金額為傳入的amount) 示例:”{"MERCHANTCARD_ZKT":[{"amount":"10","forceUse":"N"}]}”

支付寶businessParams字段說(shuō)明(該字段類型為String,非object,值為json字符串,需要加轉(zhuǎn)義)

字段名說(shuō)明必選類型備注
scenePayLinkInfo支卡通相關(guān)參數(shù)CString(256)所有代扣訂單都必須傳該參數(shù)支卡通相關(guān)參數(shù),傳固定字符串。bizScene和subBizScene由支付寶側(cè)BD提供。 {"bizProduct":"ZCARD","bizScene":"支付寶側(cè)分配","subBizScene":"支付寶側(cè)分配","bizMode":"MERCHANT_ORDER"}

支付寶goodsDetail字段說(shuō)明

中文名稱必選類型備注
goods_idMString(32)商品的編號(hào)
goods_nameMString(256)商品名稱
quantityMString(12)商品數(shù)量
priceMString(12)單位為元
goods_categoryCString(24)商品類目
categories_treeCString(128)商品類目樹(shù),從商品類目根節(jié)點(diǎn)到葉子節(jié)點(diǎn)的類目 id 組成,類目 id 值使用|分 割
bodyCString(512)商品描述信息
show_urlCString(256)商品的展示地址

示例: “goodsDetail”:”[{"goods_id":"202202250001","goods_name":"零度可樂(lè)330ml","quantity":"1","price":"1.01"}]”

**
微信支付情況下accBusiFields字段說(shuō)明**

字段名中文名稱是否必填類型說(shuō)明
timeout_express下單有效時(shí)間CString(2)預(yù)下單的訂單的有效時(shí)間,以分鐘為單位。如果在有效時(shí)間內(nèi)沒(méi)有完成付款,則在賬戶端該訂單失效。如果不上送,以賬戶端訂單失效時(shí)間為準(zhǔn)。 建議不超過(guò)15分鐘。不傳值則默認(rèn)5分鐘。
sub_appid子商戶公眾賬號(hào)ID sub_appidCString(32)微信公眾平臺(tái)基本配置中的AppID(應(yīng)用ID),傳入后支付成功可返回對(duì)應(yīng)公眾號(hào)下的用戶openid,只對(duì)微信支付有效
detail商品詳情CString(1024)單品優(yōu)惠功能字段
goods_tag訂單優(yōu)惠標(biāo)記CString(32)訂單優(yōu)惠標(biāo)記,微信平臺(tái)配置的商品標(biāo)記,用于優(yōu)惠券或者滿減使用,accountType為WECHAT時(shí),可選填此字段
scene_info場(chǎng)景信息CString(256)該字段常用于線下活動(dòng)時(shí)的場(chǎng)景信息上報(bào),支持上報(bào)實(shí)際門店信息,商戶也可以按需求自己上報(bào)相關(guān)信息

微信detail字段說(shuō)明

字段名中文名稱必選類型備注
cost_price
CString(12)1.商戶側(cè)一張小票訂單可能被分多次支付,訂單原 價(jià)用于記錄整張小票的交易金額。 2.當(dāng)訂單原價(jià)與支付金額不相等,則不享受優(yōu)惠。 3.該字段主要用于防止同一張小票分多次支付,以 享受多次優(yōu)惠的情況,正常支付訂單不必上傳此參 數(shù)。 如:608800
receipt_id
CString(12)商家小票 ID
goods_detail
MString(1024)單品信息,使用 Json 數(shù)組格式提交

微信goods_detail字段說(shuō)明

字段名必選類型備注
goods_idMString(32)由半角的大小寫(xiě)字母、數(shù)字、中劃線、下劃線中的一種或幾種組成。如“商品編碼”
goods_nameCString(256)商品的實(shí)際名稱
quantityMString(12)用戶購(gòu)買的數(shù)量
priceMString(12)單位為:分。如果商戶有優(yōu)惠,需傳輸商戶優(yōu)惠后的單價(jià)

響應(yīng)報(bào)文

字段名說(shuō)明必選類型備注
need_query是否需要發(fā)起查詢MString(32)0=不需要 1=需要 當(dāng)返回1時(shí),代表訂單處理中,商戶需主動(dòng)發(fā)起查詢
out_trade_no商戶交易流水號(hào)MString(32)請(qǐng)求報(bào)文中的商戶交易流水號(hào)
settle_channel_type結(jié)算渠道類型MString(16)微信:WECHAT 支付寶:ALIPAY 
trade_no平臺(tái)交易流水號(hào)MString(32)平臺(tái)交易流水號(hào)
acc_merchant_trade_no賬戶端商戶交易流水號(hào)CString(32)賬戶端商戶交易流水號(hào)
acc_trade_no賬戶端交易流水號(hào)CString(32)賬戶端交易流水號(hào)
account_type錢包類型MString(16)微信:WECHAT 支付寶:ALIPAY 銀聯(lián):UQRCODEPAY 翼支付: BESTPAY 蘇寧易付寶: SUNING 數(shù)字貨幣:DCPAY
total_amount訂單金額MString(12)單位分,整數(shù)數(shù)字型字符
payer_amount付款人實(shí)際發(fā)生金額MString(12)
acc_settel_amount賬戶端應(yīng)結(jié)訂單金額MString(12)應(yīng)結(jié)訂單金額,單位分
acc_mdiscount_amount商戶優(yōu)惠金額(賬戶端)CString(12)賬戶端返回商戶優(yōu)惠金額,單位分
acc_discount_amount賬戶端優(yōu)惠金額CString(12)賬戶端返回賬戶端優(yōu)惠金額,單位分
trade_time交易完成時(shí)間MString(14)以賬戶端返回時(shí)間為準(zhǔn)
acc_resp_fields賬戶端返回信息域CObject賬戶端返回信息域

支付寶返回的accRespFields域

字段名說(shuō)明必選類型備注
user_id用戶idMString(64)buyer_user_id
alipay_store_id商戶門店編號(hào)CString(32)
fund_bill_list交易支付使用的資金渠道CString(4096)
discount_goods_detail單品券優(yōu)惠的商品優(yōu)惠信息CString(4096)
voucher_detail_list本交易支付時(shí)使用的所有優(yōu)惠券信息CString(4096)
enterprise_pay_info企業(yè)支付信息CString(1024)

微信返回的accRespFields域

字段名說(shuō)明必選類型備注
openidopenIdMString(64)
sub_openidsubOpenIdCString(64)
promotion_detail優(yōu)惠功能信息CString(4096)

示例1-支付寶全場(chǎng)優(yōu)惠券

請(qǐng)求報(bào)文:

{
    "req_data": {
        "out_trade_no": "TEST202202280003",
        "auth_code": "288576824003652810",
        "total_amount": "101",
        "location_info": {
            "request_ip": "127.0.0.1",
            "location": "+37.123456789,-121.123456789"
        },
        "subject": "測(cè)試",
        "merchant_no": "8222903XXXXX",
        "term_no": "A000XXXX",
        "notify_url": "www.test.com"
    },
    "req_time": "20220215152401",
    "version": "3.0"
}復(fù)制

響應(yīng)報(bào)文:

{
    "code": "DCP00000",
    "msg": "成功",
    "resp_time": "20220228111212",
    "resp_data": {
        "need_query": "0",
        "out_trade_no": "TEST202202280003",
        "settle_channel_type": "ALIPAY",
        "trade_no": "2022022833210000270002",
        "acc_merchant_trade_no": "2022022833210000270002",
        "acc_trade_no": "2022022822001405451403529459",
        "account_type": "ALIPAY",
        "total_amount": "101",
        "payer_amount": "1",
        "acc_settle_amount": "1",
        "acc_mdiscount_amount": null,
        "acc_discount_amount": null,
        "trade_time": "20220228111212",
        "acc_resp_fields": {
            "user_id": "2088622957692417",
            "alipay_store_id": null,
            "openid": null,
            "sub_openid": null,
            "up_iss_addn_data": null,
            "up_coupon_info": null,
            "fund_bill_list": "[{\"amount\":\"1.00\",\"fund_channel\":\"MDISCOUNT\"},{\"amount\":\"0.01\",\"fund_channel\":\"ALIPAYACCOUNT\"}]",
            "discount_goods_detail": null,
            "voucher_detail_list": "[{\"amount\":\"1.00\",\"id\":\"20220228000730024505098Q2ZLR\",\"merchant_contribute\":\"1.00\",\"name\":\"1.00元代金券\",\"other_contribute\":\"0.00\",\"template_id\":\"20220224000730012699006X2YNH\",\"type\":\"ALIPAY_BIZ_VOUCHER\"}]",
            "promotion_detail": null
        }
    }
}復(fù)制

示例2-支付寶單品券

請(qǐng)求報(bào)文:

{
    "req_data": {
        "out_trade_no": "TEST202202280009",
        "auth_code": "287636643163568892",
        "total_amount": "101",
        "location_info": {
            "request_ip": "127.0.0.1",
            "location": "+37.123456789,-121.123456789"
        },
        "subject": "測(cè)試",
        "merchant_no": "82229035XXXXXX",
        "term_no": "A000XXXX",
        "acc_busi_fields": {
            "goods_detail": "[{\"goods_id\":\"202202280001\",\"goods_name\":\"珍珠奶茶\",\"quantity\":\"1\",\"price\":\"1.01\"}]"
        }
    },
    "req_time": "20220215152401",
    "version": "3.0"
}復(fù)制

響應(yīng)報(bào)文:

{
    "code": "DCP00000",
    "msg": "成功",
    "resp_time": "20220228173410",
    "resp_data": {
        "need_query": "0",
        "out_trade_no": "TEST202202280009",
        "settle_channel_type": "ALIPAY",
        "trade_no": "2022022833210000340000",
        "acc_merchant_trade_no": "2022022833210000340000",
        "acc_trade_no": "2022022822001405451404118032",
        "account_type": "ALIPAY",
        "total_amount": "101",
        "payer_amount": "1",
        "acc_settle_amount": "1",
        "acc_mdiscount_amount": null,
        "acc_discount_amount": null,
        "trade_time": "20220228173410",
        "acc_resp_fields": {
            "user_id": "2088712458105450",
            "alipay_store_id": null,
            "openid": null,
            "sub_openid": null,
            "up_iss_addn_data": null,
            "up_coupon_info": null,
            "fund_bill_list": "[{\"amount\":\"1.00\",\"fund_channel\":\"MDISCOUNT\"},{\"amount\":\"0.01\",\"fund_channel\":\"ALIPAYACCOUNT\"}]",
            "discount_goods_detail": "[{\"goods_id\":\"202202280001\",\"goods_name\":\"珍珠奶茶\",\"discount_amount\":\"1.00\",\"voucher_id\":\"20220228000730024505098YV6RZ\",\"goods_num\":\"1.0\"}]",
            "voucher_detail_list": "[{\"amount\":\"1.00\",\"id\":\"20220228000730024505098YV6RZ\",\"merchant_contribute\":\"1.00\",\"name\":\"1.00元代金券\",\"other_contribute\":\"0.00\",\"template_id\":\"202202280007300129280079KOUX\",\"type\":\"ALIPAY_COMMON_ITEM_VOUCHER\"}]",
            "promotion_detail": null
        }
    }
}復(fù)制

示例3-支付寶口碑產(chǎn)品券

場(chǎng)景:實(shí)現(xiàn)的效果是:秘制豆?jié){-4905-單價(jià)6元 口碑領(lǐng)券后優(yōu)惠6元,先用支付寶口碑掃掃領(lǐng)券,5元購(gòu)買了秘制豆?jié){券,下單后使用支付寶錢包碼支付購(gòu)買秘制豆?jié){,訂單金額6元,實(shí)際支付金額為0(用了秘制豆?jié){券)
請(qǐng)求報(bào)文:

{
    "req_data": {
        "out_trade_no": "TEST202203030004",
        "auth_code": "289827863255999662",
        "total_amount": "600",
        "location_info": {
            "request_ip": "127.0.0.1",
            "location": "+37.123456789,-121.123456789"
        },
        "subject": "測(cè)試",
        "merchant_no": "822331058XXXXXXX",
        "term_no": "B264XXXXX",
        "acc_busi_fields": {
            "goods_detail": "[{\"goods_id\":\"4905\",\"goods_name\":\"秘制豆?jié){(熱)\",\"quantity\":\"1\",\"price\":\"6.00\"}]",
            "alipay_store_id": "2909"
        }
    },
    "req_time": "20220215152401",
    "version": "3.0"
}復(fù)制

響應(yīng)報(bào)文:

{
    "code": "DCP00000",
    "msg": "成功",
    "resp_time": "20220303151733",
    "resp_data": {
        "need_query": "0",
        "out_trade_no": "TEST202203030004",
        "settle_channel_type": "ALIPAY",
        "trade_no": "2022030333210000360023",
        "acc_merchant_trade_no": "2022030333210000360023",
        "acc_trade_no": "2022030322001438811448057041",
        "account_type": "ALIPAY",
        "total_amount": "600",
        "payer_amount": "0",
        "acc_settle_amount": "500",
        "acc_mdiscount_amount": null,
        "acc_discount_amount": null,
        "trade_time": "20220303151733",
        "acc_resp_fields": {
            "user_id": "2088xxxxxx4438816",
            "alipay_store_id": null,
            "openid": null,
            "sub_openid": null,
            "up_iss_addn_data": null,
            "up_coupon_info": null,
            "fund_bill_list": "[{\"amount\":\"1.00\",\"fund_channel\":\"MDISCOUNT\"},{\"amount\":\"5.00\",\"fund_channel\":\"ALIPAYACCOUNT\"}]",
            "discount_goods_detail": "[{\"goods_id\":\"4905\",\"goods_name\":\"秘制豆?jié){(熱)\",\"discount_amount\":\"6.00\",\"voucher_id\":\"202203030007300281380B7C5COQ\",\"goods_num\":\"1.0\"}]",
            "voucher_detail_list": "[{\"amount\":\"6.00\",\"id\":\"202203030007300281380B7C5COQ\",\"memo\":\"測(cè)試用,浦東機(jī)場(chǎng)店,定向投放,不在店鋪?lái)?yè)展示\",\"merchant_contribute\":\"6.00\",\"name\":\"【必點(diǎn)】秘制豆?jié){\",\"other_contribute\":\"0.00\",\"purchase_ant_contribute\":\"0.00\",\"purchase_buyer_contribute\":\"5.00\",\"purchase_merchant_contribute\":\"1.00\",\"template_id\":\"20220302000730017404006Z3HMI\",\"type\":\"ALIPAY_ITEM_VOUCHER\"}]",
            "promotion_detail": null
        }
    }
}復(fù)制

示例4-支付寶口碑代金券

場(chǎng)景:口碑領(lǐng)券后優(yōu)惠0.2元,0.1元購(gòu)買了0.2元代金券,購(gòu)買1.1元商品,實(shí)際支付了0.9元。
請(qǐng)求報(bào)文:

{
    "req_data": {
        "out_trade_no": "TEST202203030006",
        "auth_code": "288648118310343152",
        "total_amount": "110",
        "location_info": {
            "request_ip": "127.0.0.1",
            "location": "+37.123456789,-121.123456789"
        },
        "subject": "測(cè)試",
        "merchant_no": "822331058XXXXXXX",
        "term_no": "B264XXXXX",
        "acc_busi_fields": {
            "goods_detail": "[{\"goods_id\":\"1002\",\"goods_name\":\"蔥油拌面\",\"quantity\":\"1\",\"price\":\"1.10\"}]",
            "alipay_store_id": "2909"
        }
    },
    "req_time": "20220215152401",
    "version": "3.0"
}復(fù)制

響應(yīng)報(bào)文:

{
    "code": "DCP00000",
    "msg": "成功",
    "resp_time": "20220303152237",
    "resp_data": {
        "need_query": "0",
        "out_trade_no": "TEST202203030006",
        "settle_channel_type": "ALIPAY",
        "trade_no": "2022030333210000370026",
        "acc_merchant_trade_no": "2022030333210000370026",
        "acc_trade_no": "2022030322001428471449839391",
        "account_type": "ALIPAY",
        "total_amount": "110",
        "payer_amount": "90",
        "acc_settle_amount": "100",
        "acc_mdiscount_amount": null,
        "acc_discount_amount": null,
        "trade_time": "20220303152237",
        "acc_resp_fields": {
            "user_id": "2088102332328479",
            "alipay_store_id": null,
            "openid": null,
            "sub_openid": null,
            "up_iss_addn_data": null,
            "up_coupon_info": null,
            "fund_bill_list": "[{\"amount\":\"0.90\",\"fund_channel\":\"PCREDIT\"},{\"amount\":\"0.10\",\"fund_channel\":\"MDISCOUNT\"},{\"amount\":\"0.10\",\"fund_channel\":\"ALIPAYACCOUNT\"}]",
            "discount_goods_detail": null,
            "voucher_detail_list": "[{\"amount\":\"0.20\",\"id\":\"202203030007300247280AJ6XEH7\",\"memo\":\"拉卡拉 測(cè)試用,浦東機(jī)場(chǎng)店,定向投放,不在店鋪?lái)?yè)展示\",\"merchant_contribute\":\"0.20\",\"name\":\"商家代金券0.2元\",\"other_contribute\":\"0.00\",\"purchase_ant_contribute\":\"0.00\",\"purchase_buyer_contribute\":\"0.10\",\"purchase_merchant_contribute\":\"0.10\",\"template_id\":\"20220302000730017404006Z3KWE\",\"type\":\"ALIPAY_FIX_VOUCHER\"}]",
            "promotion_detail": null
        }
    }
}復(fù)制



The End