1. iframe 对接
  • 概览
  • 集成模式
    • 收银台模式
    • 嵌入式 iframe 模式
    • Direct API 模式
    • 插件模式
  • 支付方式
    • 支付方式概览
    • 全球
      • 国际卡
      • Afterpay
      • Apple Pay
      • Google Pay
      • Klarna
    • 中国大陆&港台地区
      • Alipay CN
      • Alipay HK
      • JKO PAY
      • TWN BANK
      • WeChat Pay
    • 日韩地区
      • 日本
        • Konbini
      • 韩国
        • Kakao Pay
        • Naver Pay
        • PAYCO
    • 东南亚地区
      • 印度尼西亚
        • Akulaku
        • BNI
        • BRI
        • CIMB Clicks
        • DANA
        • Mandiri
        • Maybank
        • Nobu Bank QRIS
        • OVO
        • Permata
      • 马来西亚
        • Boost
        • Mcash
        • Touch n Go
      • 菲律宾
        • BPI
        • Coins.ph
        • GCash
        • GrabPay
        • Maya
      • 泰国
        • Bualuang iBanking
        • Krungsri Online
        • Prompt Pay
        • Rabbit LINE Pay
        • TrueMoney
      • 越南
        • Napas Card
        • VietQR
        • Zalopay
  • 开始接入
    • 申请测试商户
    • 测试验收场景
    • 上线前准备
    • 如何配置公钥
    • 请求与响应结构
    • API 签名组装规则
    • 支付完成同步跳转参数说明
    • 收银台对接
      • 收银台流程说明
    • iframe 对接
      • 国际卡支付流程(iframe)
      • 国际卡绑卡流程(iframe)
      • Google Pay 流程(iframe)
      • Apple Pay 流程(iframe)
    • Direct API 对接
      • 国际卡支付流程(Direct API)
      • WeChatPay 流程(Direct API)
      • Alipay+ 流程(Direct API)
      • Apple Pay 流程(Direct API)
  • APIs
    • 接口
      • API - 支付
      • API - 支付查询
      • API - 退款
      • API - 退款查询
      • API - 支付取消
      • API - 获取iframe凭证
      • API - 解绑
      • API - 绑卡查询
      • API - 物流上传
      • API - 支付查询-POST
    • 通知
      • Notify - 支付结果通知
      • Notify - 退款结果通知
      • Notify - 绑卡结果通知
      • Notify - 争议结果通知
  • 附录
    • 返回码
    • 业务错误码
    • 订单状态
    • 国家编码
    • 州
    • 币种
    • 承运商
    • 资源下载
      • 插件
      • 对接 SDK - Java
      • 对接 SDK - Node
  1. iframe 对接

Google Pay 流程(iframe)

适用场景
支付方式:Google Pay
集成模式:嵌入式 iframe 模式
开放能力对接清单:
API-获取iframe凭证
API-支付
API-支付查询
Notify - 支付结果通知
Google Pay 对接前准备
请您提供用于对接 Google Pay 的站点域名地址(域名需要以 HTTPS 协议开头)和付款人购物截图,用于向渠道完成申报相关工作(如果您测试和正式环境的域名不同,需要分别进行申报);
请确保您的联调环境能够访问外网,并提供测试对接的谷歌邮箱(需要未绑定过google账号),连连技术绑定完成后,您需要登录确认加入测试组;
您可以使用Google Pay的国家/地区列表;
支持的浏览器列表;

一、业务时序图#

通过 iframe 集成模式对接 Google Pay,嵌入在商家结账页面;
Google Pay - iframe 流程图.jpg
1
用户在商家网站/APP内购物下单;
2
商家客户端向后端发送请求支付指令;
3
商家服务端调用连连全球收单的 API-获取iframe凭证 获取凭证信息;
4
连连全球收单同步返回iframe凭证信息;
5
商家服务端向商家客户端传输iframe凭证信息;
6
商家客户端使用 iframe 凭证加载连连 iframe 页面到商户收银台页面,开启监听函数callBack(card_token);
7
商家客户端向用户展示结算付款页面;
8
用户选择Google Pay进行支付;
9
连连全球收单iframe模块执行回调函数callBack(card_token);
10
商家客户端组织参数向后端发送指令;
11
商家服务端调用连连全球收单的 API-支付 接口进行创单支付;
12
同步返回支付结果,Google Pay支付可能会返回用户需要3DS跳转认证;
13
商家服务端判断如果需要3DS认证,给客户端返回3DS认证地址;
14
商家客户端跳转3DS认证地址;
15
用户在3DS页面进行安全认证操作;
16
支付成功后,连连开放平台会向商家服务端发送 Notify - 支付结果通知 ,同时建议商家对接 API-支付查询 接口,确保及时更新订单状态;
17
商家服务端收到支付结果通知后,须返回固定通知响应,表示商家已处理结果,否则会重新投递消息;

二、订单处理说明#

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

三、开发说明#

准备工作#

客户端开发是基于连连 SDK 进行开发。
连连 iframe 页面渲染示例:img_v3_02gk_a26d4992-0c30-4638-a34d-bc060e7f820g.png

流程说明#

1
引入 SDK 文件
由于不同环境所使用的 SDK 文件地址不一样,商户需确认其当前环境,再进行引入。【SDK不定期更新,请使用链接引入】
测试/沙箱:https://gacashier.lianlianpay-inc.com/sandbox2/llpay.min.js
生         产:https://secure-checkout.lianlianpay.com/v2/llpay.min.js
2
商家支付界面嵌入连连 iframe 模块
编写 iframe 的父容器,id 可自定义,需要保证 mount 挂载方法里的 id 传值与此一致
创建连连 iframe 并渲染到商家支付界面,此步骤需要 iframe 凭证作为参数,iframe 凭证获取
3
开启监听函数用来接收支付所用卡凭证,待函数回调返回卡凭证,客户端组织参数提交支付

更多方法#

监听当前用户所选的支付方式
方法名称
listenPaymentMethodChange(callback)
方法说明
适用场景:商家对接iframe多种支付方式,通过监听当前用户选择的支付方式,制定不同的业务策略
参数:callback: (data: any) => void - 回调函数,接收支付方式变化的数据
返回值:返回一个卸载函数,用于停止监听支付方式变化
使用示例
切换iframe页面多语言
方法名称
setLanguage(lang: any)
方法说明
适用场景:支持商家本地化展业,可以采用当地常用语言,提高用户转化率
支持切换的多语言:葡语:pt-BR,英文:en-US,简体中文:zh-CN,繁体中文:zh-TW,日语:ja-JP;
系统会自动获取当前浏览器的语言,也支持商家自定义语言。当商家上送的语言系统暂不支持,则会自动转换为“en-US”;
使用示例

四、Demo 示例#

五、测试集成#

连连全球收单为商家提供专用测试数据,用于沙箱环境联调开发,详情查看测试验收场景
上一页
国际卡绑卡流程(iframe)
下一页
Apple Pay 流程(iframe)