dLocal China
Search…
Google Pay™
Google Pay是一种便捷的付款系统,客户可以使用保存在其Google帐户中的信用卡或借记卡在APP或网站中进行付款。
由于Google设备在dLocal运营的国家/地区中广泛使用,因此只要是此前在Google Pay账户中保存或使用了信用卡、借记卡的客户,就可以在支持Google Pay的APP中直接付款,可以简化结帐付款流程并提高转化率
自2020年1月起,在以下国家/地区中支持Google Pay:阿根廷,巴西,智利,哥伦比亚,埃及,印度,印度尼西亚,墨西哥,秘鲁,乌拉圭。
有关支持国家/地区最新列表,请参考: https://support.google.com/pay/answer/9023773?hl=en​ 。
有关支持的卡支付的详细信息,请参考“付款方式”部分。

支付流程

  1. 1.
    用户在商户前端(在线网站或APP)中选择使用Google Pay, 商户使用Google Pay Web API或Android SDK发起Google Pay支付请求
  2. 2.
    在用户选择付款方式或提供付款明细后,Google回复支付 token
  3. 3.
    商户将此信息提交到商户的后端发起付款
  4. 4.
    商户将步骤2中接收到的token包含在付款请求中,向dLocal 发起付款
  5. 5.
    dLocal使用收到的Google Pay token 处理付款并将付款确认返回给商户
  6. 6.
    商户通知客户付款已成功

集成

按照如下两步支持 Google Pay:

1 - Google 集成 (前端)

执行此步骤时,请使用以下参数:
  • gatewayMerchantId – 请联系你们集成技术客户经理获取
  • gateway - 使用 dlocal 作为参数值
  • 必需的参数: Name, address, phone, 和 email
所需document资料
在用户单击Google Pay按钮之前或之后,请先收集用户的个人ID,并将其发送到 payer 对象中的document字段,因为这是付款的必要条件。
支持的付款方式
关于付款类型,使用 CARD参数,以下是当前支持的卡种类型:
  • VISA
  • ELECTRON
  • MASTERCARD
  • MAESTRO
  • AMEX
  • DISCOVER
  • JCB (仅限于巴西)
  • ELO (仅限于巴西)
  • ELO_DEBIT (仅限于巴西)
关于鉴权方式,使用PAN_ONLY

2 - dLocal 集成 (后端)

使用如下参数向 https://api.dlocal.com/secure_payments 接口发起标准付款请求:
  • payment_method_id 必须是 CARD
  • card.gpay_token 应该是在Google集成步骤中获得的json,需要注意此处需要发送json对象而不是字符串。
付款请求示例
付款响应示例

请求 body 示例

1
{
2
"amount": 120.00,
3
"currency" : "BRL",
4
"country": "BR",
5
"payment_method_id" : "CARD",
6
"payment_method_flow" : "DIRECT",
7
"payer":{
8
"document" : "53033315550",
9
"name": "Ricardo Gomes"
10
},
11
"card":{
12
"gpay_token": {
13
"signature": "MEQCIBllBeoYFjIvIjPZmYG..."
14
}
15
},
16
"order_id": "657434343",
17
"notification_url": "http://merchant.com/notifications"
18
}
Copied!

付款响应示例

1
{
2
"id": "D-4-cf8eef6b-52d5-4320-b5ea-f5e0bbe4343f",
3
"amount": 120.00,
4
"currency": "BRL",
5
"payment_method_id": "CARD",
6
"payment_method_type": "CARD",
7
"payment_method_flow": "DIRECT",
8
"country": "BR",
9
"card": {
10
"holder_name": "Ricardo Gomes",
11
"expiration_month": 12,
12
"expiration_year": 2025,
13
"brand": "VI",
14
"last_4": "1111"
15
},
16
"created_date": "2018-12-26T20:26:09.000+0000",
17
"approved_date": "2018-12-26T20:26:09.000+0000",
18
"status": "PAID",
19
"status_detail": "The payment was paid",
20
"status_code": "200",
21
"order_id": "657434343",
22
"notification_url": "http://merchant.com/notifications"
23
}
Copied!

准备上线

在测试环境中完成集成过程的所有必要步骤后,请确保您已申请 Google Production Access,如 Google WebAndroid 文档中所述,并已更新了Google Production集成配置(第1步)中提到的生产环境权限。最后,请确保您已联系您的技术客户经理,以便我们可以帮助您检查所有配置是否正确,并确认您已准备就绪。