注意

关于预授权:
Ps:预授权完成最好在3个工作日内完成，否则万事达卡会被加收0.033欧元+0.28%的手续费，同时，超过3天的预授权拒付将无法申诉。

1. 跳转式收银台对接流程

1.1 概述

如果您希望通过跳转式收银台支持您网站的交易活动，您主要需要完成的操作有：
【1】调用cashier接口，UseePay在响应中会返回一个收银台url（redirectUrl字段）
【2】向消费者展示该url对应的页面（即收银台），消费者将在此完成支付。
【3】接收UseePay的同步/异步交易结果通知
核心内容是 /cashier接口的对接。

1.2 对接时序图

1.3 时序图图解

1）发起支付请求

用户触发支付：用户在商户平台上点击“支付”按钮，正式发起支付请求，这是整个支付流程的起点，由用户主动触发交互。

商户调用支付接口：商户接收到用户的支付请求后，向UseePay Server调用/cashier接口，将用户的支付需求传递给支付服务端。

2）展示收银台页面

支付服务端返回跳转链接：UseePay Server处理商户的接口请求后，向商户返回包含收银台页面地址的redirectUrl响应，为用户后续输入支付信息提供页面入口。

商户展示收银台页面：商户获取到redirectUrl后，将该链接对应的收银台页面展示给用户，使用户能够进入支付信息输入环节。

3）提交支付信息

用户输入支付信息并提交：用户在UseePay收银台页面中输入银行卡号（CardNo）、安全码（CVV）等支付相关信息，完成后点击支付按钮，向UseePay收银台提交支付确认请求。

收银台请求支付确认：UseePay收银台接收到用户的支付确认指令后，将该请求传递给UseePay Server，由服务端处理实际的支付流程。

支付服务端返回支付结果：UseePay Server完成支付处理后，向UseePay收银台返回支付结果，告知支付成功与否等信息。

收银台同步通知商户支付结果：UseePay收银台展示支付结果给用户的同时，通过同步调用商户的/cashier接口，将支付结果及相关的redirectUrl页面信息传输给商户，确保商户及时获取支付状态。

4）接收交易通知

支付服务端异步通知商户：为进一步保障商户对支付结果的获取，UseePay Server通过异步调用商户的notifyUrl接口，将支付的最终结果通知给商户，业务结果必须通过异步通知判断。

至此完成一次从用户发起支付到最终完成支付并通知商户的完整闭环。

2. 如何指定收银台的支付方式？

对于不同的商户而言，其消费者群体和商户有资质使用的支付方式通常是不同的。
例如欧美地区通常使用信用卡，东南亚则更倾向于本地化支付。

故需要商户在请求中，通过payerInfo.paymentMethod参数来向UseePay说明，当前收银台应当展示哪些支付方式。

UseePay Server将根据您请求中payerInfo.paymentMethod参数的值，响应对应的收银台界面。

注意

由于文档难免存在时效性差异，所以如果您在开发中不确定UseePay是否支持某种支付方式时，请及时咨询UseePay运营。

2.1 paymentMethod参数取值

针对不同的需求，payerInfo.paymentMethod可以传递的值如下：

paymentMethod	效果
不传（为空）	显示商户所有支持的支付方式
credit_card	显示商户所有支持的支付方式
credit_card_only	只显示信用卡
credit_card_ignore	显示商户除了信用卡以外的支付方式
googlepay,applepay,pix ...	传输了多个支付方式，一一展示传输的支付方式
googlepay	只传输一种支付方式，只展示这种支付方式。如此处只展示googlepay。只指定一种支付方式时通常是有特殊业务需求，请多参考该支付方式的对接文档
其他UseePay支持的支付方式...	展示对应的支付方式

2.2 演示

假设商户当前支持的支付方式有 credit_card,googlepay,wechat_native
paymentMethod取不同值时的实际显示效果如下：

paymentMethod为空
默认显示商户所有支持的支付方式

credit_card
显示商户所有支持的支付方式

credit_card_only
只显示信用卡

credit_card_ignore
显示商户除了信用卡之外的支付方式

googlepay,wechat_native
显示所有传输过来的支付方式

googlepay
只展示这一种支付方式

跳转式收银台对接流程

1. 跳转式收银台对接流程#

1.1 概述#

1.2 对接时序图#

1.3 时序图图解#

1） 发起支付请求#

2） 展示收银台页面#

3） 提交支付信息#

4） 接收交易通知#

2. 如何指定收银台的支付方式？#

2.1 paymentMethod参数取值#

2.2 演示#

1. 跳转式收银台对接流程

1.1 概述

1.2 对接时序图

1.3 时序图图解

1）发起支付请求

2）展示收银台页面

3）提交支付信息

4）接收交易通知

2. 如何指定收银台的支付方式？

2.1 paymentMethod参数取值

2.2 演示