集成快捷支付（API）

@PostMapping("/v1/payments/pay")
public ResponseEntity<ApiResponse> pay(@RequestBody PaymentVO payment) {
  AmsPayRequest request = new AmsPayRequest();
  request.setProductCode(ProductCodeType.AGREEMENT_PAYMENT);

  // 替换为您的 paymentRequestId
  String paymentRequestId = UUID.randomUUID().toString();
  request.setPaymentRequestId(paymentRequestId);

  // 转换金额单位（实际使用中，金额应在服务端计算）
  // 详情请参考: https://docs.antom.com/ac/ref/cc
  long amountMinorLong = Money.of(
    CurrencyUnit.of(payment.currency),
    new BigDecimal(payment.amountValue)
  ).getAmountMinorLong();

  // 设置 paymentAmount
  Amount paymentAmount = Amount.builder()
    .currency(payment.currency)
    .value(String.valueOf(amountMinorLong))
    .build();
  request.setPaymentAmount(paymentAmount);

  // 设置 settlementStrategy
  // 替换为您现有的结算货币
  SettlementStrategy settlementStrategy = SettlementStrategy.builder()
    .settlementCurrency("USD")
    .build();
  request.setSettlementStrategy(settlementStrategy);

  // 设置 paymentMethod
  PaymentMethod paymentMethod = PaymentMethod.builder()
    .paymentMethodType(payment.paymentMethodType)
    .build();

  User loginUser = users.get(payment.getUserId());

  if (loginUser.getPaymentMethodTypeAccessToken().containsKey(payment.getPaymentMethodType())) {
    // 买家已授权，使用 token 走代扣
    String accessToken = loginUser
      .getPaymentMethodTypeAccessToken()
      .get(payment.getPaymentMethodType());
    paymentMethod.setPaymentMethodId(accessToken);
  } else {
    // 买家未授权，设置 agreementInfo 走签约流程
    String authState = UUID.randomUUID().toString();
    AgreementInfo agreementInfo = AgreementInfo.builder().authState(authState).build();
    request.setAgreementInfo(agreementInfo);

    // 保存与 authState 对应的 paymentMethodType
    authStatePayment.put(authState, payment);
  }
  request.setPaymentMethod(paymentMethod);

  // 设置 env（环境信息，用于风控）
  Env env = Env.builder()
    .osType(payment.getOsType())
    .terminalType(payment.getTerminalType())
    .deviceId(payment.getDeviceId())
    .clientIp(payment.getClientIp())
    .deviceTokenId(payment.getDeviceTokenId())
    .build();
  request.setEnv(env);

  // 设置 goods（商品明细）
  List<Goods> goodsList = payment
    .getGoodsList()
    .stream()
    .map(g ->
      Goods.builder()
        .referenceGoodsId(g.getReferenceGoodsId())
        .goodsName(g.getGoodsName())
        .quantity(g.getQuantity())
        .price(Amount.builder().currency(payment.currency).value(g.getPriceValue()).build())
        .build()
    )
    .collect(Collectors.toList());

  // 设置 shipping（物流信息）
  Shipping shipping = Shipping.builder()
    .shippingName(
      ShippingName.builder()
        .firstName(payment.getShippingFirstName())
        .lastName(payment.getShippingLastName())
        .build()
    )
    .shippingAddress(
      ShippingAddress.builder()
        .region(payment.getShippingRegion())
        .state(payment.getShippingState())
        .city(payment.getShippingCity())
        .address1(payment.getShippingAddress1())
        .address2(payment.getShippingAddress2())
        .zipCode(payment.getShippingZipCode())
        .build()
    )
    .shippingCarrier(payment.getShippingCarrier())
    .shippingPhoneNo(payment.getShippingPhoneNo())
    .build();

  // 设置 buyer（买家信息）
  Buyer buyer = Buyer.builder()
    .referenceBuyerId(loginUser.getReferenceBuyerId())
    .buyerName(
      BuyerName.builder()
        .firstName(loginUser.getFirstName())
        .lastName(loginUser.getLastName())
        .build()
    )
    .buyerPhoneNo(loginUser.getPhoneNumber())
    .buyerEmail(loginUser.getEmail())
    .build();

  // 替换为您的 orderId
  String orderId = UUID.randomUUID().toString();

  // 设置 order（订单信息，含商品明细、物流、买家）
  Amount orderAmount = Amount.builder()
    .currency(payment.currency)
    .value(String.valueOf(amountMinorLong))
    .build();
  Order order = Order.builder()
    .referenceOrderId(orderId)
    .orderDescription(payment.getOrderDescription())
    .orderAmount(orderAmount)
    .goods(goodsList)
    .shipping(shipping)
    .buyer(buyer)
    .build();
  request.setOrder(order);

  // 替换为您的通知 url
  // 或配置您的通知 url: https://dashboard.antom.com/global-payments/developers/iNotify
  request.setPaymentNotifyUrl("https://merchant.com/notify/payment-result");

  // 替换为您的跳转 url
  request.setPaymentRedirectUrl(
    "https://merchant.com/payment/result?paymentRequestId=" + paymentRequestId
  );

  AmsPayResponse amsPayResponse;
  try {
    long startTime = System.currentTimeMillis();
    System.out.println("pay request: " + JSON.toJSONString(request));
    amsPayResponse = CLIENT.execute(request, AmsPayResponse.class);
    System.out.println("pay response: " + JSON.toJSONString(amsPayResponse));
    System.out.println("pay request cost time: " + (System.currentTimeMillis() - startTime) + "ms");
  } catch (AlipayApiException e) {
    return ResponseEntity.ok().body(new ApiResponse(paymentRequestId, payment.getUserId(), e));
  }
  return ResponseEntity.ok()
    .body(new ApiResponse(paymentRequestId, payment.getUserId(), amsPayResponse));
}

{
  "order": {
    "orderAmount": {
      "currency": "HKD",
      "value": 100
    },
    "referenceOrderId": "ORD_2024040512345",
    "orderDescription": "iPhone 15 Pro Monthly Subscription",
    "goods": [
      {
        "referenceGoodsId": "G_001",
        "goodsName": "iPhone 15 Pro",
        "quantity": 1,
        "price": {
          "currency": "HKD",
          "value": 100
        }
      }
    ],
    "shipping": {
      "shippingName": {
        "firstName": "John",
        "lastName": "Doe"
      },
      "shippingAddress": {
        "region": "US",
        "state": "CA",
        "city": "San Francisco",
        "address1": "123 Tech Street",
        "address2": "Apt 4B",
        "zipCode": "94107"
      },
      "shippingCarrier": "FedEx",
      "shippingPhoneNo": "+1-415-555-1234"
    },
    "buyer": {
      "referenceBuyerId": "BUYER_88118999",
      "buyerName": {
        "firstName": "John",
        "lastName": "Doe"
      },
      "buyerPhoneNo": "66622222",
      "buyerEmail": "john.doe@example.com"
    }
  },
  "env": {
    "osType": "IOS",
    "terminalType": "APP",
    "deviceId": "deviceIdxxxxxxx",
    "clientIp": "192.168.111.111",
    "deviceTokenId": "deviceTokenIdxxxxxxxx"
  },
  "paymentRequestId": "PAYMENT_20251110121228651_AUTO",
  "paymentAmount": {
    "currency": "HKD",
    "value": 100
  },
  "settlementStrategy": {
    "settlementCurrency": "USD"
  },
  "paymentMethod": {
    "paymentMethodType": "ALIPAY_HK"
  },
  "paymentNotifyUrl": "https://merchant.com/notify/payment-result",
  "paymentRedirectUrl": "https://kademo.intlalipay.cn/melitigo/Test_114.html",
  "productCode": "AGREEMENT_PAYMENT",
  "agreementInfo": {
    "authState": "sign_no_xxxxx111111x01001"
  }
}

{
    "actualPaymentAmount": {
        "currency": "HKD",
        "value": "100"
    },
    "normalUrl": "https://checkout.antom.com/easysafepay/1.39.0/pages/api-portal/index.html?paymentMethodCategoryType=WALLET&sessionData=vxA9kkY8yysEoUhFyy%2BEvM17vV72yntAcqJGeMF1PETOU9fJtoSUls3s0vdS1YouYbWEl8gHHEaWPO0Xh%2FT%2BJg%3D%3D%26%26SG%26%26188&locale=en-US&productScene=EASY_PAY&productSceneVersion=2.0",
    "paymentActionForm": "{"method":"GET","paymentActionFormType":"RedirectActionForm","redirectUrl":"https://checkout.antom.com/easysafepay/1.39.0/pages/api-portal/index.html?paymentMethodCategoryType=WALLET&sessionData=vxA9kkY8yysEoUhFyy%2BEvM17vV72yntAcqJGeMF1PETOU9fJtoSUls3s0vdS1YouYbWEl8gHHEaWPO0Xh%2FT%2BJg%3D%3D%26%26SG%26%26188&locale=en-US&productScene=EASY_PAY&productSceneVersion=2.0"}",
    "paymentAmount": {
        "currency": "HKD",
        "value": "100"
    },
    "paymentCreateTime": "2025-11-10T00:35:03-08:00",
    "paymentId": "20251110194010900000188350227845338",
    "paymentRequestId": "PAYMENT_20251110163502455_AUTO",
    "redirectActionForm": {
        "method": "GET",
        "redirectUrl": "https://checkout.antom.com/easysafepay/1.39.0/pages/api-portal/index.html?paymentMethodCategoryType=WALLET&sessionData=vxA9kkY8yysEoUhFyy%2BEvM17vV72yntAcqJGeMF1PETOU9fJtoSUls3s0vdS1YouYbWEl8gHHEaWPO0Xh%2FT%2BJg%3D%3D%26%26SG%26%26188&locale=en-US&productScene=EASY_PAY&productSceneVersion=2.0"
    },
    "result": {
        "resultCode": "PAYMENT_IN_PROCESS",
        "resultMessage": "payment in process",
        "resultStatus": "U"
    }
}

@PostMapping("/v1/payments/pay")
public ResponseEntity<ApiResponse> pay(@RequestBody PaymentVO payment) {
  AmsPayRequest request = new AmsPayRequest();
  request.setProductCode(ProductCodeType.AGREEMENT_PAYMENT);

  // 替换为您的 paymentRequestId
  String paymentRequestId = UUID.randomUUID().toString();
  request.setPaymentRequestId(paymentRequestId);

  // 转换金额单位（实际使用中，金额应在服务端计算）
  // 详情请参考: https://docs.antom.com/ac/ref/cc
  long amountMinorLong = Money.of(
    CurrencyUnit.of(payment.currency),
    new BigDecimal(payment.amountValue)
  ).getAmountMinorLong();

  // 设置 paymentAmount
  Amount paymentAmount = Amount.builder()
    .currency(payment.currency)
    .value(String.valueOf(amountMinorLong))
    .build();
  request.setPaymentAmount(paymentAmount);

  // 设置 settlementStrategy
  // 替换为您现有的结算货币
  SettlementStrategy settlementStrategy = SettlementStrategy.builder()
    .settlementCurrency("USD")
    .build();
  request.setSettlementStrategy(settlementStrategy);

  // 设置 paymentMethod（代扣场景：使用已有的 paymentMethodId）
  User loginUser = users.get(payment.getUserId());
  String accessToken = loginUser
    .getPaymentMethodTypeAccessToken()
    .get(payment.getPaymentMethodType());

  PaymentMethodMetadata metadata = PaymentMethodMetadata.builder()
    .recurringType("SCHEDULED") // 用户不参与扣款时传入 SCHEDULED，用户参与场景不需要传入
    .build();
  PaymentMethod paymentMethod = PaymentMethod.builder()
    .paymentMethodType(payment.paymentMethodType)
    .paymentMethodId(accessToken)
    .paymentMethodMetadata(metadata)
    .build();
  request.setPaymentMethod(paymentMethod);

  // 设置 env（环境信息，用于风控）
  Env env = Env.builder()
    .osType(payment.getOsType())
    .terminalType(payment.getTerminalType())
    .deviceId(payment.getDeviceId())
    .clientIp(payment.getClientIp())
    .deviceTokenId(payment.getDeviceTokenId())
    .build();
  request.setEnv(env);

  // 设置 goods（商品明细）
  List<Goods> goodsList = payment
    .getGoodsList()
    .stream()
    .map(g ->
      Goods.builder()
        .referenceGoodsId(g.getReferenceGoodsId())
        .goodsName(g.getGoodsName())
        .quantity(g.getQuantity())
        .price(Amount.builder().currency(payment.currency).value(g.getPriceValue()).build())
        .build()
    )
    .collect(Collectors.toList());

  // 设置 shipping（物流信息）
  Shipping shipping = Shipping.builder()
    .shippingAddress(
      ShippingAddress.builder()
        .region(payment.getShippingRegion())
        .state(payment.getShippingState())
        .city(payment.getShippingCity())
        .address1(payment.getShippingAddress1())
        .address2(payment.getShippingAddress2())
        .zipCode(payment.getShippingZipCode())
        .build()
    )
    .build();

  // 设置 buyer（买家信息）
  Buyer buyer = Buyer.builder()
    .referenceBuyerId(payment.getReferenceBuyerId())
    .buyerName(
      BuyerName.builder()
        .firstName(payment.getBuyerFirstName())
        .lastName(payment.getBuyerLastName())
        .build()
    )
    .buyerPhoneNo(payment.getBuyerPhoneNo())
    .buyerEmail(payment.getBuyerEmail())
    .build();

  // 替换为您的 orderId
  String orderId = UUID.randomUUID().toString();

  // 设置 order（订单信息，含商品明细、物流、买家）
  Amount orderAmount = Amount.builder()
    .currency(payment.currency)
    .value(String.valueOf(amountMinorLong))
    .build();
  Order order = Order.builder()
    .referenceOrderId(orderId)
    .orderDescription(payment.getOrderDescription())
    .orderAmount(orderAmount)
    .goods(goodsList)
    .shipping(shipping)
    .buyer(buyer)
    .build();
  request.setOrder(order);

  // 替换为您的通知 url
  // 或配置您的通知 url: https://dashboard.antom.com/global-payments/developers/iNotify
  request.setPaymentNotifyUrl("https://kademo.intlalipay.cn/payments/notifySuccess");

  // 替换为您的跳转 url
  request.setPaymentRedirectUrl("https://kademo.intlalipay.cn/melitigo/Test_114.html");

  AmsPayResponse amsPayResponse;
  try {
    long startTime = System.currentTimeMillis();
    System.out.println("pay request: " + JSON.toJSONString(request));
    amsPayResponse = CLIENT.execute(request, AmsPayResponse.class);
    System.out.println("pay response: " + JSON.toJSONString(amsPayResponse));
    System.out.println("pay request cost time: " + (System.currentTimeMillis() - startTime) + "ms");

    // 代扣场景：支付结果同步返回
    // resultStatus=S 表示支付成功，无需跳转收银台
    if ("S".equals(amsPayResponse.getResult().getResultStatus())) {
      System.out.println(
        "Payment SUCCESS, paymentId: " +
        amsPayResponse.getPaymentId() +
        ", paymentTime: " +
        amsPayResponse.getPaymentTime()
      );
    }
  } catch (AlipayApiException e) {
    return ResponseEntity.ok().body(new ApiResponse(paymentRequestId, payment.getUserId(), e));
  }
  return ResponseEntity.ok()
    .body(new ApiResponse(paymentRequestId, payment.getUserId(), amsPayResponse));
}

{
  "order": {
    "orderAmount": {
      "currency": "HKD",
      "value": 100
    },
    "referenceOrderId": "ORD_2024040512345",
    "orderDescription": "iPhone 15 Pro Monthly Subscription",
    "goods": [
      {
        "referenceGoodsId": "G_001",
        "goodsName": "iPhone 15 Pro",
        "quantity": 1,
        "price": {
          "currency": "HKD",
          "value": 100
        }
      }
    ],
    "shipping": {
      "shippingAddress": {
        "region": "US",
        "state": "CA",
        "city": "San Francisco",
        "address1": "123 Tech Street",
        "address2": "Apt 4B",
        "zipCode": "94107"
      }
    },
    "buyer": {
      "referenceBuyerId": "BUYER_88118999",
      "buyerName": {
        "firstName": "John",
        "lastName": "Doe"
      },
      "buyerPhoneNo": "66622222",
      "buyerEmail": "john.doe@example.com"
    }
  },
  "env": {
    "osType": "IOS",
    "terminalType": "APP",
    "deviceId": "deviceIdxxxxxxx",
    "clientIp": "192.168.111.111",
    "deviceTokenId": "deviceTokenIdxxxxxxxx"
  },
  "paymentMethod": {
    "paymentMethodType": "ALIPAY_HK",
    "paymentMethodId": "xxxxxxxx",
    "paymentMethodMetadata": {
      "recurringType": "SCHEDULED" //买家不参与的情况下需要传入，买家参与场景不需要传入
    }
  },
  "settlementStrategy": {
    "settlementCurrency": "USD"
  },
  "paymentNotifyUrl": "https://kademo.intlalipay.cn/payments/notifySuccess",
  "paymentRedirectUrl": "https://kademo.intlalipay.cn/melitigo/Test_114.html",
  "paymentRequestId": "PAY_20251110143957765",
  "productCode": "AGREEMENT_PAYMENT"
}

{
  "actualPaymentAmount": {
    "currency": "HKD",
    "value": "100"
  },
  "paymentAmount": {
    "currency": "HKD",
    "value": "100"
  },
  "paymentCreateTime": "2025-11-05T23:03:16-08:00",
  "paymentId": "202511061940108001001888********",
  "paymentRequestId": "PAYMENT_20251106150314003_AUTO",
  "paymentTime": "2025-11-05T23:03:18-08:00",
  "pspCustomerInfo": {
    "pspCustomerId": "208812211210000",
    "pspName": "ALIPAY_HK"
  },
  "result": {
    "resultCode": "SUCCESS",
    "resultMessage": "success.",
    "resultStatus": "S"
  }
}

if (URL != null) {
  window.open(URL, "_blank");
}

window.location.href = URL;

if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 10.0) {
    [[UIApplication sharedApplication] openURL:[NSURL URLWithString:Url] options:@{} completionHandler:nil];
}else{ 
    [[UIApplication sharedApplication] openURL:[NSURL URLWithString:Url]];
}

try {
  Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(URL));
  intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
  // use the startActivity function to redirect to the wallet app
  startActivity(intent);
} catch (Exception e) {
  e.printStackTrace();
}

{
  "accessToken": "28288803001319861727421828000Cv96OFlYoi17100****",
  "accessTokenExpiryTime": 2145916817000,
  "authState": "36a38e87-0453-495e-ad17-b46553b918da",
  "authorizationNotifyType": "TOKEN_CREATED",
  "userLoginId": "852-91****67",
  "result": {
    "resultCode": "SUCCESS",
    "resultMessage": "success.",
    "resultStatus": "S"
  }
}

@PostMapping("/receiveAuthNotify")
@ResponseBody
public Result receiveAuthNotify(HttpServletRequest request, @RequestBody String notifyBody) {
  // 从 HTTP 请求中获取必要参数
  String requestUri = request.getRequestURI();
  String requestMethod = request.getMethod();

  // 从请求头中获取必要参数
  String requestTime = request.getHeader("request-time");
  String clientId = request.getHeader("client-id");
  String signature = request.getHeader("signature");

  try {
    // 验证通知签名
    boolean verifyResult = WebhookTool.checkSignature(
      requestUri,
      requestMethod,
      clientId,
      requestTime,
      signature,
      notifyBody,
      ANTOM_PUBLIC_KEY
    );
    if (!verifyResult) {
      throw new RuntimeException("Invalid notify signature");
    }

    // 反序列化通知体
    AlipayAuthNotify authNotify = JSON.parseObject(notifyBody, AlipayAuthNotify.class);

    if (
      authNotify != null &&
      "SUCCESS".equals(authNotify.getResult().getResultCode()) &&
      "TOKEN_CREATED".equals(authNotify.getAuthorizationNotifyType())
    ) {
      // 保存买家 PaymentMethodType 与 accessToken 的对应关系
      PaymentVO payment = authStatePayment.get(authNotify.getAuthState());
      User user = users.get(payment.getUserId());
      user
        .getPaymentMethodTypeAccessToken()
        .put(payment.getPaymentMethodType(), authNotify.getAccessToken());
      return Result.builder()
        .resultCode("SUCCESS")
        .resultMessage("success.")
        .resultStatus(ResultStatusType.S)
        .build();
    }
    // 其他类型的通知
  } catch (Exception e) {
    return Result.builder()
      .resultCode("FAIL")
      .resultMessage("fail.")
      .resultStatus(ResultStatusType.F)
      .build();
  }

  return Result.builder()
    .resultCode("SYSTEM_ERROR")
    .resultMessage("system error.")
    .resultStatus(ResultStatusType.F)
    .build();
}

{
  "result": {
    "resultCode": "SUCCESS",
    "resultStatus": "S",
    "resultMessage": "success"
  }
}