# 申请开通Google支付

  1. 注册谷歌账号。

  2. 打开Google Pay | Google Developers (opens new window)并登录谷歌账号。

  3. 进入控制台Sign up: Google Pay's Business Console (opens new window) 并设置商家名称。如图:
    image-20220110010505156

  4. 设置完成后进入控制台页面,并设置对应的商家资料。
    image-20220110011030589

  5. 当需要上线正式版的时候,app的签名秘钥指纹需要确保与Google Play注册的发布秘钥指纹一致。


# 使用Google支付

环境要求

  1. 海外网络环境。
  2. 确保您的 Android 设备装有 18.0.0 或更高版本的 Google Play 服务。

支付参数
​ 谷歌支付分为两种:CARDPAYPAL付款方式,且不同付款方式配置并不相同,具体字段请参照谷歌支付官方字段说明 (opens new window)

  1. CARD 支付
参数名称 参数说明 必须
environment 环境(1:生产 3:测试)
paymentMethodType 付款方式(CARD、PAYPAL)
existingPaymentMethodRequired 如果设置为true,isReadyToPay方法就会返回true。
currencyCode 货币单位( ISO 4217)
countryCode 在欧洲经济区使用的货币单位 在欧洲经济区必填
transactionId 交易id 当想要接收googlepay回调的时候必填
totalPriceStatus 价格状态(NOT_CURRENTLY_KNOWN、ESTIMATED、FINAL)
totalPrice 总价
totalPriceLabel 显示的价格
checkoutOption 影响支付按钮显示的配置(DEFAULT、COMPLETE_IMMEDIATE_PURCHASE)
merchantName 商户名称
emailRequired 是否需要email
shippingAddressRequired 是否需要地址
shippingPhoneNumberRequired 送货地址是否需要电话号码
allowedCountryCodes 允许的国家code。
allowedAuthMethods 支持的身份校验
allowedCardNetworks 支持的卡类型(AMEX、DISCOVER、INTERAC、JCB、MASTERCARD、VISA)
allowPrepaidCards 是否支持预付卡
allowCreditCards 是否支持信用卡
assuranceDetailsRequired 是否需要付款凭据
billingAddressRequired 是否需要账单地址
billingAddressParametersFormat 账单地址格式(MIN、FULL)
phoneNumberRequired 处理交易是否需要电话号码
tokenizationSpecificationType 支付方式的token type(当支付方式是CARD的时候支持PAYMENT_GATEWAY、DIRECT。当支付方式是PayPal的时候只支持DIRECT)
gateway 支付网关详情 (opens new window) tokenizationSpecificationTypePAYMENT_GATEWAY时必填
gatewayMerchantId 支付网关的商户id tokenizationSpecificationTypePAYMENT_GATEWAY时必填
protocolVersion 加密协议版本 tokenizationSpecificationTypeDIRECT时必填
publicKey 公钥 tokenizationSpecificationTypeDIRECT时必填
buildTokenizationSpecification 自定义构造tokenizationSpecification参数,设置此字段时,会覆盖掉tokenizationSpecificationTypegatewaygatewayMerchantIdprotocolVersionpublicKey字段。(HBuilderX 3.5.1+支持)
  1. PAYPAL 支付
参数名称 参数说明 必须
environment 环境(1:生产 3:测试)
paymentMethodType 付款方式(CARD、PAYPAL)
existingPaymentMethodRequired 如果设置为true,isReadyToPay方法就会返回true。
currencyCode 货币单位( ISO 4217)
countryCode 在欧洲经济区使用的货币单位 在欧洲经济区必填
transactionId 交易id 当想要接收googlepay回调的时候必填
totalPriceStatus 价格状态(NOT_CURRENTLY_KNOWN、ESTIMATED、FINAL)
totalPrice 总价
totalPriceLabel 显示的价格
checkoutOption 影响支付按钮显示的配置(DEFAULT、COMPLETE_IMMEDIATE_PURCHASE)
merchantName 商户名称
emailRequired 是否需要email
shippingAddressRequired 是否需要地址
shippingPhoneNumberRequired 送货地址是否需要电话号码
allowedCountryCodes 允许的国家code。
merchant PayPal的商户id

# 示例


plus.payment.getChannels((providers) => {
					let provider = providers.find(function(e) {
						return e.id === "google-pay";
					});

					let paymentMethodType = "CARD";
					
					let cardPaymentMethodConfig = {
						environment: 3, // 必填 1 是product  3是test
						paymentMethodType: paymentMethodType, //必填 CARD、PAYPAL
						existingPaymentMethodRequired: false, //可选 如果设置为true同时已经准备好了支付allowedPaymentMethods中的付款方式,isReadyToPay就会返回true。
					
						currencyCode: "USD", //必填
						countryCode: "US", //在欧洲经济区必填
						transactionId: "", //当你想要接收googlepay回调的时候必填
						totalPriceStatus: "FINAL", //必填  NOT_CURRENTLY_KNOWN、ESTIMATED、FINAL
						totalPrice: "111.00", //必填 满足正则格式^[0-9]+(\.[0-9][0-9])?$
						totalPriceLabel: "100heelo", //可选
						checkoutOption: "DEFAULT", //可选 DEFAULT、COMPLETE_IMMEDIATE_PURCHASE
					
						merchantName: "Example Merchant", //可选
						emailRequired: true, //可选
						shippingAddressRequired: true, //可选
						shippingPhoneNumberRequired: false, //可选
						allowedCountryCodes: ["US", "GB"], //可选
						allowedAuthMethods: ["PAN_ONLY", "CRYPTOGRAM_3DS"], //必填
						allowedCardNetworks: ["AMEX", "DISCOVER", "JCB", "MASTERCARD", "VISA"], //必填
						allowPrepaidCards: false, //可选
						// allowCreditCards:false,//可选  
						assuranceDetailsRequired: false, //可选
						billingAddressRequired: true, //可选
						billingAddressParametersFormat: "FULL", //可选 MIN
						phoneNumberRequired: false, //可选
						tokenizationSpecificationType: "PAYMENT_GATEWAY", //必填 PAYMENT_GATEWAY、DIRECT
						gateway: "example", //PAYMENT_GATEWAY时必填
						gatewayMerchantId: "exampleGatewayMerchantId", //PAYMENT_GATEWAY时必填
						protocolVersion: "", //DIRECT时必填
						publicKey: "", //DIRECT时必填
            buildTokenizationSpecification:{//可选,此字段是为了方便开发者自定义构造tokenizationSpecification参数,设置此字段时,会覆盖掉`tokenizationSpecificationType`、`gateway`、`gatewayMerchantId`、`protocolVersion`、`publicKey`字段。(HBuilderX 3.5.1+支持)
							"type":"PAYMENT_GATEWAY",
							"parameters":{
								"gateway":"custom-gateway",
								"gatewayMerchantId":"mock-gatewayMerchantId"
							}
						}
					};
					

					let paypalPaymentMethodConfig = {
						environment: 3, // 必填 1 是product  3是test
						paymentMethodType: paymentMethodType, //必填 CARD、PAYPAL
						existingPaymentMethodRequired: false, //可选 如果设置为true同时已经准备好了支付allowedPaymentMethods中的付款方式,isReadyToPay就会返回true。

						currencyCode: "USD", //必填
						countryCode: "US", //在欧洲经济区必填
						transactionId: "", //当你想要接收googlepay回调的时候必填
						totalPriceStatus: "FINAL", //必填  NOT_CURRENTLY_KNOWN、ESTIMATED、FINAL
						totalPrice: "111.00", //必填 满足正则格式^[0-9]+(\.[0-9][0-9])?$
						totalPriceLabel: "100heelo", //可选
						checkoutOption: "DEFAULT", //可选 DEFAULT、COMPLETE_IMMEDIATE_PURCHASE

						merchantName: "Example Merchant", //可选
						emailRequired: true, //可选
						shippingAddressRequired: true, //可选
						shippingPhoneNumberRequired: false, //可选
						allowedCountryCodes: ["US", "GB"], //可选
						merchantId: "MVHSBANAS6KSE", //必填
					};

					let statement;

					if (paymentMethodType === "CARD") {
						statement = {
							...cardPaymentMethodConfig
						};
					} else {
						statement = {
							...paypalPaymentMethodConfig
						};
					}

					console.log(JSON.stringify(statement));

					plus.payment.request(provider, statement, (result) => {
						console.log("支付成功 :" + JSON.stringify(result));
					}, (e) => {
						console.log("支付失败: " + JSON.stringify(e));
					})
				});