• 概览
  • 集成模式
  • 支付方式
  • 开始接入
    • 申请测试商户
    • 测试验收场景
    • 上线前准备
    • 如何配置公钥
    • 请求与响应结构
    • API 签名组装规则
    • 收银台对接
    • iframe 对接
    • Direct API 对接
      • 国际卡支付流程(Direct API)
      • WeChatPay 流程(Direct API)
      • Alipay+ 流程(Direct API)
  • APIs
  • 附录
亮色模式
  1. 开始接入
  2. Direct API 对接

国际卡支付流程(Direct API)

:::tip[]
适用场景

  • 支付方式:国际卡支付
  • 集成模式:Direct API 模式

开放能力对接清单:

  • API-支付
  • API-支付查询
  • Notify - 支付结果通知
    :::

一、业务时序图

:::tip[]
通过 Direct API 集成模式对接国际卡支付,商家需拥有 PCI 资质认证;
:::
jicheng-api.png

用户在商家网站/APP内购物下单; 商家客户端向后端发送支付指令; **商家服务端调用连连全球收单的 [API-支付](https://doc.lianlianpay.com/3476473e0?nav=2) 接口进行创单支付**; **同步返回支付结果,国际卡支付可能会返回用户需要3DS跳转认证;** 商家服务端判断如果需要3DS认证,给客户端返回3DS认证地址; 商家客户端跳转3DS认证地址; 用户在3DS页面进行安全认证操作; **支付成功后,连连开放平台会向商家服务端发送 [Notify - 支付结果通知](https://doc.lianlianpay.com/3476484e0?nav=2) ,同时建议商家对接 [API-支付查询](https://doc.lianlianpay.com/3476474e0?nav=2) 接口,确保及时更新订单状态;** **商家服务端收到支付结果通知后,须返回固定通知响应,表示商家已处理结果,否则会重新投递消息;** 商家客户端更新订单支付结果;

二、订单处理说明

- `payment_status = "PS"` 时,说明连连创单成功且支付完成,商家可以更新自己的订单状态; - `payment_status = "PP"` & `3ds_status = ""` 时,说明连连创单成功且向银行支付请求完成,银行正在处理该请求,支付结果会以开放消息方式通知给商家指定的 `notification_url` 服务地址; - `payment_status = "PP"` & `3ds_status = "CHALLENGE"` 时,此种结果需要买家完成 3ds 认证,商家系统需要控制页面跳转到 `payment_url` 地址,这个地址会跳转到银行 3ds 认证页面,买家完成 3ds 认证后连连全球收单会自动发起支付,支付结果会以开放消息方式通知给商家指定的 `notification_url` 服务地址; - 支付失败结果中 `return_code`,`return_msg` 中提示原因,可以将 `return_code` 映射为商家自己的支付提示信息;

:::info[]
支持通过已绑定的卡进行支付,但需注意,支付时需要将“卡凭证标识”通过传入 API-支付 中 payment_data.card.card_token 字段,代替卡信息传给连连全球收单;
:::

三、测试集成

  • 连连全球收单为商家提供专用测试数据,用于沙箱环境联调开发,详情查看测试验收场景