# Google Pay API（待上线）

当你想在你自己的网站上通过使用Google Pay™时，你可以参阅本文档的内容以便集成Google支付。

### 1.流程概览

调用支付接口进行支付，需要重点解决3ds场景

<figure><img src="https://2979444288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQHZQcHwx5gTbDr4V6t%2Fuploads%2F0Rlw6WXHvmnOKSEnvAea%2Fa.svg?alt=media&#x26;token=24115398-1d65-45d5-ac57-d60405c8ab0d" alt=""><figcaption></figcaption></figure>

如果返回的参数中的ResultCode = challenge 或者 ResultCode = gather，则代表当前交易触发了3DS挑战，关于3DS挑战的后续处理，请参考：[UseePay 3DS流程](https://app.apifox.com/project/2772040)

### 2.详细流程

#### 1.生成生成Useepay 交易信息

交易信息参数详见[交易参数说明](https://useepay.gitbook.io/developer/reference/api-reference-xin-yong-ka/parameter-description#userinfo)

注：**paymentMethod**应设置为”googlepay“

#### 2.生成Google Pay PaymentData信息

关于网站集成Google Pay的更多信息，请参考：

[Google Pay 网站开发者文档](https://developers.google.com/pay/api/web?hl=zh-cn)

[Google Pay 网站集成核对清单](https://developers.google.com/pay/api/web/guides/test-and-deploy/integration-checklist?hl=zh-cn)

[Google Pay 网站品牌推广指南](https://developers.google.com/pay/api/web/guides/brand-guidelines?hl=zh-cn)

**重点**

下面是关于支付相关的重点配置信息，请在开发时做好相应的适配：

1.由于Useepay支付系统支持3DS，因此在设置**allowedCardAuthMethods**参数时，请设置为：

```
this.allowedCardAuthMethods = ["PAN_ONLY", "CRYPTOGRAM_3DS"];
```

并参考[UseePay 3DS流程](https://app.apifox.com/project/2772040)做好3DS后续流程。

2.在设置交易卡组时，请事先联系Useepay客服，根据相应地区咨询可以使用的卡组，并设置相应的参数，如：

```
this.allowedCardNetworks = ["AMEX", "DISCOVER", "JCB", "MASTERCARD", "VISA"];
```

3.交易的指定付款服务机构需设置为Useepay，并设置相应的参数：

```
const tokenizationSpecification = {
  type: 'PAYMENT_GATEWAY',
  parameters: {
    'gateway': 'useepay',
    'gatewayMerchantId': 'useepayGatewayMerchantId'
  }
};
```

4.如果测试环境，请根据官方文档使用Google Pay Test Merchant ID,在切换生产环境时，请将**merchantInfo**更换为联系Useepay工作人员确定后的merchantId值，并将参数设置为：

```
paymentDataRequest.merchantInfo = {
  merchantName: '指定的merchantName'
  merchantId: '指定的merchantId'
};
```

#### 3.组装参数并加签

生成交易参数和Google Pay paymentData后，你应该得到如下的一个对象：

```
tradeRequest = {
    merchantNo : 'XXXX',
    transactionId : 'XXXX',
    transactionType : 'XXXX',
    ...
    payload : paymentData.paymentMethodData.tokenizationData.token
}
```

对上述参数按照[Useepay签名](https://app.apifox.com/project/2038036/apis/api-67385706)进行加签

#### 4.调用支付接口

> 接口地址：
>
> prod：<https://pay-gateway.useepay.com/googlepay/api>
>
> test：<https://pay-gateway1.uat.useepay.com/googlepay/api>

使用**post**方法将加签后的**tradeRequest**对象请求到对应环境的接口地址中，并进行相应的异常处理及回调处理，如果触发3DS，请进行相应的的3DS处理

<br>