Guide du développeur d'applications payantes Android

Aprenda a adaptar su aplicación de pago de Android para que funcione con Pagos la toile y brinde una mejor expérience utilisateur a los clientes.

25 mai 2020

Les API de demande de paiement trae a la web una interfaz integrada basada en le navigateur que permite a los usuarios ingresar la información de pago requerida más fácil que nunca. La API también puede invocar aplicaciones de pago específicas de la plataforma.

En comparación con el uso de solo Android Intents, los pagos web permiten una mejor integración con el navegador, la seguridad y la experiencia del Nom d'utilisateur:

• L'application de paiement est lancée en mode modal, dans le cadre du site Internet du commerçant.
• La mise en œuvre est complémentaire à votre application de paiement existante, vous permettant de profiter de votre base d'utilisateurs.
• La signature de l'application de paiement est vérifiée pour éviter
  charge latérale.
• Les applications de paiement peuvent prendre en charge plusieurs méthodes de paiement.
• Se puede integrar cualquier método de pago, como criptomonedas, transferencias bancarias y más. Las aplicaciones de pago en dispositivos Android pueden incluso integrar métodos que requieren acceso al chip de Matériel en el dispositivo.

La mise en œuvre des paiements Web dans une application de paiement Android comporte quatre étapes:

1. Faites découvrir aux commerçants votre application de paiement.
2. Informe a un comerciante si un client tiene un instrumento registrado (como una tarjeta de crédito) que está listo para pagar.
3. Laissez un client effectuer le paiement.
4. Vérifiez le certificat de signature de l'appelant.

Pour voir les paiements Web en action, consultez le
paiement-web-android
manifestation.

Étape 1: laissez les marchands découvrir votre application de paiement

Pour qu'un commerçant utilise votre application de paiement, il doit utiliser le API de demande de paiement et spécifiez le mode de paiement que vous prenez en charge en utilisant le identifiant du moyen de paiement.

Si vous disposez d'un identifiant de mode de paiement unique pour votre application de paiement, vous pouvez définir le vôtre manifeste du mode de paiement para que los navigateurs puedan descubrir su aplicación.

Étape 2: Informer un commerçant si un client a un instrument enregistré qu'il est prêt à payer

Le commerçant peut appeler hasEnrolledInstrument () pour voir si le client peut effectuer un paiement. Vous pouvez mettre en œuvre IS_READY_TO_PAY en tant que service Android pour répondre à cette requête.

AndroidManifest.xml

Déclarez votre service avec un filtre d'intention avec action
org.chromium.intent.action.IS_READY_TO_PAY.

<un service
android:patate douce=".SampleIsReadyToPayService"
android:exported="vrai">
<intent-filter>
<action android:patate douce="org.chromium.intent.action.IS_READY_TO_PAY" />
</intent-filter>
</un service>

Les IS_READY_TO_PAY le service est facultatif. Si un tel gestionnaire d'intention n'existe pas dans l'application de paiement, le navigateur Web suppose que l'application peut toujours effectuer des paiements.

AIDL

L'API pour IS_READY_TO_PAY el servicio está definido en AIDL. Cree dos archivos AIDL con el siguiente Contenu:

appli / src / main / aidl / org / chromium / IsReadyToPayServiceCallback.aidl

package org.chromium;
interface IsReadyToPayServiceCallback {
oneway void handleIsReadyToPay(boolean isReadyToPay);
}

app / src / main / aidl / org / chrome / IsReadyToPayService.aidl

package org.chromium;
importer org.chromium.IsReadyToPayServiceCallback;
interface IsReadyToPayService {
oneway void isReadyToPay(IsReadyToPayServiceCallback callback);
}

Mettre en œuvre IsReadyToPayService

La mise en œuvre la plus simple de IsReadyToPayService illustré dans l'exemple suivant:

classer SampleIsReadyToPayService : Service() {
private val binder = object : IsReadyToPayService.Stub() {
override fun isReadyToPay(rappeler: IsReadyToPayServiceCallback?) {
rappeler?.handleIsReadyToPay(vrai)
}
}
override fun onBind(J'ai essayé: Intention?): IBinder? {
revenir binder
}
}

Paramètres

Passez les paramètres suivants à onBind comme extras Intent:

• methodNames
• methodData
• topLevelOrigin
• topLevelCertificateChain
• topLevelCertificateChain
• paymentRequestOrigin

override fun onBind(J'ai essayé: Intention?): IBinder? {
val extras: Empaqueter? = J'ai essayé?.extras
}

methodNames

Les noms des méthodes interrogées. Les éléments sont les clés du
methodData dictionnaire et indiquez les méthodes prises en charge par l'application de paiement.

val methodNames: Lister<Chaîne>? = extras.getStringArrayList("methodNames")

methodData

Un mappage de chaque entrée de methodNames au
methodData.

val methodData: Empaqueter? = extras.getBundle("methodData")

topLevelOrigin

L'origine du marchand sans le schéma (l'origine sans le schéma du contexte de navigation de niveau supérieur). Par exemple, https://mystore.com/checkout ça passera comme mystore.com.

val topLevelOrigin: Chaîne? = extras.getString("topLevelOrigin")

topLevelCertificateChain

La cadena de certificados del comerciante (la cadena de certificados del contexto de navegación de nivel superior). Nulo para localhost y archivo en disco, que son contextos seguros sin certificados SSL. La cadena de certificados es necesaria porque una aplicación de pago puede tener diferentes requisitos de confianza para los sitios web.

val topLevelCertificateChain: Array<Colisable>? =
extras.getParcelableArray("topLevelCertificateChain")

Chaque Colisable c'est un Empaqueter avec un "certificat" key et une valeur de tableau d'octets.

val list: Lister<ByteArray>? = topLevelCertificateChain?.mapNotNull { p ->
(p as Empaqueter).getByteArray("certificat")
}

paymentRequestOrigin

El origen sin esquema del contexto de navegación de iframe que invocaba new PaymentRequest (methodData, détails, options) constructor en JavaScript. Si el constructor fue invocado desde el contexto de nivel superior, entonces el valor de este parámetro es igual al valor de topLevelOrigin paramètre.

val paymentRequestOrigin: Chaîne? = extras.getString("paymentRequestOrigin")

Répondre

Le service peut envoyer sa réponse via handleIsReadyToPay (booléen) méthode.

rappeler?.handleIsReadyToPay(vrai)

Permis

Vous pouvez utiliser Binder.getCallingUid () pour vérifier qui est l'appelant. Notez que vous devez le faire dans le isReadyToPay méthode, pas la onBind méthode.

override fun isReadyToPay(rappeler: IsReadyToPayServiceCallback?) {
try {
val callingPackage = packageManager.getNameForUid(Binder.getCallingUid())

Voir Vérifier le certificat de signature de l'appelant pour savoir comment vérifier que le paquet appelant a la signature correcte.

Étape 3: laissez un client vérifier

Le commerçant appelle Spectacle() pour démarrer l'application de paiement afin que le client puisse effectuer un paiement. L'application payante est appelée via une intention Android PAYER avec les informations de transaction dans les paramètres d'intention.

L'application de paiement répond avec methodName y des détails, qui sont spécifiques à l'application de paiement et sont opaques pour le navigateur. Le navigateur convertit le des détails
Chaîne dans un objet JavaScript pour le marchand via la désérialisation JSON, mais elle n'applique aucune validité au-delà de cela. Le navigateur ne modifie pas le
des détails; la valeur de ce paramètre est transmise directement au commerçant.

AndroidManifest.xml

L'activité avec le PAYER Le filtre d'intention doit avoir un Une balise qui identifie l'identifiant du mode de paiement par défaut pour l'application.

Pour prendre en charge plusieurs modes de paiement, ajoutez un étiquette avec un
Ressource.

<activity
android:patate douce=".PaymentActivity"
android:thème="@style/Theme.SamplePay.Dialog">
<intent-filter>
<action android:patate douce="org.chromium.intent.action.PAY" />
</intent-filter>
<meta-data
android:patate douce="org.chromium.default_payment_method_name"
android:valeur="https://bobpay.xyz/pay" />
<meta-data
android:patate douce="org.chromium.payment_method_names"
android:Ressource="@array/method_names" />
</activity>

Les Ressource debe ser una lista de cadenas, cada una de las cuales debe ser una URL absoluta válida con un esquema HTTPS como se muestra aquí.

<?xml version="1.0" encoding="utf-8"?>
<Ressources>
<string-array patate douce="method_names">
<Objet>https://alicepay.com/put/optional/path/here</Objet>
<Objet>https://charliepay.com/put/optional/path/here</Objet>
</string-array>
</Ressources>

Paramètres

Les paramètres suivants sont transmis à l'activité en tant que suppléments d'intention:

• methodNames
• methodData
• topLevelOrigin
• topLevelCertificateChain
• paymentRequestOrigin
• le total
• modificateurs
• paymentRequestId

val extras: Empaqueter? = J'ai essayé?.extras

methodNames

Les noms des méthodes utilisées. Les éléments sont les clés du
methodData dictionnaire. Voici les méthodes prises en charge par l'application de paiement.

val methodNames: Lister<Chaîne>? = extras.getStringArrayList("methodNames")

methodData

Une cartographie de chacun des methodNames au
methodData.

val methodData: Empaqueter? = extras.getBundle("methodData")

Nom du commerçant

Le contenu du