CodePay托管收银台
拥有在线网站（如在线购物中心/票务网站/充值网站等）的商户可以参考本节提供的解决方案来访问CodePay支付。
产品说明
CodePay托管收银台是CodePay为希望在其网站上接受付款的商家提供的一种支付集成方法。它提供了一种安全的方式，通过将客户重定向到CodePay托管的支付页面来收集他们的付款。
CodePay托管收银台集成了大量银行/收单机构/第三方支付服务提供商的支付服务，包括银行卡在线支付/网银支付/移动钱包扫码支付等。
用户完成支付后，商家可以收到CodePay的支付通知，商家也可以主动调用查询订单API获取支付结果。在获得付款结果后，CodePay会同步并更新订单信息给商户，以完成剩余的商品和服务。
工作原理
要使用CodePay托管收银台，商家需要将CodePay托管收银台集成到他们的网站中。一旦集成，客户可以选择他们想要使用的支付方式，并在支付表单上输入他们的支付详细信息。当他们单击“支付”按钮时，他们将被重定向到CodePay托管的支付页面，在那里他们将完成支付过程。 一旦付款处理完毕，客户将被重定向回商家的网站，在那里他们可以查看付款结果。
CodePay Checkout页面展示
以下示例展示了CodePay托管收银台的部分页面，客户被重定向到此页面时的内容展示：
卡支付模式
QR支付模式
流程说明
- 顾客在商家网站选择商品或服务，下单，点击支付按钮，请求商家服务器开始支付。
- 商家服务器保存订单，请求CodePay服务器的CodePay托管收银台下单API，将订单信息提交给CodePay。
- CodePay验证订单信息，保存订单。
- CodePay返回收银台页面URL给商家服务器。
- 商家服务器返回CodePay收银台URL给商家网站。
- 商家网站重定向用户请求到CodePay收银台页面。第五步和第六步，也可以由商家后台进行重定向，具体实现方案商家根据需求进行选择。
- 用户在CodePay收银台选择付款方式，例如信用卡付款或QR付款，然后安全地提交相应的付款信息给后台。
- CodePay验证付款信息，并转发付款请求给银行/收单机构/第三方支付服务提供商。
- 处理支付请求，并同步返回相应处理结果。
- CodePay同步返回付款结果给CodePay收银台。并异步通知商家服务器付款结果，详情请参考交易结果通知。Webhook通知URL是商家下单时通过 “notify_url” 参数传递给CodePay的。
- CodePay收银台跳转到商家的页面，跳转URL是商家下单时通过 “return_url” 参数传递给CodePay的。
- 商家页面应通过后台的交易状态确认订单是否支付成功。展示相应的付款结果界面给用户，并提供后续的商品或服务。为防止漏单，你可以通过查询支付订单API主动查询订单状态。
开发指南
要与CodePay托管收银台进行集成，您需要发送HTTP请求并检查响应。这将把客户从商家的网站重定向到CodePay的支付页面以完成支付。您可以参考文档中的API描述及示例报文。
API列表
我们提供了一组REST API，请参阅下表，这些API提供了多种语言的SDK，请访问SDK章节。API访问规则请参考API规则。
| API名称 | 说明 |
|---|---|
| CodePay托管收银台下单 | 通过此API提交付款订单 |
| 提交退款申请 | 如果您通过此api提交退款请求，但退款没有立即到达，您可以调用退款查询界面来获取退款的进度。 |
| 查询支付订单 | 通过该api查询正向交易订单的交易结果（消费/预授权/预授权完成） |
| 查询退款订单 | 通过此api查询负面交易订单（消费取消/预授权取消/消费退款/预授权完成退款）的交易结果 |
| 交易结果通知 | 交易完成后，通知商家，告知商家交易结果 |
快速集成SDK
为了简化集成过程，我们也提供了一些语言的SDK或Demo（参见SDK/Demo章节）。该SDK通过处理大部分必要的功能，使CodePay托管收银台支付流程的实现变得更加简单。