关于预授权:
Ps:预授权完成最好在3个工作日内完成,否则万事达卡会被加收0.033欧元+0.28%的手续费,同时,超过3天的预授权拒付是无法申诉的。
cashier接口说明#
如果您希望通过跳转式收银台支持您网站的交易活动,您需要完成的核心内容只有两步:
【1】调用cashier接口,UseePay在响应中会返回一个收银台url(redirectUrl字段)
【2】向消费者展示该url对应的页面(即收银台),消费者将在此完成支付。时序图#
时序图图解#
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接口,再次将支付结果通知给商户,避免因同步通知异常导致商户信息缺失。
请求参数对象说明#
| 参数 | 必选 | 类型 | 说明 | 
|---|
| paymentMethod | Y | string | 传递您实际需要的支付方式,详情请查看文档【paymentMethod参数说明】 | 
| authorizationMethod | Y | string | AuthorizationMethod(用户授权方式:cvv/threeds1.0/threeds2.0): 这个字段生产环境传cvv,cvv (普通交易)threeds2.0 (3D)
 当客户的卡 需要3ds时我们会动态转成3d。 只是对接测试的时候 可以根据自己需要的场景切换
 cvv/threeds2.0。 threeds1.0现在我们不支持传,3d一般都走2.0流程,即使客户的卡只支持1.0,
 我们也会自动降级的
 | 
| billingAddress | Y | Json String | 账单地址 (请根据交易类型:实物类交易/虚拟类交易传参) | 
| firstName | N | String(56) | 持卡人名(如果为空,则UseePay会用账单/收货地址姓名填充) | 
| lastName | N | String(56) | 持卡人名(如果为空,则UseePay会用账单/收货地址姓名填充) | 
| threeDS2RequestData | N |  | 3ds请求参数 |