Entegratörler, para ekleme amacıyla kullanıcıları yönlendirmek için bir web barındırıcısı uygulamalıdır. Bu ekleme farklı bir yöntem olsa da Android Para Ekleme tarafından sağlanan parayla aynı amacı taşır. Bu web barındırıcısının mobil uyumlu bir web sitesi olmalıdır.
Web barındırıcısı, kullanıcı aracısı üst bilgisi değerine göre mobil web isteklerini ve masaüstü web isteklerini belirlemelidir. Mobil web isteklerinde yayınlanan sayfa, Android ve iOS'te mobil web uyumlu olmalıdır. İstemci, kullanıcı aracısı üst bilgisi değerinin yanı sıra, bu kullanıcının istekte bulunduğu ortamla (masaüstü veya web) ilgili başka bir ipucu sağlamaz.
Sunucu, GET kullanarak HTTPS protokolü uygulamalıdır. Yol ve ana makine entegratör tarafından tanımlanır. Entegratör,2.048 karakter uzunluğunda URL uzunluklarını desteklemelidir. Buna şema, ana makine, bağlantı noktası, yol ve parametreler dahildir.
Tüm parametreler, URL olarak kodlanmadan önce UTF-8 olarak kodlanacaktır.
İstek
Google, istek üzerine URL parametreleri olarak aşağıdakileri sağlar:
| Alanlar | |
|---|---|
gspMajorVersion
|
int
Bu isteğin ana sürüm numarası. |
gspTopUpRequest
|
TopUpRedirectRequest
Para ekleme isteği. |
gspAssociationId
|
string
Entegratörün, kullanıcının eklediği hesabın kimlik bilgilerini aramak için kullandığı bir tanımlayıcıyı içerir. Bu, AssociateAccountRequest'te hesap bağlama işlemi sırasında gönderilen ilişkilendirme kimliğidir. |
gspCallbackUrl
|
string
Google'da para ekleme akışını tamamlamak için kullanıcının yönlendirileceği URL. Bu değer URL olarak kodlanmıştır. |
Yanıt
Para ekleme işlemi tamamlandıktan sonra kullanıcı, HTTPS GET kullanılarak gspCallbackUrl öğesine yönlendirilmelidir. Bu URL'de aşağıdaki sorgu parametreleri olmalıdır:
| Alanlar | |||||||
|---|---|---|---|---|---|---|---|
gspResult
|
int
|
||||||
| redirectRequestId |
string ZORUNLU: Orijinal/başlayan yönlendirme ödeme isteğinde gönderilen requestId. Google bunun gönderilen requestId ile eşleştiğini doğrular ve tam yönlendirme akışı eşleşmezse tam yönlendirme akışı başarısız olur.
|
||||||
gspTopUpResponse |
ZORUNLU: TopUpRedirectResponse, PGP veya JWE+JWS kullanılarak şifrelenmeli ve imzalanmalıdır. Ayrıca bu değer web için güvenli base64 kodlamalı olmalıdır. |
||||||