PayCloud托管收银台

拥有在线网站（如在线购物中心/票务网站/充值网站等）的商户可以参考本节提供的解决方案来访问PayCloud支付。

产品说明

PayCloud托管收银台是PayCloud为希望在其网站上接受付款的商家提供的一种支付集成方法。它提供了一种安全的方式，通过将客户重定向到PayCloud托管的支付页面来收集他们的付款。

PayCloud托管收银台集成了大量银行/收单机构/第三方支付服务提供商的支付服务，包括银行卡在线支付/网银支付/移动钱包扫码支付等。

用户完成支付后，商家可以收到PayCloud的支付通知，商家也可以主动调用查询订单API获取支付结果。在获得付款结果后，PayCloud会同步并更新订单信息给商户，以完成剩余的商品和服务。

工作原理

要使用PayCloud托管收银台，商家需要将PayCloud托管收银台集成到他们的网站中。一旦集成，客户可以选择他们想要使用的支付方式，并在支付表单上输入他们的支付详细信息。当他们单击“支付”按钮时，他们将被重定向到PayCloud托管的支付页面，在那里他们将完成支付过程。 一旦付款处理完毕，客户将被重定向回商家的网站，在那里他们可以查看付款结果。

PayCloud Checkout页面展示

以下示例展示了PayCloud托管收银台的部分页面，客户被重定向到此页面时的内容展示：

• 卡支付模式

• QR支付模式

流程说明

1. 顾客在商家网站选择商品或服务，下单，点击支付按钮，请求商家服务器开始支付。
2. 商家服务器保存订单，请求PayCloud服务器的PayCloud托管收银台下单API，将订单信息提交给PayCloud。
3. PayCloud验证订单信息，保存订单。
4. PayCloud返回收银台页面URL给商家服务器。
5. 商家服务器返回PayCloud收银台URL给商家网站。
6. 商家网站重定向用户请求到PayCloud收银台页面。第五步和第六步，也可以由商家后台进行重定向，具体实现方案商家根据需求进行选择。
7. 用户在PayCloud收银台选择付款方式，例如信用卡付款或QR付款，然后安全地提交相应的付款信息给后台。
8. PayCloud验证付款信息，并转发付款请求给银行/收单机构/第三方支付服务提供商。
9. 处理支付请求，并同步返回相应处理结果。
10. PayCloud同步返回付款结果给PayCloud收银台。并异步通知商家服务器付款结果，详情请参考交易结果通知。Webhook通知URL是商家下单时通过 “notify_url” 参数传递给PayCloud的。
11. PayCloud收银台跳转到商家的页面，跳转URL是商家下单时通过 “return_url” 参数传递给PayCloud的。
12. 商家页面应通过后台的交易状态确认订单是否支付成功。展示相应的付款结果界面给用户，并提供后续的商品或服务。为防止漏单，你可以通过查询支付订单API主动查询订单状态。

开发指南

要与PayCloud托管收银台进行集成，您需要发送HTTP请求并检查响应。这将把客户从商家的网站重定向到PayCloud的支付页面以完成支付。您可以参考文档中的API描述及示例报文。

提示

建议您在开始之前先使用测试参数进行集成，以便在开通支付之前可以快速了解和体验PayCloud所提供的功能（开通支付需要你提交商户资料，审核等一系列行为，可能是一个较长的过程）。
使用沙箱参数集成后的付款，不是真实的付款，只是模拟交易过程，方便你进行大额测试和一些特殊金额的测试以及模拟错误。
详细信息，请阅读文档: 测试集成

API列表

我们提供了一组REST API，请参阅下表，这些API提供了多种语言的SDK，请访问SDK章节。API访问规则请参考API规则。

API名称	说明
PayCloud托管收银台下单	通过此API提交付款订单
提交退款申请	如果您通过此API提交退款请求，但退款没有立即到达，您可以调用退款查询API来获取退款的进度。
查询支付订单	通过该API查询正向交易订单的交易结果（消费/预授权/预授权完成）
查询退款订单	通过此API查询负向交易订单（消费取消/预授权取消/消费退款/预授权完成退款）的交易结果
交易结果通知	交易完成后，通知商家，告知商家交易结果

快速集成SDK

为了简化集成过程，我们也提供了一些语言的SDK或Demo（参见SDK/Demo章节）。该SDK通过处理大部分必要的功能，使PayCloud托管收银台支付流程的实现变得更加简单。