# 托管支付
### 1. 配置您的 MoneyCollect 账户
首先，请确保您已在 MoneyCollect 后台上设置了账户。如果您尚未完成，请先按照[“快速开始”](/docs/guidelines_zh/zai-xian-zhi-fu/kuai-su-kai-shi.md)中的所有步骤操作，然后再继续。
### 2. 部署服务端
MoneyCollect 使用 [Session](https://apireference.moneycollect.com/docs/api-v1/ac48ebdba6798-create-a-session) 对象来表达您的支付操作，追踪整个过程中的支付生命周期和状态变化。
**创建结帐按钮**
在您的网站上添加一个 `Checkout` 按钮，该按钮调用服务器api，以创建结账会话。
```html
结帐 `amountTotal` 客户需要支付的总金额。
* `currency` 客户需要支付的货币。
* `lineItems` 客户正在购买的商品列表。它可以在托管支付页面上为客户显示。显示的项目包括`products'name` （产品名称）、`images` （图片）和`quantity` （数量）。
* 通过设置`orderNo` ，您可以将您的订单编号与结账会话关联起来。将来，您可以通过关联的`orderNo` 在 MoneyCollect 后台中找到相应的付款信息。
* 如果没有提供账单地址信息`billingDetails` ，则将在结账页面上从客户处收集该信息。
您还需要设置以下 URL，并确保它们可以被公开访问，这样 MoneyCollect 才能将您的客户重定向到这些页面。
* `returnUrl` 您网站上的一个成功或订单确认页面，用于客户完成付款后重定向他们。
* `cancelUrl` 如果客户在结帐期间取消付款，请通过 URL 将其重定向回您的网站。
* `notifyUrl` 完成付款后，支付结果也会发送到此 URL。
> 如果结帐会话未在创建后 24 小时内支付，将自动被取消。
>
> 创建结算会话并成功响应后，请将您的客户重定向到响应中返回的结算页面的 `url`。
此外，您还可以根据具体需求灵活采取其他支付方式。
```java
post("/create-checkout", (request, response) -> {
// 使用您的私钥
MoneyCollect.apiKey = "test_pr_NWZsa******";
// 配置首选支付方式
List paymentMethodTypes = new ArrayList<>();
paymentMethodTypes.add("card");
paymentMethodTypes.add("kakao_pay");
SessionCreateParams params = SessionCreateParams.builder()
.setReturnUrl("http://localhost:6060/success.html")
.setCancelUrl("http://localhost:6060/cancel.html")
.setNotifyUrl("http://localhost:6060/success.html")
.setPaymentMethodTypes(paymentMethodTypes)
.setAmountTotal(19 * 100L)
.setCurrency("USD")
.setOrderNo("C"+System.currentTimeMillis())
.setWebsite("https://www.mc.com").build();
Session session = Session.create(params);
return JSONObject.toJSONString(new CreateCheckoutResponse(session.getUrl()));
});
```
可以通过启动 Web 服务器（例如 localhost:4242）来测试接口。
**测试**
1. 点击您的`结帐` 按钮。
2. 使用测试卡信息填写支付详细信息：
* 输入 4242 4242 4242 4242 作为`卡号` 。
* 输入任何未来日期作为`卡片有效期` 。
* 输入任何三位数字作为`CVC` 。
* 输入`客户的电子邮件` 。
* 输入`客户的名字和姓氏` 。
* 输入`账单详情` 。
3. 单击`支付` 。
4. 您将被重定向到您的返回页面。
接下来，您可以在 MoneyCollect 后台中找到新的订单，并检查支付订单详情。
### 3. 创建确认页面
创建一个名为 `returnUrl ` 的页面，并在Checkout会话中提供，用于在您的顾客完成支付后，显示订单确认页面或订单详细信息。顾客完成支付后，将被重定向到该页面。
```html
Thanks for your order!
We appreciate your business! If you have any questions, please email
Restart demo
```
如果您的客户在支付中取消，则创建结算会话中提供的 `cancelUrl` 页面，他们将被重定向到此页面。
```html
Checkout canceled
Forgot to add something to your cart? Shop around then come back to pay!
Restart demo
```
### 4. 其他测试资源
您可以使用几个测试卡来确保您的集成已准备好投入生产。
您与任何的 `CVC` 、 `postal code` 和 `future expiration date` 一起使用。
卡号 品牌 描述 4242 4242 4242 4242 Visa 成功 并立即处理支付。3566 0020 2036 0505 JCB 成功 并立即处理支付。6011 1111 1111 1117 Discover 成功 并立即处理支付。3782 8224 6310 0052 American Express 成功 并立即处理支付。5555 5555 5555 4444 Mastercard 成功 并立即处理支付。4000 0000 0000 0077 Visa 始终失败，拒绝代码为declined 4000002500003155 Visa 此卡在所有交易中都需要3D身份验证
### 5. 付款后
有关管理 WebHooks、处理退款和处理付款后的响应的详细指导，请参阅以下文档。
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.moneycollect.com/docs/guidelines_zh/zai-xian-zhi-fu/zai-xian-zhi-fu/tuo-guan-zhi-fu.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.