当面付扩展功能
花呗分期接入
花呗分期接口列表
| 接口英文名 | 接口中文名 |
|---|---|
| alipay.trade.pay | 统一收单交易支付接口 |
| alipay.trade.create | 统一收单交易创建接口 |
| alipay.trade.precreate | 统一收单线下交易预创建 |
标准收银台模式
准入条件
单通道模式
"extend_params" :{ "hb_fq_num" : "3" , "hb_fq_seller_percent" : "100" }参数说明
准入条件
优惠金额
限制订单参与优惠的金额
| 参数名 | 参数说明 |
|---|---|
| discountable_amount | 可优惠金额。其中如果需要不可优惠金额，可通过订单总额 total_amount 减去可优惠金额 discountable_amount 自动获取。 |
获取优惠情况下的各级金额
| 参数名 | 参数说明 |
|---|---|
| total_amount | 订单总金额。与请求中的订单金额一致。 |
| receipt_amount | 实收金额。商家实际入账的金额（扣手续费之前）。 |
| buyer_pay_amount | 用户实付金额。建议打印在小票上避免退款时出现纠纷。 |
| invoice_amount | 开票金额。快速告知商家应该给用户开多少钱发票。 |
各级金额关系
案例分析
指定收款支付宝账号
商品信息同步
1.
**注意：**商品信息通过付款码支付的交易支付接口 alipay.trade.pay 和扫码支付的交易预下单接口 alipay.trade.precreate 中 goods_detail 参数传入，此参数为数据集，包含几个子参数，以 JSON 列表的形式支持同时传入多个商品。
| 子参数名称 | 子参数说明 |
|---|---|
| goods_id | 商家自定义的商品编号，需要与单品活动中配置的商品编号一致。请在商家维度保持商品编号唯一，并与商品 名称保持一对一关系。 |
| goods_name | 商家自定义的商品名称，请不要传入如外卖商品/打折商品等无实际意义的商品名称。如果有商品有多个规格，可在商品名称中包含，如海飞丝（350ml）。注意编码格式与调用接口指定的编码一致。 |
| quantity | 本次交易购买的商品数量。 |
| price | 商品单价。单位元，商品优惠前的价格。商品单价 x 数量的累加金额＝订单总金额（不做强行校验，但可能影响单品相关返佣） |
多门店应用
小票打印
门店收银系统打印收银小票规范
必须包含内容
建议包含内容
小票示例
返佣
1.
1.
"extend_params":{"sys_service_provider_id":"2088511833207846"}package com.java.sdk.demo;
import com.alipay.v3.ApiException;
import com.alipay.v3.ApiClient;
import com.alipay.v3.util.model.AlipayConfig;
import com.alipay.v3.Configuration;
import com.alipay.v3.api.AlipayTradeApi;
import com.alipay.v3.model.*;
import java.io.File;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public class AlipayTradeApiPay {
public static void main(String[] args) throws ApiException {
ApiClient defaultClient = Configuration.getDefaultApiClient();
// 初始化alipay参数（全局设置一次）
AlipayConfig alipayConfig = new AlipayConfig();
alipayConfig.setServerUrl("https://openapi.alipay.com");
alipayConfig.setAppId("<-- 请填写您的AppId，例如：2019091767145019 -->");
alipayConfig.setPrivateKey("<-- 请填写您的应用私钥，例如：MIIEvQIBADANB ... ... -->");
alipayConfig.setAlipayPublicKey("<-- 请填写您的支付宝公钥，例如：MIIBIjANBg... -->");
defaultClient.setAlipayConfig(alipayConfig);
AlipayTradeApi api = new AlipayTradeApi();
AlipayTradePayModel data = new AlipayTradePayModel();
ExtendParams extendParams = new ExtendParams();
extendParams.setSysServiceProviderId("2088511833207846");
extendParams.setSpecifiedSellerName("XXX的跨境小铺");
extendParams.setCardType("S0JP0000");
data.setExtendParams(extendParams);
BusinessParams businessParams = new BusinessParams();
businessParams.setMcCreateTradeIp("127.0.0.1");
data.setBusinessParams(businessParams);
PromoParam promoParams = new PromoParam();
promoParams.setActualOrderTime("2018-09-25 22:47:33");
data.setPromoParams(promoParams);
data.setOutTradeNo("20150320010101001");
data.setProductCode("FACE_TO_FACE_PAYMENT");
data.setOperatorId("yx_001");
List<GoodsDetail> goodsDetail = new ArrayList<GoodsDetail>();
GoodsDetail goodsDetail0 = new GoodsDetail();
goodsDetail0.setQuantity(1);
goodsDetail0.setPrice("2000");
goodsDetail0.setGoodsCategory("34543238");
goodsDetail0.setCategoriesTree("124868003|126232002|126252004");
goodsDetail0.setGoodsId("apple-01");
goodsDetail0.setShowUrl("http://www.alipay.com/xxx.jpg");
goodsDetail0.setGoodsName("ipad");
goodsDetail.add(goodsDetail0);
data.setGoodsDetail(goodsDetail);
data.setTerminalId("NJ_T_001");
List<String> queryOptions = new ArrayList<String>();
queryOptions.add("fund_bill_list");
queryOptions.add("voucher_detail_list");
queryOptions.add("discount_goods_detail");
data.setQueryOptions(queryOptions);
data.setSellerId("2088102146225135");
data.setAuthCode("28763443825664394");
data.setScene("bar_code");
data.setSubject("Iphone6 16G");
data.setTotalAmount("88.88");
data.setStoreId("NJ_001");
try {
AlipayTradePayResponseModel response = api.pay(data);
} catch (ApiException e) {
AlipayTradePayDefaultResponse errorObject = (AlipayTradePayDefaultResponse) e.getErrorObject();
System.out.println("调用失败:" + errorObject);
}
}
}1.
修改于 2023-11-20 02:35:36