Как и зачем интегрировать платежный сервис Google Pay в Android-приложение для коммерции

Автор: Андрей
Google Pay для Android-приложения

Важное условие успеха в электронной коммерции — правильный выбор способа оплаты, предлагаемый клиенту. Если говорить о мобильных приложениях, то, по статистике, на этапе оплаты покупки вы можете терять до 80% клиентов лишь потому, что способ оплаты неудобен и не вызывает доверия. Чего стоят одни попытки правильно ввести свои данные при помощи тачскрин — не говоря уже о необходимости совершить множество переходов и страхе утечки данных. Удобным для всех решением в этой ситуации является интеграция в приложение сервиса Google Pay.

Бизнес-преимущества Google Pay

Google Pay (известный ранее как Android Pay) позволяет оплачивать покупки в мобильном приложении всего в два действия. Пользователь, зарегистрированный в Google, на этапе оплаты нажимает на кнопку "оплатить через Google", выбирает одну из своих платежных карт и нажимает кнопку подтверждения. А привязав к аккаунту способ доставки, он еще и избавляется от необходимости каждый раз вводить одни и те же контактные данные.

Не удивительно, что такой простой способ оплаты очень популярен среди пользователей: на сентябрь 2018 г. приложение Google Pay было скачано 100 млн. раз. Насколько это выгодно для бизнеса? AirBnB после интеграции сервиса отметила, что рост объема онлайн-платежей увеличился в 11 раз. Google не взимает за пользование сервисом оплату, так что все, что вы получаете от интеграции — это рост конверсий и прибыли.

Google Pay доступен для всех поставщиков товаров и услуг в странах, где поддерживается сервис. Это прекрасный способ связать при помощи единого интерфейса пользователя приложения с несколькими десятками платежных систем по всему миру. Его легко интегрировать в Android приложения. Как именно — читайте дальше.

Подключение Google Pay

Первое, что нам необходимо сделать, это подключить библиотеку. В gradle файле проекта необходимо добавить зависимость: implementation 'com.google.android.gms:play-services-wallet:$play_service_wallet_version' где $play_service_wallet_version — это версия библиотеки, которую мы будем использовать. Сейчас актуальная версия — 16.0.0. Более детальную инструкцию, как подключить библиотеку, и информацию, какие библиотеки Google Play Services вообще есть, можно посмотреть тут.

Предположим, что товар или услуга уже сформирована и готова перейти в вашу собственность. Нам осталось только настроить процесс совершения самой покупки. Для этого инициализируем платежный клиент:

private lateinit var mPaymentsClient: PaymentsClient
 
mPaymentsClient = GooglePayUtil.createPaymentsClient(this)
 
fun createPaymentsClient(activity: Activity): PaymentsClient {
   val walletOptions = Wallet.WalletOptions.Builder()
       .setEnvironment(PAYMENTS_ENVIRONMENT)
       .build()
   return Wallet.getPaymentsClient(activity, walletOptions)
}

В качестве PAYMENTS_ENVIRONMENT мы укажем тип окружения WalletConstants.ENVIRONMENT_TEST.

Далее предлагаю сперва проверить возможность осуществления покупки с помощью Google Pay: 

GooglePayUtil.isReadyToPay(mPaymentsClient).addOnCompleteListener { task ->
   try {
       setGooglePayButtonAvailable(task.getResult(ApiException::class.java))
   } catch (exception: ApiException) {
       mGooglePayStatusText.text = "Payment status: Error init"
       Log.d("isReadyToPay failed", exception.statusCode.toString())
   }
}
 
 
fun isReadyToPay(client: PaymentsClient): Task<Boolean> {
   val request = IsReadyToPayRequest.newBuilder()
   for (allowedMethod in SUPPORTED_METHODS) {
       request.addAllowedPaymentMethod(allowedMethod)
   }
   return client.isReadyToPay(request.build())
}

В зависимости от результата, нам необходимо показать либо же оставить спрятанной кнопку:

private fun setGooglePayButtonAvailable(available: Boolean) {
   if (available) {
       mGooglePayStatusText.text = "Payment status: Supported"
       mGooglePayButton.visibility = View.VISIBLE
   } else {
       mGooglePayStatusText.text = "Payment status: Not supported"
   }
}

Методы оплаты определены заранее:

private val SUPPORTED_METHODS = Arrays.asList(
   WalletConstants.PAYMENT_METHOD_CARD,
   WalletConstants.PAYMENT_METHOD_TOKENIZED_CARD
)

Продолжаем интеграцию оплаты Google Pay в Android приложение

Все подготовительные этапы, касающиеся использования наших платежных систем, пройдены, и мы подошли к наиболее сложному этапу — совершение оплаты: 

mGooglePayButton.setOnClickListener{
   requestPayment()
}

Важный момент: большинство платежных систем используют минимально возможное значение номинала валюты. Следовательно, в том случае, если это копейка, то, указывая в качестве суммы к списанию число 17852, мы подтверждаем, что мы хотим списать 178 целых и 52 сотых единиц.

Тип валюты: 

private fun requestPayment() {
   mGooglePayButton.isClickable = false
 
   val price = GooglePayUtil.microsToString(17852)
   val transaction = GooglePayUtil.createTransaction(price)
   val request = GooglePayUtil.createPaymentDataRequest(transaction)
   val futurePaymentData = mPaymentsClient.loadPaymentData(request)
 
   AutoResolveHelper.resolveTask(futurePaymentData, this, LOAD_PAYMENT_DATA_REQUEST_CODE)
}

Подготавливаем транзакцию. Не забываем указать тип валюты:

fun createTransaction(price: String): TransactionInfo {
   return TransactionInfo.newBuilder()
       .setTotalPriceStatus(WalletConstants.TOTAL_PRICE_STATUS_FINAL)
       .setTotalPrice(price)
       .setCurrencyCode("USD")
       .build()
}

Формируем запрос. Тут же добавляем параметры, где указываем продавца и ссылку на сайт:

fun createPaymentDataRequest(transactionInfo: TransactionInfo): PaymentDataRequest {
   val paramsBuilder = PaymentMethodTokenizationParameters.newBuilder()
       .setPaymentMethodTokenizationType(
           WalletConstants.PAYMENT_METHOD_TOKENIZATION_TYPE_PAYMENT_GATEWAY
       )
       .addParameter("gateway", “https://www.example.com”)
       .addParameter("gatewayMerchantId", "Example Merchant Name")
   return createPaymentDataRequest(transactionInfo, paramsBuilder.build())
}

Дальше сам запрос. Тут мы указываем необходимые поля и параметры для оформления заказа. К примеру, мы можем указать, нужно ли нам запрашивать номер телефона, электронную почту и вообще, нужна ли нам возможность доставки. Не отходя от кассы мы укажем страны, куда можем доставить товар.Так же тут указываются варианты оплаты и типы платежных систем (VISA, MASTERCARD):

private fun createPaymentDataRequest(
   transactionInfo: TransactionInfo,
   params: PaymentMethodTokenizationParameters
): PaymentDataRequest {
 
   return PaymentDataRequest.newBuilder()
       .setPhoneNumberRequired(false)
       .setEmailRequired(true)
       .setShippingAddressRequired(true)
       .setShippingAddressRequirements(
           ShippingAddressRequirements.newBuilder()
               .addAllowedCountryCodes(SHIPPING_SUPPORTED_COUNTRIES)
               .build()
       )
       .setTransactionInfo(transactionInfo)
       .addAllowedPaymentMethods(SUPPORTED_METHODS)
       .setCardRequirements(
           CardRequirements.newBuilder()
               .addAllowedCardNetworks(SUPPORTED_NETWORKS)
               .setAllowPrepaidCards(true)
               .setBillingAddressFormat(WalletConstants.BILLING_ADDRESS_FORMAT_FULL)
               .build()
       )
       .setPaymentMethodTokenizationParameters(params)
       .setUiRequired(true)
       .build()
}
 
private val SHIPPING_SUPPORTED_COUNTRIES = Arrays.asList("UA, US, DE, GB")
 
private val SUPPORTED_NETWORKS = Arrays.asList(
   WalletConstants.CARD_NETWORK_VISA,
   WalletConstants.CARD_NETWORK_MASTERCARD
)

Что ж, запрос сформирован и отправлен. Далее нам необходимо обработать результат этого запроса:

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
   when (requestCode) {
       LOAD_PAYMENT_DATA_REQUEST_CODE -> {
           when (resultCode) {
               Activity.RESULT_OK -> {
                   data?.let {
                       onPaymentSuccess(PaymentData.getFromIntent(data))
                   }
               }
               Activity.RESULT_CANCELED -> {
               }
               AutoResolveHelper.RESULT_ERROR -> {
                   onError(AutoResolveHelper.getStatusFromIntent(data)?.statusCode)
               }
           }
           mGooglePayButton.isClickable = true
       }
   }
}

Делаем обработку нашей транзакции. Сюда можно завязать очень много разной логики, переходов по экранам, поздравлений или просто вывода служебной информации, но в нашей версии просто проверим результат и выведем его. Это всего лишь ознакомительная версия, и мы не станем углубляться в бизнес-логику:

private fun onPaymentSuccess(paymentData: PaymentData?) {
     Toast.makeText(this, “Payment Success”, Toast.LENGTH_LONG).show()
}
 
private fun onError(statusCode: Int?) {
   Log.w("loadPaymentData failed", String.format("Error code: %d", statusCode))
}

Конечный результат интеграции: что видит юзер

В итоге, для окончательного оформления заказа и оплаты юзер увидит кнопку Google Pay:

Кнопка Google Pay

После нажатия будет вызвана форма оформления заказа:

Google Pay оформление заказа

Подведем итог

Google Pay - удобный и безопасный сервис оплаты через приложение с возможностью интеграции большого количества платежных систем. Он облегчает процесс покупки для клиентов, а продавцам это позволяет увеличить объемы онлайн-платежей. Воспользовавшись приведенным выше алгоритмом действий, вы легко сможете интегрировать сервис Google Pay в ваше Android-приложение.

Если же программирование не является вашей профессиональной сферой - обращайтесь к специалистам Stfalcon.com, и мы быстро и качественно разработаем и внедрим любой функционал для вашего мобильного приложения.