Maintainers
Pricing
Enterprise
More
More
Documentation
Try Live
Rankings
Install
Blog
Docs7
Ask
New
Add Docs
斗拱开放平台
https://paas.huifu.com/open/doc/lightning/#/api
Admin
斗拱开放平台是一个为开发者、服务商和商户提供API文档、技术规范、开发工具和业务指引的综合性平台，旨在帮助用户集成和开发相关服务。
Tokens:
17,483
Snippets:
52
Trust Score:
9.1
Update:
6 months ago
Context
Chat
Benchmark
78.5
Latest
Show doc for...
Code
Info
Show Results
Tokens:
Raw
Copy
Link
Tokens:
Raw
Copy
Link
### Create Trade Payment via SDK Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Initializes the merchant configuration and executes a trade payment request using the Huifu SDK. ```java public static void pay() throws Exception { BasePay.initWithMerConfig(OppsMerchantConfigDemo.getMerchantConfig()); TradePaymentCreateRequest request = new TradePaymentCreateRequest(); // 请求日期 request.setReqDate(DateTools.getCurrentDateYYYYMMDD()); // 请求流水号 request.setReqSeqId(SequenceTools.getReqSeqId32()); // 商户号 request.setHuifuId("6666000103334211"); // 商品描述 request.setGoodsDesc("支付宝Native"); // 交易类型 request.setTradeType("A_NATIVE"); // 交易金额 request.setTransAmt("0.01"); request.setDelayAcctFlag("N"); Map<String, Object> response = Factory.Payment.Common() .optional("method_expand", getMethodExpand(request.getTradeType())) .optional("terminal_device_data", getTerminalDeviceData()) .create(request); ObjectMapper objectMapper = JacksonUtils.getInstance(); System.out.println("返回数据:" + objectMapper.writeValueAsString(response)) } ``` -------------------------------- ### Subsidy Configuration Parameters Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Parameters used to define subsidy providers, account details, and fee coverage amounts. ```APIDOC ## Subsidy Configuration ### Description Parameters for configuring marketing subsidies and transaction fee coverage. ### Parameters - **huifu_id** (String) - Optional - Subsidy provider Huifu ID. - **user_type** (String) - Optional - Subsidy provider type (channel, merchant, agent, mertomer). - **acct_id** (String) - Optional - Marketing subsidy account number. - **amount** (String) - Optional - Subsidy amount in Yuan (min 0.01). - **allowance_fee_amt** (String) - Optional - Subsidy fee amount in Yuan. ``` -------------------------------- ### 聚合正扫异步返回参数 Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 聚合正扫交易完成后，系统会向商户配置的地址发送异步通知。报文包含公共返回参数及业务数据字段。 ```APIDOC ## 聚合正扫异步返回参数 ### Description 聚合正扫交易完成后，系统通过异步通知方式返回交易结果。报文分为公共返回参数和业务数据(resp_data)两部分。 ### 公共返回参数 - **resp_code** (String) - Required - 网关返回码，示例：00000000 - **resp_desc** (String) - Required - 网关返回信息，示例：交易成功[000] - **sign** (String) - Required - 签名信息 - **resp_data** (String) - Required - 返回业务数据(jsonObject) ### 业务数据 (resp_data) 参数 - **resp_code** (String) - Required - 业务响应码 - **resp_desc** (String) - Required - 业务响应信息 - **huifu_id** (String) - Required - 商户号 - **req_seq_id** (String) - Required - 请求流水号 - **req_date** (String) - Required - 请求日期 - **trans_type** (String) - Optional - 交易类型 (如 T_JSAPI, T_NATIVE, A_NATIVE 等) - **trans_stat** (String) - Optional - 交易状态 (S:成功, F:失败) - **trans_amt** (String) - Optional - 交易金额 - **pay_amt** (String) - Optional - 消费者实付金额 - **end_time** (String) - Optional - 支付完成时间 - **is_div** (String) - Required - 是否分账交易 (1:是, 0:否) - **is_delay_acct** (String) - Required - 是否延时交易 (1:是, 0:否) ### 响应示例 { "resp_code": "00000000", "resp_desc": "交易成功[000]", "sign": "...", "resp_data": { "resp_code": "00000000", "huifu_id": "6666000123123123", "trans_stat": "S", "trans_amt": "1.00" } } ``` -------------------------------- ### 聚合下单接口 Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 聚合支付将多种支付方式统一为一个下单API。接入前请根据不同支付方式查阅对应的产品介绍、开发指引和常见问题文档。 ```APIDOC ## 聚合下单接口 ### Description 聚合支付将多种支付方式统一为一个下单 API。接入前需了解不同支付方式的【产品介绍】、【开发指引】和【常见问题】文档。 ### Method POST ### Endpoint https://api.huifu.com/v4/trade/payment/create ### Parameters #### Query Parameters - **sys_id** (String) - Required - 渠道商/商户的huifu_id。示例值：6666000123120000 - **product_id** (String) - Required - 汇付分配的产品号。示例值：MCS - **sign** (String) - Required - 接口加签结果。长度：512。 - **data** (Json) - Required - 业务请求参数，具体值参考API文档。 ### Request Body 支持格式：JSON ### Response #### Success Response (200) - **field1** (type) - Description #### Response Example { "example": "response body" } ### Error Handling - 加签验签说明：请参考加签验签文档。 ``` -------------------------------- ### POST /payment/transaction Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Initiates a new payment transaction for a merchant. ```APIDOC ## POST /payment/transaction ### Description Initiates a payment transaction for various payment types including JSAPI, MiniApp, App, and Micropay for WeChat, Alipay, and UnionPay. ### Method POST ### Parameters #### Request Body - **req_date** (String) - Optional - Request date (yyyyMMdd) - **req_seq_id** (String) - Required - Unique request sequence ID - **huifu_id** (String) - Required - Merchant ID - **trade_type** (String) - Required - Transaction type (e.g., T_JSAPI, A_NATIVE, U_NATIVE) - **trans_amt** (String) - Required - Transaction amount in Yuan (e.g., 1000.00) - **goods_desc** (String) - Required - Description of goods - **remark** (String) - Optional - Merchant remark - **acct_id** (String) - Optional - Account ID - **time_expire** (String) - Optional - Transaction expiration time (yyyyMMddHHmmss) - **delay_acct_flag** (String) - Optional - Delay account flag (Y/N) - **fee_flag** (Integer) - Optional - Fee deduction flag (1: External, 2: Internal) - **limit_pay_type** (String) - Optional - Disabled payment methods - **channel_no** (String) - Optional - Channel number - **pay_scene** (String) - Optional - Scene type - **term_div_coupon_type** (String) - Optional - Coupon handling rule - **fq_mer_discount_flag** (String) - Optional - Merchant discount flag - **notify_url** (String) - Optional - Asynchronous notification URL - **method_expand** (String) - Required - JSON object string for transaction type expansion - **tx_metadata** (String) - Conditional - Collection of transaction capability extensions ``` -------------------------------- ### 聚合正扫解冻异步返回参数 Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 描述聚合正扫解冻操作完成后，系统异步推送的返回参数详情。 ```APIDOC ## 聚合正扫解冻异步返回参数 ### 参数 - **resp_code** (String) - 必填 - 业务返回码 - **resp_desc** (String) - 必填 - 业务返回描述 - **hf_seq_id** (String) - 必填 - 交易的汇付全局流水号 - **req_seq_id** (String) - 必填 - 交易请求流水号 - **req_date** (String) - 必填 - 交易请求日期，格式yyyyMMdd - **huifu_id** (String) - 必填 - 商户号 - **notify_type** (Integer) - 必填 - 通知类型，3：资金解冻通知 - **fund_freeze_stat** (String) - 必填 - 资金冻结状态，UNFREEZE：解冻 - **unfreeze_amt** (String) - 必填 - 解冻金额（元） - **freeze_time** (String) - 必填 - 冻结时间，格式yyyyMMddHHMMSS - **unfreeze_time** (String) - 必填 - 解冻时间，格式yyyyMMddHHMMSS ``` -------------------------------- ### Goods Detail Object Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Structure for defining individual items within an order. ```APIDOC ## Goods Detail Object ### Parameters - **goods_id** (String) - Required - Unique product identifier. - **goods_name** (String) - Required - Name of the product. - **price** (String) - Required - Unit price in Yuan. - **quantity** (String) - Required - Number of items. - **body** (String) - Optional - Product description. - **categories_tree** (String) - Optional - Category hierarchy separated by '|'. - **goods_category** (String) - Optional - Product category ID. - **show_url** (String) - Optional - Product display URL. ``` -------------------------------- ### Promotion Details Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Defines the structure for promotion details, including coupon and discount information. ```APIDOC ## Promotion Details ### Description Provides detailed information about promotions, including coupon IDs, names, types, amounts, and associated goods. ### Parameters #### Request Body Fields - **promotion_id** (String) - Required - ID of the coupon or discount. Example: 2345234235 - **name** (String) - Optional - Name of the promotion. Example: 八折券 - **scope** (String) - Optional - Scope of the promotion (GLOBAL/SINGLE). Example: GLOBAL - **type** (String) - Optional - Type of promotion (COUPON/DISCOUNT). Example: DISCOUNT - **amount** (String) - Required - Amount of the user's discount in Yuan. Example: 5.00 - **activity_id** (String) - Required - Batch ID configured in the merchant backend. Example: 458626534790131712 - **merchant_contribute** (String) - Optional - Amount contributed by the merchant in Yuan. Example: 10.00 - **other_contribute** (String) - Optional - Amount contributed by other parties in Yuan. Example: 20.00 - **goods_detail** (Array) - Optional - List of goods details. - **wxpay_contribute** (String) - Optional - Amount contributed by WeChat Pay in Yuan. Example: 20.00 - **original_other_contribute** (String) - Optional - Original amount contributed by WeChat's other parties in Yuan. Example: 20.00 ``` -------------------------------- ### Voucher and Fund Details Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Provides information on voucher usage and fund channels. ```APIDOC ## Voucher and Fund Details ### Description Includes details about the vouchers used in a transaction and the breakdown of funds from different channels. ### Parameters #### Request Body Fields - **voucher_detail_list** (Array) - Optional - List of voucher information used in the transaction. Example: "[{"id":"20170307000730026487005X1M6V","name":"全仓 5折优惠券"}]" - **fund_bill_list** (Array) - Optional - Information about the funds from each payment channel. Returned only if specified in query_options or if configured. - **buyer_id** (String) - Optional - Alipay unique user ID of the buyer. Example: 20880414938706770000 - **buyer_logon_id** (String) - Optional - Alipay account ID of the buyer. Example: carl.chen@huifu.com - **hb_fq_num** (String) - Optional - Number of Huabei installments. Example: 3 - **hb_fq_seller_percent** (String) - Optional - Percentage of fees borne by the seller. Example: 0.9 - **notify_time** (String) - Optional - Notification sending time in yyyy-MM-dd HH:mm:ss format. Example: 2022-10-11 10:12:24 - **app_id** (String) - Optional - Alipay application ID. Example: 2021002122659346 ``` -------------------------------- ### Goods Details Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Specifies parameters for individual item details within a promotion. ```APIDOC ## Goods Details ### Description Details information for individual goods within a promotion, including their ID, price, quantity, and discount. ### Parameters #### Request Body Fields - **goods_id** (String) - Required - Product code. Example: 6934572310301 - **goods_remark** (String) - Optional - Remark for the goods. Example: 商品备注 - **discount_amount** (String) - Required - Total discount amount for the goods in Yuan. Example: 20.00 - **quantity** (String) - Required - Quantity of the goods purchased. Example: 10 - **price** (String) - Required - Price per unit in Yuan, after merchant discounts. Example: 99.00 ``` -------------------------------- ### Activity Details Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Defines the parameters for activity-related operations. ```APIDOC ## Activity Details ### Description Provides details about an activity, including its total limit, status, and creation information. ### Parameters #### Request Body Fields - **total_limit_amt** (String) - Required - Total subsidy amount for the activity. Example: 10.00 - **status** (String) - Required - Indicates if the activity is valid (1: active, 0: inactive). Example: 1 - **human_flag** (String) - Required - Indicates if the operation is manual (Y) or automatic (N). Example: Y - **activity_id** (String) - Required - The unique identifier for the activity. Example: 223402342 - **activity_name** (String) - Optional - A description of the activity. Example: 开业大促 - **create_by** (String) - Required - The user who created the activity. Example: Lg2022022201394910571 - **create_time** (String) - Required - The timestamp when the activity was created. Example: 2022-04-14 22:00:30 - **update_time** (String) - Required - The timestamp when the activity was last updated. Example: 2022-04-14 23:00:30 ``` -------------------------------- ### Goods Details Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Parameters for specifying details of individual goods within a promotion. ```APIDOC ## Goods Details ### Description Information about individual goods included in a promotion, such as product code, quantity, price, and discount amounts. ### Parameters #### Request Body - **goods_id** (String) - Required - Product code. Example: 6934572310301 - **goods_remark** (String) - Optional - Remark field for the goods. Example: Goods remark - **discount_amount** (String) - Required - Total discount amount for the item. Example: 20.00 - **quantity** (String) - Required - Quantity of the item purchased. Example: 10 - **price** (String) - Required - Price per item after merchant discounts. Example: 99.00 ``` -------------------------------- ### UnionPay and Fee Splitting Models Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Data structures for UnionPay discount information and transaction fee splitting. ```APIDOC ## UnionPay Discount Info ### Parameters - **spnsrId** (String) - Y - 出资方 - **type** (String) - Y - 项目类型 (DD01, CP01, CP02) - **offstAmt** (String) - Y - 抵消交易金额 ## Fee Splitting ### Parameters - **total_split_fee_amt** (String) - N - 分账手续费总金额(元) - **split_fee_flag** (Integer) - Y - 分账手续费扣款标志 (1: 外扣, 2: 内扣) - **split_fee_details** (Array) - Y - 分账手续费信息 ``` -------------------------------- ### Promotion Details Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Detailed parameters for promotional offers, including coupon and discount information. ```APIDOC ## Promotion Details ### Description Detailed information about promotional offers, including coupon IDs, names, types, amounts, and associated activities. ### Parameters #### Request Body - **promotion_id** (String) - Required - ID of the coupon or discount. Example: 2345234235 - **name** (String) - Optional - Name of the promotion. Example: 20% off coupon - **scope** (String) - Optional - Scope of the promotion: GLOBAL, SINGLE. Example: GLOBAL - **type** (String) - Optional - Type of promotion: COUPON, DISCOUNT. Example: DISCOUNT - **amount** (String) - Required - Amount of the discount/coupon. Example: 5.00 - **activity_id** (String) - Required - Batch ID configured in the merchant backend. Example: 458626534790131712 - **merchant_contribute** (String) - Optional - Merchant's contribution amount. Example: 10.00 - **other_contribute** (String) - Optional - Other parties' contribution amount. Example: 20.00 - **wxpay_contribute** (String) - Optional - WeChat Pay's contribution amount. Example: 20.00 - **original_other_contribute** (String) - Optional - WeChat transaction's other parties' contribution amount. Example: 20.00 ``` -------------------------------- ### Aggregated Reverse Scan Asynchronous Return Parameters Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 This section describes the asynchronous return parameters for the aggregated reverse scan API. The response structure varies based on whether the merchant is configured for direct connection (wx_zl_conf) or operates in an inter-connected mode. ```APIDOC ## Aggregated Reverse Scan Asynchronous Return Parameters Asynchronous return messages have two distinct types: inter-connected mode and direct-connected mode. If the merchant's business is configured for WeChat direct connection (wx_zl_conf) during activation, it falls under direct-connected mode; otherwise, it is inter-connected mode. ### Common Return Parameters | Parameter | Chinese Name | Definition | Length | Required | Description | |---|---|---|---|---|---| | resp_code | Gateway Return Code | String | 8 | Y | Example: 00000000 | | resp_desc | Gateway Return Information | String | 512 | Y | Example: Transaction successful [000] | | sign | Signature | String | 512 | Y | API signature and verification instructions | | resp_data | Return Business Data | String | | Y | jsonObject | ### Parameters (resp_data) | Parameter | Chinese Name | Definition | Length | Required | Description | |---|---|---|---|---|---| | resp_code | Business Response Code | String | 8 | Y | Business return code | | resp_desc | Business Response Information | String | 256 | Y | Business return description | | huifu_id | Merchant ID | String | 32 | Y | Example: 6666000123123123 | | req_seq_id | Request Serial Number | String | 128 | Y | Passed during transaction, returned as is; Example: rQ2021121311173944134649875651 | | req_date | Request Date | String | 8 | Y | Passed during transaction, returned as is; Example: 20220905 | | trans_type | Transaction Type | String | 16 | N | T_MICROPAY: WeChat reverse scan<br>A_MICROPAY: Alipay reverse scan<br>U_MICROPAY: UnionPay QR code reverse scan<br>D_MICROPAY: Digital RMB reverse scan<br>Example: T_MICROPAY | | hf_seq_id | Global Serial Number | String | 128 | N | Example: 00470topo1A221019132207P068ac1362af00000 | | out_trans_id | Transaction Order Number on User Bill | String | 64 | N | Example: 092021091922001451301445517582; See User Bill Description | | party_order_id | Merchant Order Number on User Bill | String | 64 | N | Example: 03232109190255105603561; See User Bill Description | | trans_amt | Transaction Amount | String | 14 | N | Unit: Yuan, must retain two decimal places; Example: 1.00 | | pay_amt | Consumer Actual Payment Amount | String | 14 | N | Unit: Yuan; Example: 1.00 | | settlement_amt | Settlement Amount (Yuan) | String | 16 | N | Actual amount to be settled (order amount minus discount amount), retain two decimal places; Example: 1000.00 | | end_time | Payment Completion Time | String | 14 | N | Format yyyyMMddHHmmss; Example: 20091225091010 | | acct_date | Account Entry Date | String | 8 | N | Format yyyyMMdd; Example: 20091225 | | trans_stat | Transaction Status | String | 1 | N | S: Success, F: Failure; Transaction status is based on this field. Example: S | | fee_flag | Fee Deduction Flag | Integer | 1 | N | 1: External deduction, 2: Internal deduction; Example: 2 | | fee_formula_infos | Fee Rate Information | Array | | N | Returned when transaction is successful, contains fee rate information | | fee_amount | Fee Amount | String | 16 | N | Unit: Yuan, retain two decimal places; Example: 1.00 | | trans_fee_allowance_info | Fee Subsidy Information | Object | | N | JSON format; Refer to "Bank Subsidy Fee" | | combinedpay_data | Subsidy Payment Information | String | | N | JSONArray string, refer to "Subsidy Payment Information" | | combinedpay_data_fee_info | Subsidy Payment Fee Information | String | | N | JSONObject string | | debit_type | Debit/Credit Identification | String | 1 | N | D-Debit card, C-Credit card, 0-Other; Example: D | | is_div | Is Dividend Transaction | String | 1 | Y | 1: Dividend transaction, 0: Non-dividend transaction; Example: 1 | | acct_split_bunch | Dividend Object | Object | | N | JSONObject string | | is_delay_acct | Is Delayed Transaction | String | 1 | Y | 1: Delayed, 0: Non-delayed; Example: 1 | | wx_user_id | WeChat User Unique Identifier | String | 128 | N | Example: W6NYVcMwXDfAT+3LXuLSMx+UH5AXx1kG7JzTiTEomdk= | | wx_response | WeChat Return Response Message | Object | | N | JSONObject string | | alipay_response | Alipay Return Response Message | Object | | N | JSONObject string | | dc_response | Digital Currency Return Response Message | Object | | N | JSONObject string | | unionpay_response | UnionPay Return Response Message | Object | | N | JSONObject string | | device_type | Terminal Type | String | 2 | N | 01-Smart POS<br>02-QR Code POS<br>03-Cloud Speaker<br>04-Tabletop Card<br>05-Cloud Printer<br>06-Face Scan Device<br>07-Cash Register<br>08-Cashier Assistant<br>09-Traditional POS<br>10-All-in-One Speaker<br>11-Virtual Terminal<br>Example: 01 | | mer_dev_location | Merchant Terminal Location | Object | | N | Merchant terminal location information, JSONObject string | | bank_message | Channel Return Description | String | 200 | N | Example: Success [0000000] | | remark | Remark | String | 255 | N | Returned as is; Example: Remark | | fq_channels | Installment Asset Channel | String | 20 | N | Huabei installment function, represents the preferred asset type; alipayfq_cc: indicates credit card installment.<br>Example: alipayfq_cc | | notify_type | Notification Type | Integer | 1 | N | 1: Channel notification, 2: Account notification; Example: 1 | | split_fee_info | Split Fee Information | Object | | N | Split fee information | | atu_sub_mer_id | ATU Real Merchant ID | String | 32 | N | Example: 411111141 | | devs_id | Huifu Terminal ID | String | 32 | N | Returned when transacting with Huifu equipment; Example: 660035730311200000 | ### Fee Formula Information (fee_formula_infos) | Parameter | Chinese Name | Definition | Length | Required | Description | |---|---|---|---|---|---| | fee_formula | Fee Calculation Formula | String | 512 | Y | Example: AMT*0.003 | | fee_type | Fee Type | String | 32 | Y | TRANS_FEE: Transaction Fee; ACCT_FEE: Combined Payment Account Subsidy Fee<br>Example: ACCT_FEE | | huifu_id | Merchant ID | String | 32 | N | huifuId of the subsidy account when subsidizing the combined payment account; Example: 6666000123123123 | ### Subsidy Payment Fee Information (combinedpay_data_fee_info) | Parameter | Chinese Name | Definition | Length | Required | Description | |---|---|---|---|---|---| | receivable_fee_amt | Merchant Receivable Fee | String | 16 | Y | Example: 5.00 | | actual_fee_amt | Merchant Actual Fee | String | 16 | Y | Example: 4.00 | | allowance_fee_amt | Subsidy Fee | String | 16 | Y | Example: 1.00 | | allowance_type | Subsidy Type | String | 10 | N | 0: No subsidy, default empty<br>1: Subsidy<br>2: Partial Subsidy<br>3: Full Subsidy (after discount)<br>4: Partial Subsidy (after discount)<br>Example: 2 | | no_allowance_desc | Reason for No Subsidy | String | 128 | N | 1: Huishoukuan Product (HSK) UnionPay QR code transaction amount exceeds 1000 yuan, no subsidy<br>2: Quota exhausted<br>3: Outside validity period<br>4: Activity does not exist<br>5: Fee amount is 0, no subsidy<br>6: Top-up discount<br>7: Insufficient quota<br>8: Fee back-calculation<br>9: Did not reach the starting subsidy amount<br>Example: 2 | | cur_allowance_config_infos | Fee Subsidy Activity Details | Object | | N | Returned by the subsidy system, returned as is by Dou Gong | ### Current Subsidy Activity Details (cur_allowance_config_infos) | Parameter | Chinese Name | Definition | Length | Required | Description | |---|---|---|---|---|---| | acct_id | Store | String | 64 | N | Example: sh002 | | merchant_group | Merchant ID | String | 64 | N | Example: 6666000123120000 | | allowance_sys | Subsidy Provider | String | 64 | Y | 1: Bank, 2: Service Provider, 3: Huilaimi; Example: 1 | | allowance_sys_id | Subsidy Provider ID | String | 64 | Y | ID corresponding to the subsidy provider; Example: 6666000123120000 | | is_delay_allowance | Subsidy Type | String | 2 | Y | 1: Actual subsidy, 2: Back-dated subsidy, default is actual subsidy; Example: 1 | | market_id | Custom Activity ID | String | 64 | Y | Example: ISFE00232 | | market_name | Custom Activity Name | String | 128 | N | Example: Grand Opening Promotion | | market_desc | Custom Activity Description | String | 64 | N | Example: New Store Grand Opening Promotion | | start_time | Activity Start Time | String | 8 | Y | Format yyyyMMdd; Example: 20220909 | | end_time | Activity End Time | String | 8 | Y | Format yyyyMMdd; Example: 20220911 | | pos_debit_limit_amt | POS Debit Card Subsidy Limit | String | 16 | Y | Example: 2.00 | | pos_credit_limit_amt | POS Credit Card Subsidy Limit | String | 16 | Y | Example: 5.00 | | pos_limit_amt | POS Subsidy Limit | String | 16 | Y | Example: 4.00 | | qr_limit_amt | QR Code Subsidy Limit | String | 16 | Y | Example: 1.00 | ``` -------------------------------- ### 聚合正扫业务返回码 Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 定义了聚合正扫业务处理过程中可能返回的业务状态码及对应的错误描述。 ```APIDOC ## 聚合正扫业务返回码 | 返回码 | 返回描述 | |---|---| | 00000000 | 交易受理成功 | | 00000100 | 下单成功 | | 10000000 | 参数校验错误（如产品号、交易类型、长度、格式等） | | 20000000 | 重复交易 | | 21000000 | 手续费相关参数校验错误 | | 22000000 | 产品号或商户状态异常 | | 22000002 | 商户信息不存在或状态异常 | | 22000003 | 账户信息不存在 | | 22000004 | 权限未开通 | | 22000005 | 分账或贴息配置错误 | | 23000003 | 交易金额不足或优惠金额异常 | | 23000004 | 交易类型不支持 | | 90000000 | 业务执行失败（如余额不足、功能关闭、限额、风险交易） | | 91111119 | 通道异常 | | 98888888 | 系统错误 | ``` -------------------------------- ### Subsidy Parameters Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Parameters related to subsidy amounts and activity status. ```APIDOC ## Subsidy Parameters ### Description Parameters for defining subsidy amounts, activity status, and related information. ### Parameters #### Request Body - **pos_debit_limit_amt** (String) - Required - pos debit card subsidy amount. Example: 2.00 - **pos_credit_limit_amt** (String) - Required - pos credit card subsidy amount. Example: 5.00 - **pos_limit_amt** (String) - Required - pos subsidy amount. Example: 4.00 - **qr_limit_amt** (String) - Required - QR code subsidy amount. Example: 1.00 - **total_limit_amt** (String) - Required - Total activity subsidy amount. Example: 10.00 - **status** (String) - Required - Activity status: 1: Active, 0: Inactive. Example: 1 - **human_flag** (String) - Required - Manual operation flag: N: Automatic, Y: Manual. Example: Y - **activity_id** (String) - Required - Activity ID. Example: 223402342 - **activity_name** (String) - Optional - Activity description. Example: Grand Opening Promotion - **create_by** (String) - Required - Creator. Example: Lg2022022201394910571 - **create_time** (String) - Required - Creation time. Example: 2022-04-14 22:00:30 - **update_time** (String) - Required - Update time. Example: 2022-04-14 23:00:30 ``` -------------------------------- ### Account Information Details Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Parameters for account information, including split details. ```APIDOC ## Account Information Details ### Description Details regarding account information, including split payment specifics. ### Parameters #### Request Body - **acct_infos** (Array) - Required - Array of account details for split payments. - **div_amt** (String) - Required - Split amount in Yuan, with two decimal places. Minimum 0.01. Example: 1.00 - **huifu_id** (String) - Required - Huifu ID of the split recipient. Example: 6666000123120001 - **acct_date** (String) - Optional - Accounting date. Example: 20220909 ``` -------------------------------- ### Transaction and Coupon Data Models Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Definitions for transaction fields, coupon details, and payment channel information. ```APIDOC ## Transaction Fields ### Parameters - **out_biz_no** (String) - N - 商户业务号 - **invoice_amount** (String) - N - 开票金额 - **buyer_pay_amount** (String) - N - 付款金额 - **subject** (String) - N - 订单标题 - **body** (String) - N - 商品描述 - **gmt_create** (String) - N - 交易创建时间 ## Coupon Information ### Parameters - **id** (String) - Y - 券id - **name** (String) - Y - 券名称 - **type** (String) - Y - 券类型 (ALIPAY_FIX_VOUCHER, ALIPAY_DISCOUNT_VOUCHER, ALIPAY_ITEM_VOUCHER) - **amount** (String) - Y - 优惠券面额 - **merchant_contribute** (String) - N - 商家出资 - **other_contribute** (String) - N - 其他出资方出资金额 ``` -------------------------------- ### Digital Currency and Payment Channel Models Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Data structures for digital currency transactions (ICBC/PSBC) and payment channel details. ```APIDOC ## Digital Currency (ICBC) ### Parameters - **merchant_id** (String) - N - 商户号 - **term_id** (String) - N - 终端号 - **trade_type** (String) - N - 交易类型 - **openid** (String) - N - 用户标识 - **coupon_list** (Array) - N - 代金券集合 ## Digital Currency (PSBC) ### Parameters - **creditorWalletName** (String) - N - 收款钱包名称 - **creditorWalletType** (String) - N - 收款钱包类型 (WT01, WT02, WT09, WT10) - **debtorWalletName** (String) - N - 付款钱包名称 - **businessType** (String) - N - 支付类型 (O, I) ``` -------------------------------- ### Voucher and Fund Channel Data Structures Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Definitions for voucher details, fund bill lists, and buyer information used in transaction responses. ```APIDOC ## Voucher Detail Object ### Parameters - **id** (String) - Required - 券id - **name** (String) - Required - 券名称 - **type** (String) - Required - 券类型 (ALIPAY_FIX_VOUCHER, ALIPAY_DISCOUNT_VOUCHER, ALIPAY_ITEM_VOUCHER) - **amount** (String) - Required - 优惠券面额 - **merchant_contribute** (String) - Optional - 商家出资 - **other_contribute** (String) - Optional - 其他出资方出资金额 ## Fund Bill Object ### Parameters - **bank_code** (String) - Optional - 银行卡支付时的银行代码 - **amount** (String) - Optional - 该支付工具类型所使用的金额 - **fund_channel** (String) - Optional - 交易使用的资金渠道 - **fund_type** (String) - Optional - 渠道所使用的资金类型 (DEBIT_CARD, CREDIT_CARD, MIXED_CARD) - **real_amount** (String) - Optional - 渠道实际付款金额 ## Buyer Information ### Parameters - **buyer_id** (String) - Optional - 买家的支付宝唯一用户号 - **buyer_logon_id** (String) - Optional - 买家支付宝账号 - **hb_fq_num** (String) - Optional - 花呗分期数 - **hb_fq_seller_percent** (String) - Optional - 卖家承担的手续费百分比 ``` -------------------------------- ### Alipay Payment Parameters Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Detailed breakdown of parameters used for Alipay payment requests, including product details, business extensions, and identity verification. ```APIDOC ## Alipay Payment Parameters ### Description This section defines the parameters required for configuring Alipay payment requests, including product lists, business-specific parameters, and buyer identity verification settings. ### Parameters #### Goods Details - **goods_id** (String) - Required - 商品的编号 - **goods_name** (String) - Required - 商品名称 - **price** (String) - Required - 商品单价(元) - **quantity** (String) - Required - 商品数量 - **body** (String) - Optional - 商品描述信息 - **categories_tree** (String) - Optional - 商品类目树 - **show_url** (String) - Optional - 商品的展示地址 - **goods_category** (String) - Optional - 商品类目 #### Business Extension Parameters - **card_type** (String) - Optional - 卡类型 - **food_order_type** (String) - Optional - 支付宝点餐场景类型 - **hb_fq_num** (String) - Optional - 花呗分期数 - **hb_fq_seller_percent** (String) - Optional - 花呗卖家手续费百分比 - **fq_channels** (String) - Optional - 信用卡分期资产方式 - **parking_id** (String) - Optional - 停车场id - **sys_service_provider_id** (String) - Optional - 系统商编号 #### Identity Verification Parameters - **name** (String) - Optional - 姓名 - **mobile** (String) - Optional - 手机号 - **cert_type** (String) - Optional - 证件类型 - **cert_no** (String) - Optional - 证件号 - **min_age** (String) - Optional - 允许的最小买家年龄 - **fix_buyer** (String) - Optional - 是否强制校验付款人身份信息 - **need_check_info** (String) - Optional - 是否强制校验身份信息 #### Transaction Parameters - **alipay_store_id** (String) - Optional - 支付宝的店铺编号 - **buyer_id** (String) - Optional - 买家的支付宝唯一用户号 - **buyer_logon_id** (String) - Optional - 买家支付宝账号 - **seller_id** (String) - Optional - 卖家支付宝用户号 - **merchant_order_no** (String) - Optional - 商户原始订单号 - **operator_id** (String) - Optional - 商户操作员编号 - **product_code** (String) - Optional - 销售产品码 - **subject** (String) - Optional - 订单标题 - **store_name** (String) - Optional - 商家门店名称 - **op_app_id** (String) - Optional - 小程序应用的appid - **ali_business_params** (String) - Optional - 商户业务信息 ``` -------------------------------- ### Account Information Details Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Provides details for account information, including split details. ```APIDOC ## Account Information Details ### Description Contains details for account information, including split details for transactions. ### Parameters #### Request Body Fields - **acct_infos** (Array) - Required - An array of account split details. - **div_amt** (String) - Required - Split amount in Yuan, with two decimal places. Minimum value is 0.01. Example: 1.00 - **huifu_id** (String) - Required - Huifu ID of the split recipient. Example: 6666000123120001 - **acct_date** (String) - Optional - Account date in YYYYMMDD format. Example: 20220909 ``` -------------------------------- ### Fee Splitting Parameters Source: https://paas.huifu.com/open/doc/lightning/#/api/%E8%81%9A%E5%90%88%E6%94%AF%E4%BB%98%E4%B8%8B%E5%8D%95 Parameters required for configuring fee splitting during transaction processing. ```APIDOC ### Fee Splitting Parameters - **split_fee_amt** (String) - Required - 分账手续费金额(元), 示例值：0.10 - **split_fee_huifu_id** (String) - Required - 分账手续费承担方商户号, 示例值：6666000123120001 - **split_fee_acct_id** (String) - Optional - 分账手续费承担方账号, 示例值：F00598600 ```
