Android APK Para Ekleme API'si

Para ekleme işlemi üç farklı ortamda gerçekleşebilir:

  • Ödeme entegrasyon uzmanının Android uygulaması
  • Ödeme entegratörü mobil web sitesi
  • Ödeme entegrasyon uzmanının masaüstü web sitesi

Akıştan bağımsız olarak, Google kullanıcı etkileşimini Ödeme entegratör yazılımı dahildir. Ödeme entegratörü, kullanıcılara tanıdık ancak akış özel olarak kullanıcı başına ortalama gelire kullanıcının bakiyesi (kullanıcının para ekleme işlemiyle yönlendirilmesi gerektiği anlamına gelir). kullanıcılarından bekledikleri genel amaçlı bir kullanıcı arayüzüne devam edeceğiz.

Tüm akışlar entegratörün bir sonuç üretmesine neden olur. TopUpRedirectResponse. Bu yanıt imzalandı ve gönderildi Google'a dönebilir.

Mobil ve masaüstü web siteleri, Web Para Ekleme API'si Spesifikasyonu, Android Uygulama akışı da Android Top Up API Spesifikasyonu'na uygun olmalıdır.

Entegratörler, kullanıcının kimliğini doğrulamak için bir Android APK çözümü uygulamalıdır ve bakiyelerini eklemeleri için onları bir akışa yönlendirebilirsiniz. Bu para ekleme işlemi farklı bir yöntem olsa da "the" Web para ekleme.

Kullanıcı, bir web sitesi üzerinden ödeme entegratörü uygulamasındaki akışa Android Etkinliği. Para ekleme amacı, doğrudan kullanıcının şu anda kullandığı bir Play uygulamasından satın alma niyeti olduğunu varsayalım. Android'in Play'i sonlandırmasını önlemek için sırasında entegratörün şunları içermesi gerekir: ve etkinlik temasını girin.

<item name="android:windowIsTranslucent">true</item>

Yöntem tanımı

Niyetin şu özelliklere sahip olması gerekir:

Yöntem özellikleri
İşlem com.google.android.payments.standard.TOPUP_V1
Kategori android.intent.category.DEFAULT

İstek

Alanlar
gspTopUpRequest TopUpRedirectRequest

Para ekleme isteği.

gspAssociationId string

Entegratörün kimlik bilgilerini aramak için kullandığı bir tanımlayıcı içerir Google Ads'e aktarıyoruz. Bu, ilişkilendirme kimliğidir AssociateAccountRequest'teki hesap bağlama sırasında gönderilen.

Yanıt

Kullanıcı para ekleme akışını tamamladıktan sonra, uygulamanızın bu bilgileri Google’a iletebiliriz. Para ekleme başarılı olursa amaç oluşturun ve Şifrelenmiş olarak kodlanmış gspTopUpResponse ve redirectRequestId değerlerini ekstra olarak ekleyin. Sonra, etkinliği ayarlayın uygun sonuç koduna ekleyin.

...
result.setExtra("gspTopUpResponse", gspTopUpResponse);
result.setExtra("redirectRequestId", redirectRequestId);
setResult(Activity.RESULT_OK, result);
...
finish();

Sonuç

Alanlar
sonuç int

Activity.RESULT_OK
Para ekleme işlemi başarılı.
Activity.RESULT_CANCELED Kullanıcı akışı manuel olarak iptal ettiği için akışın iptal edilmesi gerekiyor.
Activity.RESULT_FIRST_USER Önemli bir nedenden dolayı para ekleme işlemi başarısız oldu, akışın şu şekilde olması gerekir: iptal edildi. IE sunucusu girişte HTTP 500 yanıtı döndürdü.

Ekstralar

Alanlar
gspTopUpResponse TopUpRedirectResponse.

ZORUNLU: Ek yanıt. Bu kodlanmış değer 1 KB'ı aşmamalıdır.
redirectRequestId string

ZORUNLU: Orijinal/başlatan yönlendirme ödeme isteğinde gönderilen requestId. Google bunun gönderilen requestId ile eşleştiğini doğrular ve eşleşmezse Tam Yönlendirme akışı başarısız olur.

Diğer etkinlik gereksinimleri

Yukarıda belirtilen TOPUP_V1 işlemini destekleyen etkinlik ayrıca API çağrılarının yalnızca Google tarafından imzalanmış uygulamalardan gelip gelmediğini kontrol etmelidir. Bu, diğer uygulamaların etkinliğinizi çağırmasını önlemeye yardımcı olur ve kullanıcı verilerini alma. Bu işlem, sağlanan Hemen sonrasında StandardPaymentUtils.verifyCallingActivityIsGoogleSigned super.onCreate içinde Etkinlik hakkında bilgi edindiniz.

Aşağıda örneği verilmiştir:


@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  StandardPaymentsUtils.verifyCallingActivityIsGoogleSigned(this);

  ....
}

Para ekleme akışı içinde çağrılan tüm etkinlikler bir etkinlik sağlamalıdır windowIsTranslucent=true içeren tema. Bu, AndroidManifest android:theme özelliği ve Context.setTheme() kullanılmıyor. Programatik olarak temanın ayarlanması pencere için doğru şekilde çalışmıyor yarı saydamlık. Google, başlatılan ilk etkinliğin bu ama başlatılan tüm alt etkinliklerin de bu kurala uyması gerekir desen. Aksi takdirde, 3. taraf geliştiricilerden yapılan satın alma işlemleri gerçekleştirilemeyebilir.