[Java SDK] AMS-V/M支持Top-UP/Back-To-Back交易场景 接口变更

src/main/java/com/alipay/global/api/model/ams/FundTransferAddress.java

@@ -0,0 +1,44 @@
+/*
+ * payments_createPaymentSession
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+package com.alipay.global.api.model.ams;
+
+import lombok.*;
+
+/** FundTransferAddress */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FundTransferAddress {
+
+  /**
+   * The street address of the fund sender or recipient, collected for AML compliance. Maximum
+   * length: 256 characters.
+   */
+  private String address1;
+
+  /** The city of the fund sender or recipient. Maximum length: 32 characters. */
+  private String city;
+
+  /**
+   * The state, province, or administrative division code of the fund sender or recipient. Maximum
+   * length: 64 characters.
+   */
+  private String state;
+
+  /**
+   * The country code of the fund sender or recipient, in ISO 3166-1 alpha-2 format, such as SG, HK,
+   * or US. Maximum length: 2 characters.
+   */
+  private String region;
+}

src/main/java/com/alipay/global/api/model/ams/FundTransferInfo.java

@@ -0,0 +1,58 @@
+/*
+ * payments_createPaymentSession
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+package com.alipay.global.api.model.ams;
+
+import lombok.*;
+
+/** FundTransferInfo */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FundTransferInfo {
+
+  /**
+   * The fund transfer type. Known values are ACCOUNTFUNDINGTRANSACTION: an account funding
+   * transaction (AFT), used only to top up an account; BACKTOBACKTRANSACTION: a back-to-back
+   * transaction (B2B), used to top up and then purchase. If neither value is supplied, the payment
+   * is processed as a normal purchase. For AFT, transferSender and transferRecipient can be
+   * omitted; when supplied, their information is forwarded to the card network. For B2B, an omitted
+   * sellerMcc or sellerName independently falls back to the corresponding merchant information
+   * registered with Antom. Maximum length: 32 characters.
+   */
+  private String fundTransferType;
+
+  /**
+   * The merchant category code (MCC) of the final seller for a B2B payment. Used only for SDWO
+   * merchants when fundTransferType is BACKTOBACKTRANSACTION, to distinguish the final seller from
+   * the wallet operator. Use a four-digit MCC under ISO 18245. If omitted, the merchant MCC
+   * registered with Antom is used, independently of sellerName. For non-wallet merchants or other
+   * transaction types, the registered MCC is used even if this field is supplied. Maximum length: 4
+   * characters.
+   */
+  private String sellerMcc;
+
+  /**
+   * The name of the final seller for a B2B payment. Used only for SDWO merchants when
+   * fundTransferType is BACKTOBACKTRANSACTION. The cardholder statement displays
+   * AlipayHK*<sellerName>, TNGD*<sellerName>, or GrabPay*<sellerName>, as
+   * applicable to the wallet merchant. If omitted, the merchant name registered with Antom is used,
+   * independently of sellerMcc. For non-wallet merchants or other transaction types, the registered
+   * merchant name is used even if this field is supplied. Maximum length: 256 characters.
+   */
+  private String sellerName;
+
+  private TransferSender transferSender;
+
+  private TransferRecipient transferRecipient;
+}

src/main/java/com/alipay/global/api/model/ams/FundTransferName.java

@@ -0,0 +1,35 @@
+/*
+ * payments_createPaymentSession
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+package com.alipay.global.api.model.ams;
+
+import lombok.*;
+
+/** FundTransferName */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FundTransferName {
+
+  /**
+   * The first (given) name of the fund sender or recipient, collected for AML compliance. Maximum
+   * length: 32 characters.
+   */
+  private String firstName;
+
+  /**
+   * The last (family) name of the fund sender or recipient, collected for AML compliance. Maximum
+   * length: 32 characters.
+   */
+  private String lastName;
+}

src/main/java/com/alipay/global/api/model/ams/TransferRecipient.java

@@ -0,0 +1,34 @@
+/*
+ * payments_createPaymentSession
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+package com.alipay.global.api.model.ams;
+
+import lombok.*;
+
+/** TransferRecipient */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class TransferRecipient {
+
+  private FundTransferName recipientName;
+
+  private FundTransferAddress address;
+
+  /**
+   * The recipient wallet user's account number identifying the wallet account to be topped up.
+   * Collected for fund flow tracking and AML compliance in AFT payments. Only letters, digits, and
+   * hyphens (-) are supported. Maximum length: 64 characters.
+   */
+  private String recipientAccountNumber;
+}

src/main/java/com/alipay/global/api/model/ams/TransferSender.java

@@ -0,0 +1,27 @@
+/*
+ * payments_createPaymentSession
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+package com.alipay.global.api.model.ams;
+
+import lombok.*;
+
+/** TransferSender */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class TransferSender {
+
+  private FundTransferName senderName;
+
+  private FundTransferAddress address;
+}

src/main/java/com/alipay/global/api/request/ams/pay/AlipayPayRequest.java

@@ -18,6 +18,7 @@
 import com.alipay.global.api.model.ams.CreditPayPlan;
 import com.alipay.global.api.model.ams.CustomizedInfo;
 import com.alipay.global.api.model.ams.Env;
+import com.alipay.global.api.model.ams.FundTransferInfo;
 import com.alipay.global.api.model.ams.Merchant;
 import com.alipay.global.api.model.ams.Order;
 import com.alipay.global.api.model.ams.PaymentFactor;
@@ -36,6 +37,8 @@
 @Data
 public class AlipayPayRequest extends AlipayRequest<AlipayPayResponse> {
 
+  private FundTransferInfo fundTransferInfo;
+
   /**
    * Use this parameter to submit metadata, including information for special use cases. Specify
    * this parameter when you need to add metadata information.

src/main/java/com/alipay/global/api/request/ams/pay/AlipayPaymentSessionRequest.java

@@ -21,6 +21,7 @@
 import com.alipay.global.api.model.ams.CreditPayPlan;
 import com.alipay.global.api.model.ams.CustomizedInfo;
 import com.alipay.global.api.model.ams.Env;
+import com.alipay.global.api.model.ams.FundTransferInfo;
 import com.alipay.global.api.model.ams.Order;
 import com.alipay.global.api.model.ams.PaymentFactor;
 import com.alipay.global.api.model.ams.PaymentMethod;
@@ -40,6 +41,8 @@
 @Data
 public class AlipayPaymentSessionRequest extends AlipayRequest<AlipayPaymentSessionResponse> {
 
+  private FundTransferInfo fundTransferInfo;
+
   /**
    * A unique ID to identify a specific merchant account. Note: Specify this parameter when you use
    * one client ID across multiple locations.