教程

如果您的 Android 应用是通过 Google Play 商店发布的，则您可以将其与 Google Pay API 集成。您还可以将其配置为接受支付卡。要集成应用并将其配置为接受支付卡，请按照本教程中的步骤进行操作。

• 第 1 步：指定您的 Google Pay API 版本。
• 第 2 步：为您的付款服务机构申请付款令牌。
• 第 3 步：指定支持的支付卡网络。
• 第 4 步：说明您允许的付款方式。
• 第 5 步：创建 PaymentsClient 实例。
• 第 6 步：确定是否能使用 Google Pay API 进行付款。
• 第 7 步：创建 PaymentDataRequest 对象。
• 第 8 步：为用户手势注册事件处理程序。
• 第 9 步：处理响应对象。
• 总结。

第 1 步：指定您的 Google Pay API 版本

声明您的应用所使用的 Google Pay API 版本。该主要及次要版本会影响每个传递对象中预期的字段，并且会包含在响应中。

创建基本请求对象，其中包含所有其他请求对象中存在的属性。

Kotlin

    private val baseRequest = JSONObject().apply {
        put("apiVersion", 2)
        put("apiVersionMinor", 0)
    }
PaymentsUtil.kt

Java

  private static JSONObject getBaseRequest() throws JSONException {
    return new JSONObject().put("apiVersion", 2).put("apiVersionMinor", 0);
  }
PaymentsUtil.java

第 2 步：为您的付款服务机构申请付款令牌

Google 会加密付款人所选卡的相关信息，以便付款服务机构进行安全处理。

Kotlin

private fun gatewayTokenizationSpecification(): JSONObject {
    return JSONObject().apply {
        put("type", "PAYMENT_GATEWAY")
        put("parameters", JSONObject(mapOf(
                "gateway" to "example",
                "gatewayMerchantId" to "exampleGatewayMerchantId")))
    }
}

Java

  private static JSONObject getGatewayTokenizationSpecification() throws JSONException {
    return new JSONObject() {{
      put("type", "PAYMENT_GATEWAY");
      put("parameters", new JSONObject() {{
        put("gateway", "example");
        put("gatewayMerchantId", "exampleGatewayMerchantId");
      }});
    }};
  }
PaymentsUtil.java

将 example 和 exampleGatewayMerchantId 替换为付款服务机构的相应值。请使用下表查找您的付款服务机构的具体 gateway 和 gatewayMerchantId 值：

网关	参数和文档
ABA PayWay	"gateway": "ababank" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
accept.blue	"gateway": "acceptblue" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
ACI	"gateway": "aciworldwide" "gatewayMerchantId": "YOUR_ENTITY_ID" 开发者文档
ACpay	"gateway": "acpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Acquired.com	"gateway": "acquired" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Adyen	"gateway": "adyen" "gatewayMerchantId": "YOUR_MERCHANT_ACCOUNT_NAME" 开发者文档
Airba Pay	"gateway": "airbapay" "gatewayMerchantId": "YOUR_MERCHANT_ACCOUNT_NAME" 开发者文档
Airvend	"gateway": "airvend" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Airwallex	"gateway": "airwallex" "gatewayMerchantId": "YOUR_MERCHANT_ACCOUNT_NAME" 开发者文档
Akurateco	"gateway": "akuratecolab" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Alfa-Bank	"gateway": "alfabank" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Algoritma	"gateway": "algoritma" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Allinpay	"gateway": "allinpayintl" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
AllPayments	"gateway": "allpayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
alticepay	"gateway": "alticepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Anedot	"gateway": "anedot" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
ApcoPay	"gateway": "apcopay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
APPEX	"gateway": "epos" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
AsiaBill	"gateway": "asiabill" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 没有开发者文档
Assist	"gateway": "assist" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Assist Belarus	"gateway": "belassist" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Assist Kazakhstan	"gateway": "assistkz" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Aurus	"gateway": "auruspay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Axerve	"gateway": "gestpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Bank 131	"gateway": "bank131" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Bank Vostok	"gateway": "bankvostok" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Barclaycard	"gateway": "barclayssmartpayadvance" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Barion	"gateway": "barion" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
BCC.KZ	"gateway": "bccpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
bePaid	"gateway": "ecomcharge" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Bereke Bank	"gateway": "berekepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
结算系统	"gateway": "billingsystems" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Bizzon	"gateway": "bizzon" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Blocks	"gateway": "blocks" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Bluefin	"gateway": "bluefin" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Blue Media	"gateway": "bluemedia" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
BlueSnap	"gateway": "bluesnap" "gatewayMerchantId": "YOUR_shopToken" 开发者文档
BPC	"gateway": "bpcpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
BR-DGE	"gateway": "comcarde" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Braintree	"gateway": "braintree" "braintree:apiVersion": "v1" "braintree:sdkVersion": "braintree.client.VERSION" "braintree:merchantId": "YOUR_BRAINTREE_MERCHANT_ID" "braintree:clientKey": "YOUR_BRAINTREE_TOKENIZATION_KEY" 开发者文档
Braspag	"gateway": "cielo" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
BridgerPay	"gateway": "bridgerpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
BT Pay	"gateway": "btpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Buya	"gateway": "buya" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
CardCom	"gateway": "cardcom" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
CardConnect	"gateway": "cardconnect" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Cardknox	"gateway": "cardknox" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Cardstream	"gateway": "crst" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Cashflows	"gateway": "cashflowsgateway" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Cathay United Bank	"gateway": "cathaybk" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
CCAvenue UAE	"gateway": "ccavenueuae" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Cecabank	"gateway": "cecabank" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Celerispay	"gateway": "celerispay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
CentralPay	"gateway": "centralpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Chargehive	"gateway": "chargehive" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
CharityEngine	"gateway": "charityengine" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Chase Merchant Services	"gateway": "chase" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Checkout.com	"gateway": "checkoutltd" "gatewayMerchantId": "YOUR_PUBLIC_KEY" 开发者文档
CityPay	"gateway": "citypay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Cloud9 Payment Gateway (C9PG)	"gateway": "c9pg" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
CloudPayments	"gateway": "cloudpayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
CloudWalk	"gateway": "cloudwalk" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Computop	"gateway": "computop" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
ConcordPay	"gateway": "concordpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Connectum	"gateway": "connectum" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
ConnexPay	"gateway": "connexpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Corefy	"gateway": "paycoreio" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Corvus Pay	"gateway": "corvuspay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Credorax	"gateway": "credorax" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
CrossPay	"gateway": "crosspay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
CSG Forte	"gateway": "csgforte" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
CTBC Bank	"gateway": "ctbcbank" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
CURO Payments	"gateway": "curopayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
CYBERBIZ	"gateway": "cyberbizpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Cybersource	"gateway": "cybersource" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
danube.pay	"gateway": "danubepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Datacap Systems, Inc.	"gateway": "datacap systems inc." "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Datatrans	"gateway": "datatrans" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
DECTA	"gateway": "decta" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 没有开发者文档
Deutsche Bank AG	"gateway": "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 没有开发者文档
Deutsche Bank – Merchant Solutions	"gateway": "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
DG Financial Technology, Inc.	"gateway": "veritrans" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Digital Finance	"gateway": "digitalfinance" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
dLocal	"gateway": "dlocal" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
DNA Payments	"gateway": "dnapayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Dojo	"gateway": "dojo" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Dotpay	"gateway": "dotpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
e-SiTef - Software Express	"gateway": "softwareexpress" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
easycard	"gateway": "easycard" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
EasyPay	"gateway": "easypay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
EBANX	"gateway": "ebanx" "gatewayMerchantId": "YOUR_PUBLIC_INTEGRATION_KEY" 开发者文档
eCard	"gateway": "ecard" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
ECOMMPAY	"gateway": "ecommpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Ecopaynet	"gateway": "ecopaynet" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
ECPay	"gateway": "ecpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 没有开发者文档
eGHL	"gateway": "eghl" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Elavon (Converge)	"gateway": "convergepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Emerchantpay	"gateway": "emerchantpay" "gatewayMerchantID": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
emspay	"gateway": "emsonline" "gatewayMerchantID": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Encoded	"gateway": "encoded" "gatewayMerchantID": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
EpicPay	"gateway": "epicpay" "gatewayMerchantID": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Espago	"gateway": "espago" "gatewayMerchantID": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
EveryPay	"gateway": "everypay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
EVONET	"gateway": "cardinfolink" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Evopay	"gateway": "evopay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Evo Payment Gateway	"gateway": "evopaymentgateway" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 没有开发者文档
exactly.com	"gateway": "exactly" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Exact Payments	"gateway": "exactpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Fat Zebra	"gateway": "fatzebra" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Fenige	"gateway": "fenige" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Fibonatix	"gateway": "fibonatixparagon" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Financial Line	"gateway": "finline" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Finanso UA	"gateway": "finansoua" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
FINEXUS	"gateway": "finexus" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Finix	"gateway": "finix" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
First American by Deluxe	"gateway": "firstpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
First Data (Payeezy)	"gateway": "firstdata" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
FIS Biller Solutions	"gateway": "fisglobalbsp" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Fluid Pay	"gateway": "fluidpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
FM Finance LTD	"gateway": "fmfinanceltd" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
ForteBank	"gateway": "fortebank" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Freedom Finance Bank	"gateway": "axayscom" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
FreedomPay	"gateway": "freedompay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
FreedomPay.Money	"gateway": "payboxmoney" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Freepay	"gateway": "freepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Frontstream	"gateway": "frontstreampayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Fung Payments	"gateway": "fungpayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
GBPayments	"gateway": "gbpayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
geidea	"gateway": "geidea" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
GETTRX	"gateway": "globalelectronictechnology" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Global One Pay	"gateway": "globalonepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 没有开发者文档
全球付款	"gateway": "globalpayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
GMO Payment Gateway	"gateway": "gmopg" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
GoDaddy Payments	"gateway": "godaddypayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Good Idea Technologies	"gateway": "git" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
GoPay	"gateway": "gopay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
GP Webpay	"gateway": "gpwebpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 没有开发者文档
Gr4vy	"gateway": "gr4vy" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Gravity Payments	"gateway": "gravitypayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Halyk Bank	"gateway": "halykbank" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Helcim	"gateway": "helcim" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
HIPS	"gateway": "hips" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
HiTrust	"gateway": "hitrustpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Hyp	"gateway": "hyp" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
icard	"gateway": "icardwallet" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
iKhokha	"gateway": "ikhokha" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
IMOJE	"gateway": "imoje" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Impaya	"gateway": "impayarus" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
InPlat	"gateway": "inplat" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
InstaMed	"gateway": "instamed" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
IntellectMoney	"gateway": "intellectmoney" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Interactive Transaction Solutions	"gateway": "interactivets" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Interswitch Payment Gateway	"gateway": "interswitch" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Intervale	"gateway": "intervale" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
ioka fintech	"gateway": "ioka" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
iPay88	"gateway": "ipay88" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
IPSI	"gateway": "ipsi" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
iQmetrix	"gateway": "iqmetrixpaymentservicesgateway" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
IXOPAY	"gateway": "ixopay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
JetPay	"gateway": "jetpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
JudoPay	"gateway": "judopay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 没有开发者文档
Kassa	"gateway": "kassacom" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
kassa24pay	"gateway": "kassa24pay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Kineox	"gateway": "kineox" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Klix by Citadele	"gateway": "klix" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Lapsa Payments	"gateway": "lapsapayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
LHV Pank	"gateway": "lhvpank" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Liberty	"gateway": "liberty" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Life Pay	"gateway": "lifepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Limepay	"gateway": "limepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Linkly	"gateway": "linkly" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
LiqPay	"gateway": "liqpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Littlepay	"gateway": "littlepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
LogPay	"gateway": "logpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Loyale	"gateway": "loyale" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
lynck	"gateway": "lynck" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Lyra	"gateway": "lyra" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Magnetiq Bank	"gateway": "magnetiq" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
maib	"gateway": "maibecomm" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
MakeCommerce (Maksekeskus)	"gateway": "maksekeskus" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Mandarin	"gateway": "mandarin" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Market Pay	"gateway": "marketpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Mastercard Payment Gateway Services	"gateway": "mpgs" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
MerchantE	"gateway": "merchante" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Merchant Warrior	"gateway": "merchantwarrior" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Minsait Payments Systems	"gateway": "minsaitpaymentsgateway" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
MITEC	"gateway": "mitecmx" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
MIXPLAT	"gateway": "mixplat" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
MOBI.Money	"gateway": "mobimoney" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Modulbank	"gateway": "modulbank" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Molpay	"gateway": "molpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 没有开发者文档
Mondido	"gateway": "mondido" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Monei	"gateway": "monei" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
monek	"gateway": "monek" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Moneris	"gateway": "moneris" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Moneta	"gateway": "moneta" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 没有开发者文档
Monext	"gateway": "monext" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Money.Mail.Ru	"gateway": "moneymailru" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
MPay	"gateway": "managepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
mstartipg	"gateway": "mstartipg" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Multicarta	"gateway": "mulitcarta" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
MultiSafepay	"gateway": "multisafepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Mundipagg	"gateway": "mundipagg" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
MyCheck	"gateway": "mycheck" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
MyChoice2Pay	"gateway": "mychoice2pay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
MyFatoorah	"gateway": "myfatoorah" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
MyPay	"gateway": "mypay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 没有开发者文档
myPOS	"gateway": "mypos" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
N&TS Group	"gateway": "netsgroup" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
NCCC	"gateway": "nccc" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Neon Pay	"gateway": "neonpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Netopia	"gateway": "netopia" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Netvalve	"gateway": "netvalve" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Newebpay（原名 STPath、Pay2Go）	"gateway": "newebpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Newtech	"gateway": "newtechmobile" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Nexi	"gateway": "nexi" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
NMI	"gateway": "gatewayservices" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
noon payments	"gateway": "noonpayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Noqoody Pay	"gateway": "noqoodypay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Novalnet	"gateway": "novalnet" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Nexi Relay	"gateway": "nexirelay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
NTT DATA	"gateway": "nttdatahk" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Nuvei	"gateway": "nuvei" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Oceanpayment	"gateway": "oceanpayment" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Omise	"gateway": "omise" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
One Inc	"gateway": "oneinc" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Onelya	"gateway": "onelya" "gatewayMerchantId": "YOUR_GATWAY_MERCHANT_ID" 开发者文档
Onerway	"gateway": "ronghan" "gatewayMerchantId": "YOUR_GATWAY_MERCHANT_ID" 开发者文档
OneVision Limited	"gateway": "onevision" "gatewayMerchantId": "YOUR_GATWAY_MERCHANT_ID" 开发者文档
OnPay	"gateway": "onpayio" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Opayo by Elavon	"gateway": "opayoelavon" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
OrkestaPay	"gateway": "orkestapay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Oschadbank	"gateway": "oschadbank" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
pagarme	"gateway": "pagarme" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PagBank	"gateway": "pagbank" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PagBrasil	"gateway": "pagbrasil" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PagSeguro	"gateway": "pagsegurointernational" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PAY2M	"gateway": "pay2m" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Payarc	"gateway": "payarc" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Pay.com	"gateway": "paycom" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PAYCOMET	"gateway": "paycomet" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Paydock	"gateway": "paydock" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PayEase	"gateway": "payeasenet" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PayEngine	"gateway": "payengine" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PayFabric	"gateway": "payfabric" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PayFacto	"gateway": "payfacto" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
paygent	"gateway": "paygent" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Payhub	"gateway": "payhub" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PayLane	"gateway": "paylane" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Payler	"gateway": "payler" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PayLink®	"gateway": "paylink" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Payload	"gateway": "payload" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Paymark	"gateway": "paymark" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PayMaster	"gateway": "paymaster" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Payment Fusion	"gateway": "paymentfusion" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Paymentvision	"gateway": "paymentvision" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Paymentwall	"gateway": "paymentwall" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Paymo	"gateway": "paymo" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Paymob	"gateway": "gpaymob" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Paymtech	"gateway": "paymtech" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PayNearMe	"gateway": "paynearme" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Payneteasy	"gateway": "payneteasy" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Pay.nl	"gateway": "paynl" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Paynopain	"gateway": "paynopain" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PayOne	"gateway": "payone" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PayOnline	"gateway": "payonline" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Payoo	"gateway": "payoo" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PayPlus	"gateway": "payplus" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Payrails	"gateway": "payrails" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Payrexx	"gateway": "payrexx" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PayRiff	"gateway": "payriff" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Payrix	"gateway": "payrix" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Paysafe	"gateway": "paysafe" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Payscout	"gateway": "payscout" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Paysend Business	"gateway": "paysend" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Paysoft	"gateway": "paysoft" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Pay360	"gateway": "pay360" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
paytech	"gateway": "paytechsolutions" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PayTech Ukraine	"gateway": "paytech" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Paythru	"gateway": "paythru" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Payture	"gateway": "payture" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PayU	"gateway": "payu" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PayU LATAM	"gateway": "payulatam" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PAYUNi	"gateway": "payuni" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PayU Romania	"gateway": "payuro" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PayU Russia	"gateway": "payuru" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Payway	"gateway": "payway" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Paywiser	"gateway": "paywiser" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Pelecard	"gateway": "pelecard" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Pikassa	"gateway": "pikassa" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PingPong	"gateway": "pingpongx" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Pin Payments	"gateway": "pinpayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
星球	"gateway": "cccpayment" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PlanetPay	"gateway": "itcardpaymentservice" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Plategka.com	"gateway": "plategkacom" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Platon	"gateway": "platon" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Pomelo	"gateway": "pomelopay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Portmone	"gateway": "portmonecom" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Preczn	"gateway": "preczn" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PrimePay	"gateway": "primepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Primer	"gateway": "primer" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Procard	"gateway": "procard" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
ProcessOut	"gateway": "processout" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Przelewy24	"gateway": "przelewy24" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PSB Bank	"gateway": "psbank" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PSCB	"gateway": "pscbru" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
PXP Financial	"gateway": "pxpfinancial" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Qenta Payment CEE	"gateway": "qenta" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
QIWI	"gateway": "qiwi" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Qualpay	"gateway": "qualpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
QuickPay	"gateway": "quickpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Qvalent	"gateway": "qvalent" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Radial	"gateway": "radial" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Rapyd	"gateway": "rapyd" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
RBK.money	"gateway": "rbkmoney" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Rebail Capital	"gateway": "rebailcapital" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Rebilly	"gateway": "Rebilly" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Recurly	"gateway": "recurly" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Reddot	"gateway": "reddotpayment" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Rede	"gateway": "rede" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Redsys	"gateway": "redsys" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Reepay	"gateway": "reepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
RocketGate	"gateway": "rocketgate" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Russian Standard Bank	"gateway": "rsb" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Ryft	"gateway": "ryft" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Saferpay	"gateway": "worldlinesaferpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Safexpay	"gateway": "safexpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Sberbank	"gateway": "sberbank" "gatewayMerchantId": "YOUR_ORGANIZATION_NAME" 开发者文档
SEB Baltic	"gateway": "sebbaltic" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
SEBES Technology	"gateway": "sebes" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Sense Bank	"gateway": "sensebank" "gatewayMerchantId": "YOUR_ORGANIZATION_NAME" 开发者文档
SensePass	"gateway": "sensepass" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Shift4	"gateway": "shift4payments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Shiji Group	"gateway": "shijipaymentsolutions" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
SH Start High	"gateway": "shstartpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
simbasoft	"gateway": "simbasoft" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Sipay	"gateway": "sipay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Softbank Payment Service	"gateway": "sbps" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Solid	"gateway": "solid" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Sony Payment Services	"gateway": "sonypaymentservices" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Splitit	"gateway": "splitit" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Spreedly	"gateway": "spreedly" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Square	"gateway": "square" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
SredaPay	"gateway": "sredapay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Stancer	"gateway": "stancer" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Stripe	"gateway": "stripe" "stripe:version": "2018-10-31" "stripe:publishableKey": "YOUR_PUBLIC_STRIPE_KEY" 开发者文档
Suntech	"gateway": "esafe" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Surfboard Payments	"gateway": "surfboard" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Svea Bank	"gateway": "svea" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Swedbank Baltic	"gateway": "swedbankbaltic" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Swedbank Pay	"gateway": "payexswedbankpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
TabaPay	"gateway": "tabapay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
TapPay (Cherri Tech)	"gateway": "tappay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
TapPayments	"gateway": "tappayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
tarlanpayments	"gateway": "tarlanpayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
TAS Link	"gateway": "taslink" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Tatra banka (CardPay)	"gateway": "tatrabanka" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 没有开发者文档
TEKO	"gateway": "teko" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
theMAP	"gateway": "themap" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Till Payments	"gateway": "tillpayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Tinkoff	"gateway": "tinkoff" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
TPay	"gateway": "tpaycom" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
TPay.com	"gateway": "tpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Transact Campus	"gateway": "transactcampus" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Transaction Services Network	"gateway": "tns" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Transpayrent	"gateway": "transpayrent" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Tranzila	"gateway": "tranzila" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Tranzzo	"gateway": "tranzzo" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Tribe Payments	"gateway": "tribepayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Truevo	"gateway": "truevo" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
TrustPay	"gateway": "trustpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Trust Payments	"gateway": "trustpayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Tuna	"gateway": "tuna" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
2can&ibox	"gateway": "twocan" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
UAPAY	"gateway": "uapay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
UBRR	"gateway": "ubrrpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Ukrcard	"gateway": "ukrcardpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
UkrGasBank Pay	"gateway": "ukrgasbankpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Unibank OJSC	"gateway": "unibankcheckout" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
unitedfinancialcorporation	"gateway": "unitedfinancialcorporation" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Uniteller	"gateway": "uniteller" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Unitpay	"gateway": "unitpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Unlimint	"gateway": "unlimint" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Unzer	"gateway": "unzer" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Unzer Austria	"gateway": "unzeraustria" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
UPC	"gateway": "upc" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Upgate	"gateway": "upgate" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
USAePay	"gateway": "usaepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
UseePay	"gateway": "useepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Valitor	"gateway": "valitor" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Vantiv	"gateway": "vantiv" "vantiv:merchantPayPageId": "YOUR_PAY_PAGE_ID" "vantiv:merchantOrderId": "YOUR_ORDER_ID" "vantiv:merchantTransactionId": "YOUR_TRANSACTION_ID" "vantiv:merchantReportGroup": "*web" 开发者文档
Verestro	"gateway": "verestro" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Very Good Security	"gateway": "verygoodsecurity" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Vindicia	"gateway": "vindicia" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Viva Wallet	"gateway": "vivawallet" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
VTEX	"gateway": "vtex" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Walletdoc	"gateway": "walletdoc" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Walletto	"gateway": "walletto" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
WayForPay	"gateway": "wayforpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
WEAT	"gateway": "weatpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
WhenThen	"gateway": "whenthen" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Windcave	"gateway": "windcave" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Wirebank	"gateway": "wirebank" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Wirecard	"gateway": "wirecard" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
WOOPPAY	"gateway": "wooppay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
WooshPay	"gateway": "swooshtransfer" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Worldline (GlobalCollect)	"gateway": "globalcollect" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Worldline - Ingenico (WL Online Checkout)	"gateway": "worldlineingenicoogone" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Worldline Nordics (Worldline Online Checkout)	"gateway": "worldlineonlinecheckout" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Worldline Sips	"gateway": "wlsips" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Worldnet	"gateway": "worldnet" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Worldpay	"gateway": "worldpay" "gatewayMerchantId": "YOUR_WORLDPAY_MERCHANT_ID" 开发者文档
Wpay	"gateway": "wpayaus" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
WSPay	"gateway": "wspay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
XPATE	"gateway": "xpate" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
xpay	"gateway": "xpaycomua" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
YIĞIM Payment System	"gateway": "yigim" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 没有开发者文档
ЮKassa (YooKassa)	"gateway": "yoomoney" "gatewayMerchantId": "YOUR_SHOP_ID" 开发者文档
Z-credit	"gateway": "zcredit" "gatewayMerchantId": "YOUR_SHOP_ID" 开发者文档
Zalopay	"gateway": "zalopay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
ZEN.com	"gateway": "zen" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Zest	"gateway": "zestpayment" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档
Zuora	"gateway": "zuora" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" 开发者文档

提示：example 是测试环境中有效的网关名称。如果您想试用 API，请不要改动上面的代码示例。使用 example 网关时，您的网站不会接收可用于交易的卡数据，但用户流看起来并无不同。

PAYMENT_GATEWAY 令牌化类型是 Google Pay API 中为商家实现卡付款方式的最常见类型。如果您的付款服务机构不受支持，您也许可以通过 DIRECT 集成来接受 Google Pay。如需了解详情，请参阅直接令牌化文档。

第 3 步：指定支持的支付卡网络

定义您的应用所接受的支付卡网络。

Kotlin

private val allowedCardNetworks = JSONArray(listOf(
        "AMEX",
        "DISCOVER",
        "INTERAC",
        "JCB",
        "MASTERCARD",
        "VISA"))

Java

private static JSONArray getAllowedCardNetworks() {
  return new JSONArray()
      .put("AMEX")
      .put("DISCOVER")
      .put("INTERAC")
      .put("JCB")
      .put("MASTERCARD")
      .put("VISA");
}

Google Pay API 可能返回在 Google.com 上留存的支付卡 (PAN_ONLY) 或在 Android 设备上以 3D 安全密文进行身份验证的设备令牌 (CRYPTOGRAM_3DS)。

Kotlin

private val allowedCardAuthMethods = JSONArray(listOf(
        "PAN_ONLY",
        "CRYPTOGRAM_3DS"))

Java

private static JSONArray getAllowedCardAuthMethods() {
  return new JSONArray()
      .put("PAN_ONLY")
      .put("CRYPTOGRAM_3DS");
}

如需了解详情，请参阅 JSON 对象参考中的 CardParameters。如需 Android 设备令牌支持，请与您的网关或处理方联系，了解所支持的支付卡网络。

重要提示：

• 此外，还要确保针对付款交易的现有风险检查和控制措施同样适用于 Google Pay 交易。Google Pay 验证和欺诈检查的目的并不在于取代您的风险管理流程。
• 如果您支持 PAN_ONLY，请确保为 Google Pay PAN PAN_ONLY 交易触发 3D Secure（分步身份验证）的方式，与为普通卡交易触发 3D Secure 的方式相同。

第 4 步：说明您允许的付款方式

将您支持的身份验证方法和支持的支付卡网络结合起来，以说明您的应用对 CARD 付款方式的支持情况。

Kotlin

    private fun baseCardPaymentMethod(): JSONObject {
        return JSONObject().apply {

            val parameters = JSONObject().apply {
                put("allowedAuthMethods", allowedCardAuthMethods)
                put("allowedCardNetworks", allowedCardNetworks)
                put("billingAddressRequired", true)
                put("billingAddressParameters", JSONObject().apply {
                    put("format", "FULL")
                })
            }

            put("type", "CARD")
            put("parameters", parameters)
        }
    }
PaymentsUtil.kt

Java

  private static JSONObject getBaseCardPaymentMethod() throws JSONException {
    JSONObject cardPaymentMethod = new JSONObject();
    cardPaymentMethod.put("type", "CARD");

    JSONObject parameters = new JSONObject();
    parameters.put("allowedAuthMethods", getAllowedCardAuthMethods());
    parameters.put("allowedCardNetworks", getAllowedCardNetworks());
    // Optionally, you can add billing address/phone number associated with a CARD payment method.
    parameters.put("billingAddressRequired", true);

    JSONObject billingAddressParameters = new JSONObject();
    billingAddressParameters.put("format", "FULL");

    parameters.put("billingAddressParameters", billingAddressParameters);

    cardPaymentMethod.put("parameters", parameters);

    return cardPaymentMethod;
  }
PaymentsUtil.java

扩展基本的卡付款方式对象，以说明预计会返回给您的应用的信息，其中必须包括令牌化的付款数据。

Kotlin

    private fun cardPaymentMethod(): JSONObject {
        val cardPaymentMethod = baseCardPaymentMethod()
        cardPaymentMethod.put("tokenizationSpecification", gatewayTokenizationSpecification())

        return cardPaymentMethod
    }
PaymentsUtil.kt

Java

  private static JSONObject getCardPaymentMethod() throws JSONException {
    JSONObject cardPaymentMethod = getBaseCardPaymentMethod();
    cardPaymentMethod.put("tokenizationSpecification", getGatewayTokenizationSpecification());

    return cardPaymentMethod;
  }
PaymentsUtil.java

如需详细了解所支持的 parameters，请参阅 JSON 对象参考中的 CardParameters。

除了 CARD 之外，Google Pay 还支持 PAYPAL 付款方式。如需详细了解如何将 PayPal 添加为 Google Pay 的付款方式，请参阅 PayPal 开发者文档。

第 5 步：创建 PaymentsClient 实例

在 Activity 中的 onCreate 方法中创建 PaymentsClient 实例。PaymentsClient 用来与 Google Pay API 进行互动。

Kotlin

    fun createPaymentsClient(activity: Activity): PaymentsClient {
        val walletOptions = Wallet.WalletOptions.Builder()
                .setEnvironment(Constants.PAYMENTS_ENVIRONMENT)
                .build()

        return Wallet.getPaymentsClient(activity, walletOptions)
    }
PaymentsUtil.kt

Java

  public static PaymentsClient createPaymentsClient(Activity activity) {
    Wallet.WalletOptions walletOptions =
        new Wallet.WalletOptions.Builder().setEnvironment(Constants.PAYMENTS_ENVIRONMENT).build();
    return Wallet.getPaymentsClient(activity, walletOptions);
  }
PaymentsUtil.java

第 6 步：确定是否能使用 Google Pay API 进行付款

请使用以下代码段将您允许的付款方式添加到您的基本请求对象中：

Kotlin

    fun isReadyToPayRequest(): JSONObject? {
        return try {
            baseRequest.apply {
                put("allowedPaymentMethods", JSONArray().put(baseCardPaymentMethod()))
            }

        } catch (e: JSONException) {
            null
        }
    }
PaymentsUtil.kt

Java

  public static Optional<JSONObject> getIsReadyToPayRequest() {
    try {
      JSONObject isReadyToPayRequest = getBaseRequest();
      isReadyToPayRequest.put(
          "allowedPaymentMethods", new JSONArray().put(getBaseCardPaymentMethod()));

      return Optional.of(isReadyToPayRequest);

    } catch (JSONException e) {
      return Optional.empty();
    }
  }
PaymentsUtil.java

在显示 Google Pay 按钮之前，请调用 isReadyToPay API 以确定用户是否能使用 Google Pay API 进行付款。如需查看配置属性的完整列表，请参阅 IsReadyToPayRequest JSON 对象文档。

Kotlin

    private fun possiblyShowGooglePayButton() {

        val isReadyToPayJson = PaymentsUtil.isReadyToPayRequest() ?: return
        val request = IsReadyToPayRequest.fromJson(isReadyToPayJson.toString()) ?: return

        // The call to isReadyToPay is asynchronous and returns a Task. We need to provide an
        // OnCompleteListener to be triggered when the result of the call is known.
        val task = paymentsClient.isReadyToPay(request)
        task.addOnCompleteListener { completedTask ->
            try {
                completedTask.getResult(ApiException::class.java)?.let(::setGooglePayAvailable)
            } catch (exception: ApiException) {
                // Process error
                Log.w("isReadyToPay failed", exception)
            }
        }
    }
CheckoutActivity.kt

Java

  private void possiblyShowGooglePayButton() {

    final Optional<JSONObject> isReadyToPayJson = PaymentsUtil.getIsReadyToPayRequest();
    if (!isReadyToPayJson.isPresent()) {
      return;
    }

    // The call to isReadyToPay is asynchronous and returns a Task. We need to provide an
    // OnCompleteListener to be triggered when the result of the call is known.
    IsReadyToPayRequest request = IsReadyToPayRequest.fromJson(isReadyToPayJson.get().toString());
    Task<Boolean> task = paymentsClient.isReadyToPay(request);
    task.addOnCompleteListener(this,
        new OnCompleteListener<Boolean>() {
          @Override
          public void onComplete(@NonNull Task<Boolean> task) {
            if (task.isSuccessful()) {
              setGooglePayAvailable(task.getResult());
            } else {
              Log.w("isReadyToPay failed", task.getException());
            }
          }
        });
  }
CheckoutActivity.java

如本例所示，最好仅当您从 isReadyToPay 函数收到成功结果后，再将 Google Pay 显示为付款方式。最常见的做法是，在实现付款方式时，通过布局 include 显示 Google Pay 付款按钮。如需详细了解可在您的应用中使用的 Google Pay 付款按钮、徽标和标识，请参阅品牌推广指南。

第 7 步：创建 PaymentDataRequest 对象

PaymentDataRequest JSON 对象描述了您要通过 Google Pay 付款表格向付款人请求的信息。

请提供与交易价格以及所提供价格的状态相关的信息。有关详情，请参阅 TransactionInfo JSON 对象文档。

以下示例说明了如何获取价格、价格状态和货币交易信息。

重要提示：如需在欧洲经济区 (EEA) 或其他任何遵守增强型客户身份验证 (SCA) 的国家/地区处理交易，商家必须添加 countryCode、totalPrice 和 merchantName 参数才能满足 SCA 要求。

Kotlin

    private fun getTransactionInfo(price: String): JSONObject {
        return JSONObject().apply {
            put("totalPrice", price)
            put("totalPriceStatus", "FINAL")
            put("countryCode", Constants.COUNTRY_CODE)
            put("currencyCode", Constants.CURRENCY_CODE)
        }
    }
PaymentsUtil.kt

Java

  private static JSONObject getTransactionInfo(String price) throws JSONException {
    JSONObject transactionInfo = new JSONObject();
    transactionInfo.put("totalPrice", price);
    transactionInfo.put("totalPriceStatus", "FINAL");
    transactionInfo.put("countryCode", Constants.COUNTRY_CODE);
    transactionInfo.put("currencyCode", Constants.CURRENCY_CODE);
    transactionInfo.put("checkoutOption", "COMPLETE_IMMEDIATE_PURCHASE");

    return transactionInfo;
  }
PaymentsUtil.java

提供用户可见的商家名称。有关详情，请参阅 MerchantInfo JSON 对象文档。

以下示例演示了如何获取商家名称：

Kotlin

private val merchantInfo: JSONObject =
        JSONObject().put("merchantName", "Example Merchant")

Java

  private static JSONObject getMerchantInfo() throws JSONException {
    return new JSONObject().put("merchantName", "Example Merchant");
  }
PaymentsUtil.java

将您的基本请求对象分配给新的 PaymentDataRequest JSON 对象。然后，添加您的应用所支持的付款方式，例如响应中应该会包含的任何其他数据的配置。最后，添加有关交易和提出请求的商家的信息。

以下示例演示了如何请求付款数据：

Kotlin

fun getPaymentDataRequest(price: String): JSONObject? {
    try {
        return baseRequest.apply {
            put("allowedPaymentMethods", JSONArray().put(cardPaymentMethod()))
            put("transactionInfo", getTransactionInfo(price))
            put("merchantInfo", merchantInfo)

            // An optional shipping address requirement is a top-level property of the
            // PaymentDataRequest JSON object.
            val shippingAddressParameters = JSONObject().apply {
                put("phoneNumberRequired", false)
                put("allowedCountryCodes", JSONArray(listOf("US", "GB")))
            }
            put("shippingAddressParameters", shippingAddressParameters)
            put("shippingAddressRequired", true)
        }
    } catch (e: JSONException) {
        return null
    }
}

Java

  public static Optional<JSONObject> getPaymentDataRequest(long priceCents) {

    final String price = PaymentsUtil.centsToString(priceCents);

    try {
      JSONObject paymentDataRequest = PaymentsUtil.getBaseRequest();
      paymentDataRequest.put(
          "allowedPaymentMethods", new JSONArray().put(PaymentsUtil.getCardPaymentMethod()));
      paymentDataRequest.put("transactionInfo", PaymentsUtil.getTransactionInfo(price));
      paymentDataRequest.put("merchantInfo", PaymentsUtil.getMerchantInfo());

      /* An optional shipping address requirement is a top-level property of the PaymentDataRequest
      JSON object. */
      paymentDataRequest.put("shippingAddressRequired", true);

      JSONObject shippingAddressParameters = new JSONObject();
      shippingAddressParameters.put("phoneNumberRequired", false);

      JSONArray allowedCountryCodes = new JSONArray(Constants.SHIPPING_SUPPORTED_COUNTRIES);

      shippingAddressParameters.put("allowedCountryCodes", allowedCountryCodes);
      paymentDataRequest.put("shippingAddressParameters", shippingAddressParameters);
      return Optional.of(paymentDataRequest);

    } catch (JSONException e) {
      return Optional.empty();
    }
  }
PaymentsUtil.java

有关详情，请参阅 PaymentDataRequest JSON 对象文档。

第 8 步：为用户手势注册事件处理程序

如需在用户激活 Google Pay 付款按钮后请求显示 Google Pay 付款表格，请定义 OnClickListener。

Kotlin

        googlePayButton.setOnClickListener { requestPayment() }
CheckoutActivity.kt

Java

    googlePayButton.setOnClickListener(
        new View.OnClickListener() {
          @Override
          public void onClick(View view) {
            requestPayment(view);
          }
        });
CheckoutActivity.java

PaymentDataRequest 对象是代表付款数据请求的 Parcelable。PaymentDataRequest 提供了支持付款所必需的信息。使用 AutoResolveHelper 类则可自动解析 Task，然后在您的 Activity 类的 onActivityResult 方法中处理结果。

第 9 步：处理响应对象

当付款人在 Google Pay 付款表格中成功提供所请求的信息后，系统会将 PaymentData 对象返回给 onActivityResult。

为将付款信息传递给您的处理方，并向用户显示购买确认信息，请将成功的响应转换为 JSON。如果传递给 PaymentDataRequest 的 transactionInfo.totalPriceStatus 是 ESTIMATED，您必须先显示最终价格，然后才能按返回的付款方式扣费。

请从 paymentData 响应中提取付款令牌。如果您实现了网关集成，请将此令牌传递给您的网关，无需进行任何修改。

Kotlin

    public override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        when (requestCode) {
            // Value passed in AutoResolveHelper
            LOAD_PAYMENT_DATA_REQUEST_CODE -> {
                when (resultCode) {
                    RESULT_OK ->
                        data?.let { intent ->
                            PaymentData.getFromIntent(intent)?.let(::handlePaymentSuccess)
                        }

                    RESULT_CANCELED -> {
                        // The user cancelled the payment attempt
                    }

                    AutoResolveHelper.RESULT_ERROR -> {
                        AutoResolveHelper.getStatusFromIntent(data)?.let {
                            handleError(it.statusCode)
                        }
                    }
                }

                // Re-enables the Google Pay payment button.
                googlePayButton.isClickable = true
            }
        }
    }
CheckoutActivity.kt

Java

  public void onActivityResult(int requestCode, int resultCode, Intent data) {
    switch (requestCode) {
      // value passed in AutoResolveHelper
      case LOAD_PAYMENT_DATA_REQUEST_CODE:
        switch (resultCode) {

          case Activity.RESULT_OK:
            PaymentData paymentData = PaymentData.getFromIntent(data);
            handlePaymentSuccess(paymentData);
            break;

          case Activity.RESULT_CANCELED:
            // The user cancelled the payment attempt
            break;

          case AutoResolveHelper.RESULT_ERROR:
            Status status = AutoResolveHelper.getStatusFromIntent(data);
            handleError(status.getStatusCode());
            break;
        }

        // Re-enables the Google Pay payment button.
        googlePayButton.setClickable(true);
    }
  }
CheckoutActivity.java

如需详细了解响应的内容和结构，请参阅 PaymentData JSON 对象参考。

总结

以下代码段显示了一个正确配置的项目的完整示例。如需了解项目级设置步骤，请参阅配置您的项目。

CheckoutActivity.kt (Kotlin)

此示例 Activity 假设您的布局中含有 id 特性为 googlepay_button 的 Google Pay 付款按钮。

/*
 * Copyright 2018 Google Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.google.android.gms.samples.wallet.activity

import android.app.Activity
import android.content.Intent
import android.os.Bundle
import android.text.Html
import android.util.Log
import android.view.View
import android.widget.Toast
import com.google.android.gms.common.api.ApiException
import com.google.android.gms.samples.wallet.util.PaymentsUtil
import com.google.android.gms.samples.wallet.R
import com.google.android.gms.samples.wallet.util.Json
import com.google.android.gms.wallet.*
import kotlinx.android.synthetic.main.activity_checkout.*
import org.json.JSONArray
import org.json.JSONException
import org.json.JSONObject

/**
 * Checkout implementation for the app
 */
class CheckoutActivity : Activity() {

    private val SHIPPING_COST_CENTS = 9 * PaymentsUtil.CENTS.toLong()

    /**
     * A client for interacting with the Google Pay API.
     *
     * @see [PaymentsClient](https://developers.google.com/android/reference/com/google/android/gms/wallet/PaymentsClient)
     */
    private lateinit var paymentsClient: PaymentsClient

    private lateinit var garmentList: JSONArray
    private lateinit var selectedGarment: JSONObject

    /**
     * Arbitrarily-picked constant integer you define to track a request for payment data activity.
     *
     * @value #LOAD_PAYMENT_DATA_REQUEST_CODE
     */
    private val LOAD_PAYMENT_DATA_REQUEST_CODE = 991

    /**
     * Initialize the Google Pay API on creation of the activity
     *
     * @see Activity.onCreate
     */
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_checkout)

        // Set up the mock information for our item in the UI.
        selectedGarment = fetchRandomGarment()
        displayGarment(selectedGarment)

        // Initialize a Google Pay API client for an environment suitable for testing.
        // It's recommended to create the PaymentsClient object inside of the onCreate method.
        paymentsClient = PaymentsUtil.createPaymentsClient(this)
        possiblyShowGooglePayButton()

        googlePayButton.setOnClickListener { requestPayment() }
    }

    /**
     * Determine the viewer's ability to pay with a payment method supported by your app and display a
     * Google Pay payment button.
     *
     * @see [](https://developers.google.com/android/reference/com/google/android/gms/wallet/PaymentsClient.html.isReadyToPay
    ) */
    private fun possiblyShowGooglePayButton() {

        val isReadyToPayJson = PaymentsUtil.isReadyToPayRequest() ?: return
        val request = IsReadyToPayRequest.fromJson(isReadyToPayJson.toString()) ?: return

        // The call to isReadyToPay is asynchronous and returns a Task. We need to provide an
        // OnCompleteListener to be triggered when the result of the call is known.
        val task = paymentsClient.isReadyToPay(request)
        task.addOnCompleteListener { completedTask ->
            try {
                completedTask.getResult(ApiException::class.java)?.let(::setGooglePayAvailable)
            } catch (exception: ApiException) {
                // Process error
                Log.w("isReadyToPay failed", exception)
            }
        }
    }

    /**
     * If isReadyToPay returned `true`, show the button and hide the "checking" text. Otherwise,
     * notify the user that Google Pay is not available. Please adjust to fit in with your current
     * user flow. You are not required to explicitly let the user know if isReadyToPay returns `false`.
     *
     * @param available isReadyToPay API response.
     */
    private fun setGooglePayAvailable(available: Boolean) {
        if (available) {
            googlePayButton.visibility = View.VISIBLE
        } else {
            Toast.makeText(
                    this,
                    "Unfortunately, Google Pay is not available on this device",
                    Toast.LENGTH_LONG).show();
        }
    }

    private fun requestPayment() {

        // Disables the button to prevent multiple clicks.
        googlePayButton.isClickable = false

        // The price provided to the API should include taxes and shipping.
        // This price is not displayed to the user.
        val garmentPrice = selectedGarment.getDouble("price")
        val priceCents = Math.round(garmentPrice * PaymentsUtil.CENTS.toLong()) + SHIPPING_COST_CENTS

        val paymentDataRequestJson = PaymentsUtil.getPaymentDataRequest(priceCents)
        if (paymentDataRequestJson == null) {
            Log.e("RequestPayment", "Can't fetch payment data request")
            return
        }
        val request = PaymentDataRequest.fromJson(paymentDataRequestJson.toString())

        // Since loadPaymentData may show the UI asking the user to select a payment method, we use
        // AutoResolveHelper to wait for the user interacting with it. Once completed,
        // onActivityResult will be called with the result.
        if (request != null) {
            AutoResolveHelper.resolveTask(
                    paymentsClient.loadPaymentData(request), this, LOAD_PAYMENT_DATA_REQUEST_CODE)
        }
    }

    /**
     * Handle a resolved activity from the Google Pay payment sheet.
     *
     * @param requestCode Request code originally supplied to AutoResolveHelper in requestPayment().
     * @param resultCode Result code returned by the Google Pay API.
     * @param data Intent from the Google Pay API containing payment or error data.
     * @see [Getting a result
     * from an Activity](https://developer.android.com/training/basics/intents/result)
     */
    public override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        when (requestCode) {
            // Value passed in AutoResolveHelper
            LOAD_PAYMENT_DATA_REQUEST_CODE -> {
                when (resultCode) {
                    RESULT_OK ->
                        data?.let { intent ->
                            PaymentData.getFromIntent(intent)?.let(::handlePaymentSuccess)
                        }

                    RESULT_CANCELED -> {
                        // The user cancelled the payment attempt
                    }

                    AutoResolveHelper.RESULT_ERROR -> {
                        AutoResolveHelper.getStatusFromIntent(data)?.let {
                            handleError(it.statusCode)
                        }
                    }
                }

                // Re-enables the Google Pay payment button.
                googlePayButton.isClickable = true
            }
        }
    }

    /**
     * PaymentData response object contains the payment information, as well as any additional
     * requested information, such as billing and shipping address.
     *
     * @param paymentData A response object returned by Google after a payer approves payment.
     * @see [Payment
     * Data](https://developers.google.com/pay/api/android/reference/object.PaymentData)
     */
    private fun handlePaymentSuccess(paymentData: PaymentData) {
        val paymentInformation = paymentData.toJson() ?: return

        try {
            // Token will be null if PaymentDataRequest was not constructed using fromJson(String).
            val paymentMethodData = JSONObject(paymentInformation).getJSONObject("paymentMethodData")
            val billingName = paymentMethodData.getJSONObject("info")
                    .getJSONObject("billingAddress").getString("name")
            Log.d("BillingName", billingName)

            Toast.makeText(this, getString(R.string.payments_show_name, billingName), Toast.LENGTH_LONG).show()

            // Logging token string.
            Log.d("GooglePaymentToken", paymentMethodData
                    .getJSONObject("tokenizationData")
                    .getString("token"))

        } catch (e: JSONException) {
            Log.e("handlePaymentSuccess", "Error: " + e.toString())
        }

    }

    /**
     * At this stage, the user has already seen a popup informing them an error occurred. Normally,
     * only logging is required.
     *
     * @param statusCode will hold the value of any constant from CommonStatusCode or one of the
     * WalletConstants.ERROR_CODE_* constants.
     * @see [
     * Wallet Constants Library](https://developers.google.com/android/reference/com/google/android/gms/wallet/WalletConstants.constant-summary)
     */
    private fun handleError(statusCode: Int) {
        Log.w("loadPaymentData failed", String.format("Error code: %d", statusCode))
    }

    private fun fetchRandomGarment() : JSONObject {
        if (!::garmentList.isInitialized) {
            garmentList = Json.readFromResources(this, R.raw.tshirts)
        }

        val randomIndex:Int = Math.round(Math.random() * (garmentList.length() - 1)).toInt()
        return garmentList.getJSONObject(randomIndex)
    }

    private fun displayGarment(garment:JSONObject) {
        detailTitle.setText(garment.getString("title"))
        detailPrice.setText("\$${garment.getString("price")}")

        val escapedHtmlText:String = Html.fromHtml(garment.getString("description")).toString()
        detailDescription.setText(Html.fromHtml(escapedHtmlText))

        val imageUri = "@drawable/${garment.getString("image")}"
        val imageResource = resources.getIdentifier(imageUri, null, packageName)
        detailImage.setImageResource(imageResource)
    }
}
CheckoutActivity.kt
    

PaymentsUtil.kt (Kotlin)

此示例文件可建立适合建立 IsReadyToPayRequest 或 PaymentDataRequest 的 JSON 对象。

/*
 * Copyright 2017 Google Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.google.android.gms.samples.wallet.util

import android.app.Activity
import com.google.android.gms.samples.wallet.Constants
import com.google.android.gms.wallet.PaymentsClient
import com.google.android.gms.wallet.Wallet
import org.json.JSONArray
import org.json.JSONException
import org.json.JSONObject
import java.math.BigDecimal
import java.math.RoundingMode

/**
 * Contains helper static methods for dealing with the Payments API.
 *
 * Many of the parameters used in the code are optional and are set here merely to call out their
 * existence. Please consult the documentation to learn more and feel free to remove ones not
 * relevant to your implementation.
 */
object PaymentsUtil {
    val CENTS = BigDecimal(100)

    /**
     * Create a Google Pay API base request object with properties used in all requests.
     *
     * @return Google Pay API base request object.
     * @throws JSONException
     */
    private val baseRequest = JSONObject().apply {
        put("apiVersion", 2)
        put("apiVersionMinor", 0)
    }

    /**
     * Gateway Integration: Identify your gateway and your app's gateway merchant identifier.
     *
     *
     * The Google Pay API response will return an encrypted payment method capable of being charged
     * by a supported gateway after payer authorization.
     *
     *
     * TODO: Check with your gateway on the parameters to pass and modify them in Constants.java.
     *
     * @return Payment data tokenization for the CARD payment method.
     * @throws JSONException
     * @see [PaymentMethodTokenizationSpecification](https://developers.google.com/pay/api/android/reference/object.PaymentMethodTokenizationSpecification)
     */
    private fun gatewayTokenizationSpecification(): JSONObject {
        return JSONObject().apply {
            put("type", "PAYMENT_GATEWAY")
            put("parameters", JSONObject(Constants.PAYMENT_GATEWAY_TOKENIZATION_PARAMETERS))
        }
    }

    /**
     * `DIRECT` Integration: Decrypt a response directly on your servers. This configuration has
     * additional data security requirements from Google and additional PCI DSS compliance complexity.
     *
     *
     * Please refer to the documentation for more information about `DIRECT` integration. The
     * type of integration you use depends on your payment processor.
     *
     * @return Payment data tokenization for the CARD payment method.
     * @throws JSONException
     * @see [PaymentMethodTokenizationSpecification](https://developers.google.com/pay/api/android/reference/object.PaymentMethodTokenizationSpecification)
     */
    private fun directTokenizationSpecification(): JSONObject {
        if (Constants.DIRECT_TOKENIZATION_PUBLIC_KEY == "REPLACE_ME" ||
                (Constants.DIRECT_TOKENIZATION_PARAMETERS.isEmpty() ||
                 Constants.DIRECT_TOKENIZATION_PUBLIC_KEY.isEmpty())) {

            throw RuntimeException(
                    "Please edit the Constants.java file to add protocol version & public key.")
        }

        return JSONObject().apply {
            put("type", "DIRECT")
            put("parameters", JSONObject(Constants.DIRECT_TOKENIZATION_PARAMETERS))
        }
    }

    /**
     * Card networks supported by your app and your gateway.
     *
     *
     * TODO: Confirm card networks supported by your app and gateway & update in Constants.java.
     *
     * @return Allowed card networks
     * @see [CardParameters](https://developers.google.com/pay/api/android/reference/object.CardParameters)
     */
    private val allowedCardNetworks = JSONArray(Constants.SUPPORTED_NETWORKS)

    /**
     * Card authentication methods supported by your app and your gateway.
     *
     *
     * TODO: Confirm your processor supports Android device tokens on your supported card networks
     * and make updates in Constants.java.
     *
     * @return Allowed card authentication methods.
     * @see [CardParameters](https://developers.google.com/pay/api/android/reference/object.CardParameters)
     */
    private val allowedCardAuthMethods = JSONArray(Constants.SUPPORTED_METHODS)

    /**
     * Describe your app's support for the CARD payment method.
     *
     *
     * The provided properties are applicable to both an IsReadyToPayRequest and a
     * PaymentDataRequest.
     *
     * @return A CARD PaymentMethod object describing accepted cards.
     * @throws JSONException
     * @see [PaymentMethod](https://developers.google.com/pay/api/android/reference/object.PaymentMethod)
     */
    // Optionally, you can add billing address/phone number associated with a CARD payment method.
    private fun baseCardPaymentMethod(): JSONObject {
        return JSONObject().apply {

            val parameters = JSONObject().apply {
                put("allowedAuthMethods", allowedCardAuthMethods)
                put("allowedCardNetworks", allowedCardNetworks)
                put("billingAddressRequired", true)
                put("billingAddressParameters", JSONObject().apply {
                    put("format", "FULL")
                })
            }

            put("type", "CARD")
            put("parameters", parameters)
        }
    }

    /**
     * Describe the expected returned payment data for the CARD payment method
     *
     * @return A CARD PaymentMethod describing accepted cards and optional fields.
     * @throws JSONException
     * @see [PaymentMethod](https://developers.google.com/pay/api/android/reference/object.PaymentMethod)
     */
    private fun cardPaymentMethod(): JSONObject {
        val cardPaymentMethod = baseCardPaymentMethod()
        cardPaymentMethod.put("tokenizationSpecification", gatewayTokenizationSpecification())

        return cardPaymentMethod
    }

    /**
     * An object describing accepted forms of payment by your app, used to determine a viewer's
     * readiness to pay.
     *
     * @return API version and payment methods supported by the app.
     * @see [IsReadyToPayRequest](https://developers.google.com/pay/api/android/reference/object.IsReadyToPayRequest)
     */
    fun isReadyToPayRequest(): JSONObject? {
        return try {
            baseRequest.apply {
                put("allowedPaymentMethods", JSONArray().put(baseCardPaymentMethod()))
            }

        } catch (e: JSONException) {
            null
        }
    }

    /**
     * Information about the merchant requesting payment information
     *
     * @return Information about the merchant.
     * @throws JSONException
     * @see [MerchantInfo](https://developers.google.com/pay/api/android/reference/object.MerchantInfo)
     */
    private val merchantInfo: JSONObject =
            JSONObject().put("merchantName", "Example Merchant")

    /**
     * Creates an instance of [PaymentsClient] for use in an [Activity] using the
     * environment and theme set in [Constants].
     *
     * @param activity is the caller's activity.
     */
    fun createPaymentsClient(activity: Activity): PaymentsClient {
        val walletOptions = Wallet.WalletOptions.Builder()
                .setEnvironment(Constants.PAYMENTS_ENVIRONMENT)
                .build()

        return Wallet.getPaymentsClient(activity, walletOptions)
    }

    /**
     * Provide Google Pay API with a payment amount, currency, and amount status.
     *
     * @return information about the requested payment.
     * @throws JSONException
     * @see [TransactionInfo](https://developers.google.com/pay/api/android/reference/object.TransactionInfo)
     */
    @Throws(JSONException::class)
    private fun getTransactionInfo(price: String): JSONObject {
        return JSONObject().apply {
            put("totalPrice", price)
            put("totalPriceStatus", "FINAL")
            put("countryCode", Constants.COUNTRY_CODE)
            put("currencyCode", Constants.CURRENCY_CODE)
        }
    }

    /**
     * An object describing information requested in a Google Pay payment sheet
     *
     * @return Payment data expected by your app.
     * @see [PaymentDataRequest](https://developers.google.com/pay/api/android/reference/object.PaymentDataRequest)
     */
    fun getPaymentDataRequest(priceCemts: Long): JSONObject? {
        return try {
            baseRequest.apply {
                put("allowedPaymentMethods", JSONArray().put(cardPaymentMethod()))
                put("transactionInfo", getTransactionInfo(priceCemts.centsToString()))
                put("merchantInfo", merchantInfo)

                // An optional shipping address requirement is a top-level property of the
                // PaymentDataRequest JSON object.
                val shippingAddressParameters = JSONObject().apply {
                    put("phoneNumberRequired", false)
                    put("allowedCountryCodes", JSONArray(listOf("US", "GB")))
                }
                put("shippingAddressParameters", shippingAddressParameters)
                put("shippingAddressRequired", true)
            }
        } catch (e: JSONException) {
            null
        }
    }
}

/**
 * Converts cents to a string format accepted by [PaymentsUtil.getPaymentDataRequest].
 *
 * @param cents value of the price.
 */
fun Long.centsToString() = BigDecimal(this)
        .divide(PaymentsUtil.CENTS)
        .setScale(2, RoundingMode.HALF_EVEN)
        .toString()
PaymentsUtil.kt
    

CheckoutActivity.java (Java)

此示例 Activity 假设您的布局中含有 id 特性为 googlepay_button 的 Google Pay 付款按钮。

/*
 * Copyright 2020 Google Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.google.android.gms.samples.wallet.activity;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.text.Html;
import android.util.Log;
import android.view.View;
import android.widget.Toast;

import com.google.android.gms.common.api.Status;
import com.google.android.gms.samples.wallet.databinding.ActivityCheckoutBinding;
import com.google.android.gms.samples.wallet.util.PaymentsUtil;
import com.google.android.gms.samples.wallet.R;
import com.google.android.gms.samples.wallet.util.Json;
import com.google.android.gms.tasks.OnCompleteListener;
import com.google.android.gms.tasks.Task;
import com.google.android.gms.wallet.AutoResolveHelper;
import com.google.android.gms.wallet.IsReadyToPayRequest;
import com.google.android.gms.wallet.PaymentData;
import com.google.android.gms.wallet.PaymentDataRequest;
import com.google.android.gms.wallet.PaymentsClient;

import java.util.Locale;
import java.util.Optional;

import org.json.JSONArray;
import org.json.JSONException;
import org.json.JSONObject;

import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;

/**
 * Checkout implementation for the app
 */
public class CheckoutActivity extends AppCompatActivity {

  // Arbitrarily-picked constant integer you define to track a request for payment data activity.
  private static final int LOAD_PAYMENT_DATA_REQUEST_CODE = 991;

  private static final long SHIPPING_COST_CENTS = 90 * PaymentsUtil.CENTS_IN_A_UNIT.longValue();

  // A client for interacting with the Google Pay API.
  private PaymentsClient paymentsClient;

  private ActivityCheckoutBinding layoutBinding;
  private View googlePayButton;

  private JSONArray garmentList;
  private JSONObject selectedGarment;

  /**
   * Initialize the Google Pay API on creation of the activity
   *
   * @see Activity#onCreate(android.os.Bundle)
   */
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    initializeUi();

    // Set up the mock information for our item in the UI.
    try {
      selectedGarment = fetchRandomGarment();
      displayGarment(selectedGarment);
    } catch (JSONException e) {
      throw new RuntimeException("The list of garments cannot be loaded");
    }

    // Initialize a Google Pay API client for an environment suitable for testing.
    // It's recommended to create the PaymentsClient object inside of the onCreate method.
    paymentsClient = PaymentsUtil.createPaymentsClient(this);
    possiblyShowGooglePayButton();
  }

  /**
   * Handle a resolved activity from the Google Pay payment sheet.
   *
   * @param requestCode Request code originally supplied to AutoResolveHelper in requestPayment().
   * @param resultCode  Result code returned by the Google Pay API.
   * @param data        Intent from the Google Pay API containing payment or error data.
   * @see <a href="https://developer.android.com/training/basics/intents/result">Getting a result
   * from an Activity</a>
   */
  @Override
  public void onActivityResult(int requestCode, int resultCode, Intent data) {
    switch (requestCode) {
      // value passed in AutoResolveHelper
      case LOAD_PAYMENT_DATA_REQUEST_CODE:
        switch (resultCode) {

          case Activity.RESULT_OK:
            PaymentData paymentData = PaymentData.getFromIntent(data);
            handlePaymentSuccess(paymentData);
            break;

          case Activity.RESULT_CANCELED:
            // The user cancelled the payment attempt
            break;

          case AutoResolveHelper.RESULT_ERROR:
            Status status = AutoResolveHelper.getStatusFromIntent(data);
            handleError(status.getStatusCode());
            break;
        }

        // Re-enables the Google Pay payment button.
        googlePayButton.setClickable(true);
    }
  }

  private void initializeUi() {

    // Use view binding to access the UI elements
    layoutBinding = ActivityCheckoutBinding.inflate(getLayoutInflater());
    setContentView(layoutBinding.getRoot());

    // The Google Pay button is a layout file – take the root view
    googlePayButton = layoutBinding.googlePayButton.getRoot();
    googlePayButton.setOnClickListener(
        new View.OnClickListener() {
          @Override
          public void onClick(View view) {
            requestPayment(view);
          }
        });
  }

  private void displayGarment(JSONObject garment) throws JSONException {
    layoutBinding.detailTitle.setText(garment.getString("title"));
    layoutBinding.detailPrice.setText(
        String.format(Locale.getDefault(), "$%.2f", garment.getDouble("price")));

    final String escapedHtmlText = Html.fromHtml(
        garment.getString("description"), Html.FROM_HTML_MODE_COMPACT).toString();
    layoutBinding.detailDescription.setText(Html.fromHtml(
        escapedHtmlText, Html.FROM_HTML_MODE_COMPACT));

    final String imageUri = String.format("@drawable/%s", garment.getString("image"));
    final int imageResource = getResources().getIdentifier(imageUri, null, getPackageName());
    layoutBinding.detailImage.setImageResource(imageResource);
  }

  /**
   * Determine the viewer's ability to pay with a payment method supported by your app and display a
   * Google Pay payment button.
   *
   * @see <a href="https://developers.google.com/android/reference/com/google/android/gms/wallet/
   * PaymentsClient.html#isReadyToPay(com.google.android.gms.wallet.
   * IsReadyToPayRequest)">PaymentsClient#IsReadyToPay</a>
   */
  private void possiblyShowGooglePayButton() {

    final Optional<JSONObject> isReadyToPayJson = PaymentsUtil.getIsReadyToPayRequest();
    if (!isReadyToPayJson.isPresent()) {
      return;
    }

    // The call to isReadyToPay is asynchronous and returns a Task. We need to provide an
    // OnCompleteListener to be triggered when the result of the call is known.
    IsReadyToPayRequest request = IsReadyToPayRequest.fromJson(isReadyToPayJson.get().toString());
    Task<Boolean> task = paymentsClient.isReadyToPay(request);
    task.addOnCompleteListener(this,
        new OnCompleteListener<Boolean>() {
          @Override
          public void onComplete(@NonNull Task<Boolean> task) {
            if (task.isSuccessful()) {
              setGooglePayAvailable(task.getResult());
            } else {
              Log.w("isReadyToPay failed", task.getException());
            }
          }
        });
  }

  /**
   * If isReadyToPay returned {@code true}, show the button and hide the "checking" text. Otherwise,
   * notify the user that Google Pay is not available. Please adjust to fit in with your current
   * user flow. You are not required to explicitly let the user know if isReadyToPay returns {@code
   * false}.
   *
   * @param available isReadyToPay API response.
   */
  private void setGooglePayAvailable(boolean available) {
    if (available) {
      googlePayButton.setVisibility(View.VISIBLE);
    } else {
      Toast.makeText(this, R.string.googlepay_status_unavailable, Toast.LENGTH_LONG).show();
    }
  }

  /**
   * PaymentData response object contains the payment information, as well as any additional
   * requested information, such as billing and shipping address.
   *
   * @param paymentData A response object returned by Google after a payer approves payment.
   * @see <a href="https://developers.google.com/pay/api/android/reference/
   * object#PaymentData">PaymentData</a>
   */
  private void handlePaymentSuccess(PaymentData paymentData) {

    // Token will be null if PaymentDataRequest was not constructed using fromJson(String).
    final String paymentInfo = paymentData.toJson();
    if (paymentInfo == null) {
      return;
    }

    try {
      JSONObject paymentMethodData = new JSONObject(paymentInfo).getJSONObject("paymentMethodData");
      // If the gateway is set to "example", no payment information is returned - instead, the
      // token will only consist of "examplePaymentMethodToken".

      final JSONObject tokenizationData = paymentMethodData.getJSONObject("tokenizationData");
      final String token = tokenizationData.getString("token");
      final JSONObject info = paymentMethodData.getJSONObject("info");
      final String billingName = info.getJSONObject("billingAddress").getString("name");
      Toast.makeText(
          this, getString(R.string.payments_show_name, billingName),
          Toast.LENGTH_LONG).show();

      // Logging token string.
      Log.d("Google Pay token: ", token);

    } catch (JSONException e) {
      throw new RuntimeException("The selected garment cannot be parsed from the list of elements");
    }
  }

  /**
   * At this stage, the user has already seen a popup informing them an error occurred. Normally,
   * only logging is required.
   *
   * @param statusCode will hold the value of any constant from CommonStatusCode or one of the
   *                   WalletConstants.ERROR_CODE_* constants.
   * @see <a href="https://developers.google.com/android/reference/com/google/android/gms/wallet/
   * WalletConstants#constant-summary">Wallet Constants Library</a>
   */
  private void handleError(int statusCode) {
    Log.e("loadPaymentData failed", String.format("Error code: %d", statusCode));
  }

  public void requestPayment(View view) {

    // Disables the button to prevent multiple clicks.
    googlePayButton.setClickable(false);

    // The price provided to the API should include taxes and shipping.
    // This price is not displayed to the user.
    try {
      double garmentPrice = selectedGarment.getDouble("price");
      long garmentPriceCents = Math.round(garmentPrice * PaymentsUtil.CENTS_IN_A_UNIT.longValue());
      long priceCents = garmentPriceCents + SHIPPING_COST_CENTS;

      Optional<JSONObject> paymentDataRequestJson = PaymentsUtil.getPaymentDataRequest(priceCents);
      if (!paymentDataRequestJson.isPresent()) {
        return;
      }

      PaymentDataRequest request =
          PaymentDataRequest.fromJson(paymentDataRequestJson.get().toString());

      // Since loadPaymentData may show the UI asking the user to select a payment method, we use
      // AutoResolveHelper to wait for the user interacting with it. Once completed,
      // onActivityResult will be called with the result.
      if (request != null) {
        AutoResolveHelper.resolveTask(
            paymentsClient.loadPaymentData(request),
            this, LOAD_PAYMENT_DATA_REQUEST_CODE);
      }

    } catch (JSONException e) {
      throw new RuntimeException("The price cannot be deserialized from the JSON object.");
    }
  }

  private JSONObject fetchRandomGarment() {

    // Only load the list of items if it has not been loaded before
    if (garmentList == null) {
      garmentList = Json.readFromResources(this, R.raw.tshirts);
    }

    // Take a random element from the list
    int randomIndex = Math.toIntExact(Math.round(Math.random() * (garmentList.length() - 1)));
    try {
      return garmentList.getJSONObject(randomIndex);
    } catch (JSONException e) {
      throw new RuntimeException("The index specified is out of bounds.");
    }
  }
}
CheckoutActivity.java

PaymentsUtil.java (Java)

此示例文件可建立适合建立 IsReadyToPayRequest 或 PaymentDataRequest 的 JSON 对象。

/*
 * Copyright 2020 Google Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.google.android.gms.samples.wallet.util;

import android.app.Activity;

import com.google.android.gms.samples.wallet.Constants;
import com.google.android.gms.wallet.PaymentsClient;
import com.google.android.gms.wallet.Wallet;

import java.math.BigDecimal;
import java.math.RoundingMode;
import java.util.Optional;

import org.json.JSONArray;
import org.json.JSONException;
import org.json.JSONObject;

/**
 * Contains helper static methods for dealing with the Payments API.
 *
 * <p>Many of the parameters used in the code are optional and are set here merely to call out their
 * existence. Please consult the documentation to learn more and feel free to remove ones not
 * relevant to your implementation.
 */
public class PaymentsUtil {

  public static final BigDecimal CENTS_IN_A_UNIT = new BigDecimal(100d);

  /**
   * Create a Google Pay API base request object with properties used in all requests.
   *
   * @return Google Pay API base request object.
   * @throws JSONException
   */
  private static JSONObject getBaseRequest() throws JSONException {
    return new JSONObject().put("apiVersion", 2).put("apiVersionMinor", 0);
  }

  /**
   * Creates an instance of {@link PaymentsClient} for use in an {@link Activity} using the
   * environment and theme set in {@link Constants}.
   *
   * @param activity is the caller's activity.
   */
  public static PaymentsClient createPaymentsClient(Activity activity) {
    Wallet.WalletOptions walletOptions =
        new Wallet.WalletOptions.Builder().setEnvironment(Constants.PAYMENTS_ENVIRONMENT).build();
    return Wallet.getPaymentsClient(activity, walletOptions);
  }

  /**
   * Gateway Integration: Identify your gateway and your app's gateway merchant identifier.
   *
   * <p>The Google Pay API response will return an encrypted payment method capable of being charged
   * by a supported gateway after payer authorization.
   *
   * <p>TODO: Check with your gateway on the parameters to pass and modify them in Constants.java.
   *
   * @return Payment data tokenization for the CARD payment method.
   * @throws JSONException
   * @see <a href=
   * "https://developers.google.com/pay/api/android/reference/object#PaymentMethodTokenizationSpecification">PaymentMethodTokenizationSpecification</a>
   */
  private static JSONObject getGatewayTokenizationSpecification() throws JSONException {
    return new JSONObject() {{
      put("type", "PAYMENT_GATEWAY");
      put("parameters", new JSONObject() {{
        put("gateway", "example");
        put("gatewayMerchantId", "exampleGatewayMerchantId");
      }});
    }};
  }

  /**
   * {@code DIRECT} Integration: Decrypt a response directly on your servers. This configuration has
   * additional data security requirements from Google and additional PCI DSS compliance complexity.
   *
   * <p>Please refer to the documentation for more information about {@code DIRECT} integration. The
   * type of integration you use depends on your payment processor.
   *
   * @return Payment data tokenization for the CARD payment method.
   * @throws JSONException
   * @see <a
   * href="https://developers.google.com/pay/api/android/reference/object#PaymentMethodTokenizationSpecification">PaymentMethodTokenizationSpecification</a>
   */
  private static JSONObject getDirectTokenizationSpecification()
      throws JSONException, RuntimeException {
    if (Constants.DIRECT_TOKENIZATION_PARAMETERS.isEmpty()
        || Constants.DIRECT_TOKENIZATION_PUBLIC_KEY.isEmpty()
        || Constants.DIRECT_TOKENIZATION_PUBLIC_KEY == null
        || Constants.DIRECT_TOKENIZATION_PUBLIC_KEY == "REPLACE_ME") {
      throw new RuntimeException(
          "Please edit the Constants.java file to add protocol version & public key.");
    }
    JSONObject tokenizationSpecification = new JSONObject();

    tokenizationSpecification.put("type", "DIRECT");
    JSONObject parameters = new JSONObject(Constants.DIRECT_TOKENIZATION_PARAMETERS);
    tokenizationSpecification.put("parameters", parameters);

    return tokenizationSpecification;
  }

  /**
   * Card networks supported by your app and your gateway.
   *
   * <p>TODO: Confirm card networks supported by your app and gateway & update in Constants.java.
   *
   * @return Allowed card networks
   * @see <a
   * href="https://developers.google.com/pay/api/android/reference/object#CardParameters">CardParameters</a>
   */
  private static JSONArray getAllowedCardNetworks() {
    return new JSONArray(Constants.SUPPORTED_NETWORKS);
  }

  /**
   * Card authentication methods supported by your app and your gateway.
   *
   * <p>TODO: Confirm your processor supports Android device tokens on your supported card networks
   * and make updates in Constants.java.
   *
   * @return Allowed card authentication methods.
   * @see <a
   * href="https://developers.google.com/pay/api/android/reference/object#CardParameters">CardParameters</a>
   */
  private static JSONArray getAllowedCardAuthMethods() {
    return new JSONArray(Constants.SUPPORTED_METHODS);
  }

  /**
   * Describe your app's support for the CARD payment method.
   *
   * <p>The provided properties are applicable to both an IsReadyToPayRequest and a
   * PaymentDataRequest.
   *
   * @return A CARD PaymentMethod object describing accepted cards.
   * @throws JSONException
   * @see <a
   * href="https://developers.google.com/pay/api/android/reference/object#PaymentMethod">PaymentMethod</a>
   */
  private static JSONObject getBaseCardPaymentMethod() throws JSONException {
    JSONObject cardPaymentMethod = new JSONObject();
    cardPaymentMethod.put("type", "CARD");

    JSONObject parameters = new JSONObject();
    parameters.put("allowedAuthMethods", getAllowedCardAuthMethods());
    parameters.put("allowedCardNetworks", getAllowedCardNetworks());
    // Optionally, you can add billing address/phone number associated with a CARD payment method.
    parameters.put("billingAddressRequired", true);

    JSONObject billingAddressParameters = new JSONObject();
    billingAddressParameters.put("format", "FULL");

    parameters.put("billingAddressParameters", billingAddressParameters);

    cardPaymentMethod.put("parameters", parameters);

    return cardPaymentMethod;
  }

  /**
   * Describe the expected returned payment data for the CARD payment method
   *
   * @return A CARD PaymentMethod describing accepted cards and optional fields.
   * @throws JSONException
   * @see <a
   * href="https://developers.google.com/pay/api/android/reference/object#PaymentMethod">PaymentMethod</a>
   */
  private static JSONObject getCardPaymentMethod() throws JSONException {
    JSONObject cardPaymentMethod = getBaseCardPaymentMethod();
    cardPaymentMethod.put("tokenizationSpecification", getGatewayTokenizationSpecification());

    return cardPaymentMethod;
  }

  /**
   * An object describing accepted forms of payment by your app, used to determine a viewer's
   * readiness to pay.
   *
   * @return API version and payment methods supported by the app.
   * @see <a
   * href="https://developers.google.com/pay/api/android/reference/object#IsReadyToPayRequest">IsReadyToPayRequest</a>
   */
  public static Optional<JSONObject> getIsReadyToPayRequest() {
    try {
      JSONObject isReadyToPayRequest = getBaseRequest();
      isReadyToPayRequest.put(
          "allowedPaymentMethods", new JSONArray().put(getBaseCardPaymentMethod()));

      return Optional.of(isReadyToPayRequest);

    } catch (JSONException e) {
      return Optional.empty();
    }
  }

  /**
   * Provide Google Pay API with a payment amount, currency, and amount status.
   *
   * @return information about the requested payment.
   * @throws JSONException
   * @see <a
   * href="https://developers.google.com/pay/api/android/reference/object#TransactionInfo">TransactionInfo</a>
   */
  private static JSONObject getTransactionInfo(String price) throws JSONException {
    JSONObject transactionInfo = new JSONObject();
    transactionInfo.put("totalPrice", price);
    transactionInfo.put("totalPriceStatus", "FINAL");
    transactionInfo.put("countryCode", Constants.COUNTRY_CODE);
    transactionInfo.put("currencyCode", Constants.CURRENCY_CODE);
    transactionInfo.put("checkoutOption", "COMPLETE_IMMEDIATE_PURCHASE");

    return transactionInfo;
  }

  /**
   * Information about the merchant requesting payment information
   *
   * @return Information about the merchant.
   * @throws JSONException
   * @see <a
   * href="https://developers.google.com/pay/api/android/reference/object#MerchantInfo">MerchantInfo</a>
   */
  private static JSONObject getMerchantInfo() throws JSONException {
    return new JSONObject().put("merchantName", "Example Merchant");
  }

  /**
   * An object describing information requested in a Google Pay payment sheet
   *
   * @return Payment data expected by your app.
   * @see <a
   * href="https://developers.google.com/pay/api/android/reference/object#PaymentDataRequest">PaymentDataRequest</a>
   */
  public static Optional<JSONObject> getPaymentDataRequest(long priceCents) {

    final String price = PaymentsUtil.centsToString(priceCents);

    try {
      JSONObject paymentDataRequest = PaymentsUtil.getBaseRequest();
      paymentDataRequest.put(
          "allowedPaymentMethods", new JSONArray().put(PaymentsUtil.getCardPaymentMethod()));
      paymentDataRequest.put("transactionInfo", PaymentsUtil.getTransactionInfo(price));
      paymentDataRequest.put("merchantInfo", PaymentsUtil.getMerchantInfo());

      /* An optional shipping address requirement is a top-level property of the PaymentDataRequest
      JSON object. */
      paymentDataRequest.put("shippingAddressRequired", true);

      JSONObject shippingAddressParameters = new JSONObject();
      shippingAddressParameters.put("phoneNumberRequired", false);

      JSONArray allowedCountryCodes = new JSONArray(Constants.SHIPPING_SUPPORTED_COUNTRIES);

      shippingAddressParameters.put("allowedCountryCodes", allowedCountryCodes);
      paymentDataRequest.put("shippingAddressParameters", shippingAddressParameters);
      return Optional.of(paymentDataRequest);

    } catch (JSONException e) {
      return Optional.empty();
    }
  }

  /**
   * Converts cents to a string format accepted by {@link PaymentsUtil#getPaymentDataRequest}.
   *
   * @param cents value of the price in cents.
   */
  public static String centsToString(long cents) {
    return new BigDecimal(cents)
        .divide(CENTS_IN_A_UNIT, RoundingMode.HALF_EVEN)
        .setScale(2, RoundingMode.HALF_EVEN)
        .toString();
  }
}
PaymentsUtil.java
      

目标：要验证您的集成并申请正式版访问权限，请继续完成我们的集成核对清单。