From 7595fb3d9329d487a9522908b41e5d1a0e79fe0c Mon Sep 17 00:00:00 2001 From: yanyilin Date: Tue, 11 Jan 2022 10:01:23 +0000 Subject: [PATCH] update docs/app-payment-google.md. --- docs/app-payment-google.md | 109 +++++++++++++++++++++---------------- 1 file changed, 62 insertions(+), 47 deletions(-) diff --git a/docs/app-payment-google.md b/docs/app-payment-google.md index e4a0e1532..9de3483df 100644 --- a/docs/app-payment-google.md +++ b/docs/app-payment-google.md @@ -1,31 +1,29 @@ #### 申请开通Google支付 -1. 注册谷歌账号。 +1. 注册谷歌账号。 -2. 打开[Google Pay | Google Developers](https://developers.google.com/pay)并登录谷歌账号。 +2. 打开[Google Pay | Google Developers](https://developers.google.com/pay)并登录谷歌账号。 -3. 进入控制台[Sign up: Google Pay's Business Console](https://pay.google.com/business/console/?pli=1) 并设置商家名称。如图： +3. 进入控制台[Sign up: Google Pay's Business Console](https://pay.google.com/business/console/?pli=1) 并设置商家名称。如图： +![image-20220110010505156](https://native-res.dcloud.net.cn/images/uniapp/payment/googlepay_register_business.png) - ​ ![image-20220110010505156](https://gitee.com/duoguang/md-image/raw/master/image-20220110010505156.png) - -4. 设置完成后进入控制台页面，并设置对应的商家资料。 - - ![image-20220110011030589](https://gitee.com/duoguang/md-image/raw/master/image-20220110011030589.png) +4. 设置完成后进入控制台页面，并设置对应的商家资料。 +![image-20220110011030589](https://native-res.dcloud.net.cn/images/uniapp/payment/googlepay_merchants_setup.png) 5. 当需要上线正式版的时候，app的签名秘钥指纹需要确保与`Google Play`注册的发布秘钥指纹一致。 ------ -#### 使用Google支付 +#### 使用Google支付 -**环境要求** +**环境要求** 1. 海外网络环境。 2. 确保您的 Android 设备装有 18.0.0 或更高版本的 Google Play 服务。 -**支付参数** -由于谷歌支付参数较多，并且区分付款方式，且不同付款方式配置并不相同，所以需要开发者在`公共配置`的基础上根据不同的支付方式追加对应的配置。具体字段请参照[谷歌支付官方字段说明](https://developers.google.com/pay/api/android/reference/request-objects?authuser=1#PaymentMethod) +**支付参数** +​ 谷歌支付分为两种:`CARD`、`PAYPAL`付款方式，且不同付款方式配置并不相同，具体字段请参照[谷歌支付官方字段说明](https://developers.google.com/pay/api/android/reference/request-objects?authuser=1#PaymentMethod) -###### 公共配置 +1. `CARD` 支付 | 参数名称 | 参数说明 | 必须 | |-------------|-------|-----| |environment|环境（1：生产 3：测试）|是| @@ -43,19 +41,11 @@ |shippingAddressRequired|是否需要地址|否| |shippingPhoneNumberRequired|送货地址是否需要电话号码|否| |allowedCountryCodes|允许的国家code。|否| - -###### 付款方式配置 - -​ 付款方式分为两种:`CARD`、`PAYPAL`，所以参数列表所以根据`paymentMethodType`参数区分为以下两种。 - -1. `CARD` 支付 -| 参数名称 | 参数说明 | 必须 | -|-------------|-------|-----| |allowedAuthMethods|支持的身份校验|是| |allowedCardNetworks|支持的卡类型（AMEX、DISCOVER、INTERAC、JCB、MASTERCARD、VISA）|是| |allowPrepaidCards|是否支持预付卡|否| |allowCreditCards|是否支持信用卡|否| -|assuranceDetailsRequired||否| +|assuranceDetailsRequired|是否需要付款凭据|否| |billingAddressRequired|是否需要账单地址|否| |billingAddressParametersFormat|账单地址格式（MIN、FULL）|否| |phoneNumberRequired|处理交易是否需要电话号码|否| @@ -69,11 +59,28 @@ 2. `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|是| + #### 示例 ```js + plus.payment.getChannels((providers) => { let provider = providers.find(function(e) { return e.id === "google-pay"; @@ -81,9 +88,9 @@ plus.payment.getChannels((providers) => { let paymentMethodType = "CARD"; - let statement = { + let cardPaymentMethodConfig = { environment: 3, // 必填 1 是product 3是test - paymentMethodType: paymentMethodType,//必填 CARD、PAYPAL + paymentMethodType: paymentMethodType, //必填 CARD、PAYPAL existingPaymentMethodRequired: false, //可选 如果设置为true同时已经准备好了支付allowedPaymentMethods中的付款方式，isReadyToPay就会返回true。 currencyCode: "USD", //必填 @@ -99,17 +106,6 @@ plus.payment.getChannels((providers) => { shippingAddressRequired: true, //可选 shippingPhoneNumberRequired: false, //可选 allowedCountryCodes: ["US", "GB"], //可选 - }; - - - - let paymentMethodConfig = {}; - - let paypalPaymentMethodConfig = { - merchantId: "", //必填 - }; - - let cardPaymentMethodConfig = { allowedAuthMethods: ["PAN_ONLY", "CRYPTOGRAM_3DS"], //必填 allowedCardNetworks: ["AMEX", "DISCOVER", "JCB", "MASTERCARD", "VISA"], //必填 allowPrepaidCards: false, //可选 @@ -124,25 +120,41 @@ plus.payment.getChannels((providers) => { protocolVersion: "", //DIRECT时必填 publicKey: "", //DIRECT时必填 }; + + let paypalPaymentMethodConfig = { + environment: 3, // 必填 1 是product 3是test + paymentMethodType: paymentMethodType, //必填 CARD、PAYPAL + existingPaymentMethodRequired: false, //可选 如果设置为true同时已经准备好了支付allowedPaymentMethods中的付款方式，isReadyToPay就会返回true。 - if (paymentMethodType === "PAYPAL") { - paymentMethodConfig = { - ...paypalPaymentMethodConfig + 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 { - paymentMethodConfig = { - ...cardPaymentMethodConfig + statement = { + ...paypalPaymentMethodConfig }; } - - - statement = { - ...statement, - ...paymentMethodConfig - }; - console.log(JSON.stringify(statement)); plus.payment.request(provider, statement, (result) => { @@ -151,5 +163,8 @@ plus.payment.getChannels((providers) => { console.log("支付失败： " + JSON.stringify(e)); }) }); + + ``` + -- GitLab