文档中心 > API类目 > AliOS支付API

yunos.banmapay.paymentprod.trade.createandpay (创建交易并支付)

创建交易并支付

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
trade_create_and_pay_request TradeCreateAndPayRequest 必须 创建交易并支付入参
  • └ sp_merchant_id
  • String
  • 必须
  • hangzhoubanma
  • 商户id
  • └ can_retry_pay
  • Number
  • 可选
  • 1
  • 失败后是否可重试支付,0-不可以,1-可以
  • └ replenish_detail
  • String
  • 可选
  • [{"key":"优惠id", "name":"优惠名称", "type":"优惠类型", "amount":"优惠金额 (单位:分)", "power":"抵扣电量"}]
  • 补差详情,json数组
  • └ biz_code
  • String
  • 必须
  • CHARGING
  • 业务code
  • app_info
  • AppInfo
  • 必须
  • app信息
  • └ app_version
  • String
  • 可选
  • V1.0.0
  • app版本号
  • └ app_type
  • String
  • 必须
  • NATIVE
  • 应用类型
  • └ app_name
  • String
  • 必须
  • 飞凡小程序
  • 应用名称
  • └ app_id
  • String
  • 必须
  • wx14d31484a3b5afd
  • 客户端应用appId
  • └ app_user_id
  • String
  • 可选
  • oQxPU5GHX9P7I-wJac5MUtb7YBm8
  • 用户id
  • └ tenant_code
  • String
  • 必须
  • test
  • 租户code
  • └ buyer_id
  • String
  • 必须
  • 7793875962802158
  • 买家账号id
  • └ trade_product_code
  • String
  • 必须
  • NORMAL
  • 交易产品码
  • device_info
  • DeviceInfo
  • 必须
  • 设备信息
  • └ device_type
  • String
  • 必须
  • MOBILE
  • 设备类型
  • └ device_os
  • String
  • 必须
  • IOS
  • 设备操作系统
  • └ biz_order_desc
  • String
  • 可选
  • 二手车鉴定报告
  • 业务订单描述
  • └ total_amount
  • Number
  • 必须
  • 1000
  • 交易总金额,单位:分
  • └ biz_order_id
  • String
  • 必须
  • 7D7LCF5230329183752914197006
  • 业务订单号或业务订单流水号
  • └ pay_notify_url
  • String
  • 可选
  • https://xxx.xx.com/xx
  • 支付回调通知地址
  • └ biz_order_title
  • String
  • 必须
  • 二手车鉴定报告
  • 业务订单标题
  • └ pay_method_code
  • String
  • 必须
  • mini_program_pay_2
  • 支付方式code
  • └ buyer_type_code
  • String
  • 必须
  • AliOS
  • 买家账号类型
  • └ replenish_amount
  • Number
  • 可选
  • 500
  • 交易补差金额,单位:分
  • └ settlement_props
  • String
  • 可选
  • {"type":"ASSIGN", "royaltyEntities":[{"accountType":"1", "accountId":"hangzhoubanma", "amount":"700"},{"accountType":"2", "accountId":"banshu", "amount":"300"}]}
  • 结算信息,json字符串
  • └ extra_props
  • String
  • 可选
  • {"originalBizOrderId":"7D7LCF5230329183752914197006"}
  • 扩展信息,json字符串
  • └ trade_expiry_time
  • Date
  • 可选
  • 2023-07-24 19:24:41
  • 交易失效时间 (绝对时间)

响应参数

名称 类型 示例值 描述
result BanmaPayResponse 接口响应结果
  • data
  • TradeCreateAndPayResponseData
  • 业务数据
  • └ extra_data
  • String
  • {"payTokenType":"alipay_mini_program", "payTokenValue":"746588373626", "payTokenExpiryMillis":"1688538823000"}
  • 扩展信息
  • └ trade_id
  • String
  • trade20230621272071700278059008
  • 交易订单号
  • └ trade_status
  • String
  • trade_processing
  • 交易状态
  • └ error_code
  • String
  • SYSTEM_ERROR
  • 错误码
  • └ error_msg
  • String
  • 系统异常,请稍后重试
  • 错误信息
  • └ success
  • String
  • true
  • 接口处理是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
YunosBanmapayPaymentprodTradeCreateandpayRequest req = new YunosBanmapayPaymentprodTradeCreateandpayRequest();
YunosBanmapayPaymentprodTradeCreateandpayRequest.TradeCreateAndPayRequest obj1 = new YunosBanmapayPaymentprodTradeCreateandpayRequest.TradeCreateAndPayRequest();
obj1.setSpMerchantId("hangzhoubanma");
obj1.setCanRetryPay(1L);
obj1.setReplenishDetail("[{\"key\":\"优惠id\", \"name\":\"优惠名称\", \"type\":\"优惠类型\", \"amount\":\"优惠金额 (单位:分)\", \"power\":\"抵扣电量\"}]");
obj1.setBizCode("CHARGING");
YunosBanmapayPaymentprodTradeCreateandpayRequest.AppInfo obj2 = new YunosBanmapayPaymentprodTradeCreateandpayRequest.AppInfo();
obj2.setAppVersion("V1.0.0");
obj2.setAppType("NATIVE");
obj2.setAppName("飞凡小程序");
obj2.setAppId("wx14d31484a3b5afd");
obj2.setAppUserId("oQxPU5GHX9P7I-wJac5MUtb7YBm8");
obj1.setAppInfo(obj2);
obj1.setTenantCode("test");
obj1.setBuyerId("7793875962802158");
obj1.setTradeProductCode("NORMAL");
YunosBanmapayPaymentprodTradeCreateandpayRequest.DeviceInfo obj3 = new YunosBanmapayPaymentprodTradeCreateandpayRequest.DeviceInfo();
obj3.setDeviceType("MOBILE");
obj3.setDeviceOs("IOS");
obj1.setDeviceInfo(obj3);
obj1.setBizOrderDesc("二手车鉴定报告");
obj1.setTotalAmount(1000L);
obj1.setBizOrderId("7D7LCF5230329183752914197006");
obj1.setPayNotifyUrl("https://xxx.xx.com/xx");
obj1.setBizOrderTitle("二手车鉴定报告");
obj1.setPayMethodCode("mini_program_pay_2");
obj1.setBuyerTypeCode("AliOS");
obj1.setReplenishAmount(500L);
obj1.setSettlementProps("{\"type\":\"ASSIGN\", \"royaltyEntities\":[{\"accountType\":\"1\", \"accountId\":\"hangzhoubanma\", \"amount\":\"700\"},{\"accountType\":\"2\", \"accountId\":\"banshu\", \"amount\":\"300\"}]}");
obj1.setExtraProps("{\"originalBizOrderId\":\"7D7LCF5230329183752914197006\"}");
obj1.setTradeExpiryTime(StringUtils.parseDateTime("2023-07-24 19:24:41"));
req.setTradeCreateAndPayRequest(obj1);
YunosBanmapayPaymentprodTradeCreateandpayResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<yunos_banmapay_paymentprod_trade_createandpay_response>
    <result>
        <data>
            <extra_data>{&quot;payTokenType&quot;:&quot;alipay_mini_program&quot;, &quot;payTokenValue&quot;:&quot;746588373626&quot;, &quot;payTokenExpiryMillis&quot;:&quot;1688538823000&quot;}</extra_data>
            <trade_id>trade20230621272071700278059008</trade_id>
            <trade_status>trade_processing</trade_status>
        </data>
        <error_code>SYSTEM_ERROR</error_code>
        <error_msg>系统异常,请稍后重试</error_msg>
        <success>true</success>
    </result>
</yunos_banmapay_paymentprod_trade_createandpay_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部