Operatörler için Google Standart Ödemeler'e Giriş

Google Standart Ödemeler dünyasında, Operatör Faturalandırması token atanmış bir ödeme şekli (FOP) olarak kabul edilir. Yani Google ve Ödeme Entegratörü, jeton oluşturmak için bir defalık hesap kimliği kimlik bilgileri değişimi gerçekleştirir. Daha sonra bu jeton, ödeme alınacak hesabı tanımlamak için Ödeme Entegratörü'ne geri gönderilir.

Diğer ödeme şekillerinde de tokenizasyon kullanılır. Bu nedenle, çoğu Operatör Faturalandırması ile alakalı olan Jetonlu FOP'lere genel bir bakış sunuyoruz. Kimlik doğrulama, İlişkilendirme, satın alma ve havale akışının tümü bu genel bakışta daha ayrıntılı olarak açıklanmıştır. Bu sayfada, Operatör Faturalandırması'na özel bir bağlamda ayrıntılı bilgi verilmektedir.

Operatörler, aşağıdaki akışları oluşturan API'leri uygulayarak Google Standart Ödemeler'e katılır:

Akma Açıklama DCB3 Spesifikasyon Eşdeğeri
Kimlik doğrulama Kullanıcının Ödeme Entegratörü sisteminde DCB ödemeleri için kullanılacak hesabını tanımlar ve doğrular GoogleUserToken ile SMS-MO
İlişkilendirme Google ve Ödeme Entegratörü'nün üzerinde anlaştığı uzun ömürlü jeton değişimi OperatorUserToken ve GetSağing() işlevlerinden onay alarak kullanıcı geri çağırması
FundsTransfer Eşzamanlı olarak parayı kullanıcının Ödeme Entegratörü hesabının dışına taşır. Sorumluluğu Ödeme Entegratörüne aktarır, Toplu istek dosyalarındaki Auth() ve CHARGE satırları
Geri ödeme Önceki bir Fon Transferi ile ilişkili paranın bir kısmını veya tamamını kullanıcının Ödeme Entegratörü hesabına eşzamanlı olarak döndürür. Sorumluluğu Google'a devrederek Toplu istek dosyalarındaki REFUND satırları
Havale tercihen günlük bazda API tabanlı ödeme Aylık fatura PDF'si, aylık fatura ayrıntılar dosyası, günlük rapor
UpdateAssociatedAccount Kullanıcının Ödeme Entegratörü hesabında yapılan değişiklikler (ör.işlem sınırları veya temel hazırlık durumu) konusunda Google'ı bilgilendirir. GetProvideing() anketi
Sahtekarlık Google'ı bir kullanıcı anlaşmazlığı nedeniyle geri alınan işlemler hakkında bilgilendirir. Bu, Google'ın risk motorunu iyileştirmek için kullanılır ancak para sorumluluğunu etkilemez. Yok

DCB3 Spesifikasyonuyla Genel Karşılaştırma

Google Standart Ödemeler spesifikasyonu, DCB3 Spesifikasyonu'nun çözdüğü sorunları çözer. Ancak çözümü iyileştiren farklı teknolojiler ve API tasarımları kullanır. Bir bakışta temel farklılıklar şunlardır:

Yığın Teknolojisi Karşılaştırması

Tüm API iletişimleri, PGP şifreli ve imzalı JSON ile HTTPS POST'ları kullanılarak yapılır. Yani hem Google hem de Ödeme Entegratörü'nün dönüşümlü olarak yalnızca bir PGP anahtarı olur. Bu teknolojiler SOAP'dan daha iyi desteklenmektedir. İletişim yığını hakkında daha fazla bilgiyi burada bulabilirsiniz.

API Felsefesi Karşılaştırması

DCB3, ödeme durumunu uzlaştırmak için büyük ölçüde dosyaları kullanır. Google Standart Ödemeler'de dosya yoktur. API çağrıları, nihai bir durum belirlenene kadar benzersiz bir şekilde ve süresiz bir şekilde yeniden denenir.

Son durumlar, belirli bir kimlik aciliyeti anahtarı için gerçekten nihaidir. Hatalar ve belirsiz durumlar, düşüşler olarak değil, 200 olmayan HTTP yanıtları olarak modellenir. Bu sayede hataları daha hızlı yakalayabilir ve ret olarak maskelemekten kaçınabiliyoruz.

Yeni Özellikler

Google Standart Ödemeler, aşağıdakiler de dahil olmak üzere yeni özellikleri destekler:

  • Google'ın dolandırıcılar için risk motoruna bilgi sağlayan Fraud API
  • Google'a temel hazırlık, işlem sınırları ve hesap durumu değişiklikleri hakkında bilgi vermek için Associated Account API'yi güncelleyin
  • Satın alma işlemleri sırasında USSD PIN'leri gibi daha fazla kimlik doğrulama sorgulaması desteği
  • Günlük havale dönemi

DCB3'ten Google Standart Ödemeler Terminoloji Haritasına

Bu belgede ve spesifikasyonun kendisinde, yeni görünen ama aslında mevcut kavramlar için farklı kelimeler olan bir terminoloji göreceksiniz.

  • Operatör -> Ödeme Entegratörü

UYARI: Bu dokümanda, DCB entegratörü kavramıyla karıştırılmamak için, yalnızca "entegre edici" yerine "Ödeme Entegratörü" ve "DCB entegratörü" kullanılır. Ancak, Google Standart Ödemelerle ilgili genel dokümanlarda "Ödeme Entegratörü" kısaltması olarak "entegre edici" kelimesi genel olarak

  • Faturalandırma Sözleşmesi Kimliği -> Ödeme Entegratörü Hesap Kimliği
  • OperatörUserToken (OUT) -> GooglePaymentToken (GPT)
  • correlation_id -> requestId
  • Gelir paylaşımı -> ücret

Kimlik Doğrulama Akışı

Token Atanmış FOP'lerle ilgili kimlik doğrulama akışına genel bir bakış için bu sayfayı inceleyin.

Operatör Faturalandırması Ayrıntıları

Operatör Faturalandırması için kimlik doğrulama akışının amacı, kullanıcının operatör hesabına bağlı SIM kart üzerinde kontrol sahibi olduğunu kanıtlamaktır. Operatör Faturalandırması kullanıcılarının kimliği aşağıdaki üç mekanizmadan biri kullanılarak doğrulanabilir:

Ödeme Entegratörleri, ürünlerine en uygun kimlik doğrulama yöntemlerini seçmek için Google ile birlikte çalışabilir.

DCB3 ile karşılaştırma

Kimlik doğrulama akışı, Google'a yapılan approveuser geri çağırmasını DCB3 spesifikasyonundan DIŞI ile değiştirir.

DCB3'te kimlik doğrulama ve ilişkilendirme tek bir akışta birleştirildi. Google Standart Ödemeler'de kimlik doğrulama, hesap ilişkilendirmesinden ayrı bir meseledir.

İlişkilendirme Akışı

Token Atanmış FOP'lerle ilgili ilişkilendirme akışı hakkında genel bilgi için bu sayfayı inceleyin.

Operatör Faturalandırması araçları için kullanılan ilişkilendirme akışı ile genel Jetonlu FOP akışı arasındaki temel fark, associateAccount yönteminde sağlanan kimlik doğrulama kanıtının, Ödeme Entegratörü tarafından ek bir kullanıcı sorgulaması talep edip etmediğine bağlı olarak değişiklik göstermesidir.

Ödeme Entegratörü, kullanıcının ek bir doğrulama sorunu istediğini belirttiyse Google'ın ek giriş sorgulaması için kullandığı belirli kimlik doğrulama mekanizması tarafından oluşturulan kimlik kanıtı, kimlik doğrulama kanıtı olarak kabul edilir. Örneğin, SMS-MT OTP mekanizması tarafından oluşturulan kimlik doğrulama kanıtı, bir sendOtp yönteminin requestId ve OTP'nin kendisidir.

Araç Özellikleri

Genel Token Atanmış FOP'ye genel bakışın Araç Özellikleri bölümünde accountAlias, accountNickname ve fullAccountNickname kavramı açıklanmaktadır.

Operatör Faturalandırması Ayrıntıları

  • accountAlias, kullanıcının telefon numarası olmalıdır. Bu kimlik, kullanıcının hesabıyla ilgili olarak Google destek ekibini araması durumunda aracı tanımlamak için kullanılır.
  • accountNickname ve fullAccountNickname, kullanıcı arayüzünde aracı tanımlamak için kullanılan görünen adlardır.

DCB3 Spesifikasyonuyla Karşılaştırma

İlişkilendirme akışı, DCB3 spesifikasyonunun aşağıdaki bileşenlerinin yerini alır:

  • GetTemel Hazırlık SOAP çağrısı
  • GetAboneAddress SOAP çağrısı
  • Kargo şirketi tarafından oluşturulan OUT

Buradaki büyük farklardan biri, Google Ödeme Jetonu'nu (GPT) operatör tarafından değil, ilişkilendirme akışı sırasında oluşturmasıdır.

Ayrıca, OUT'ların belirli bir BillingAgreementId değerine ayarlandığı DCB3'ten farklı olarak, GPT'nin belirli herhangi bir PaymentIntegratorAccountID için geçerli olmadığını unutmamak da önemlidir.

Jeton Akışını Yenileme

Token Atanmış FOP'lerle ilgili yenileme jetonu akışına genel bir bakış için bu sayfayı inceleyin.

Operatör Faturalandırması Ayrıntıları

Operatör Faturalandırması araçlarında, abonelik siparişlerinin iptal edilmesine yol açacağı için Google Ödeme Jetonlarının süresinin dolması kesinlikle tavsiye edilmez. Jetonların süresinin dolmak üzere olması ve bunları düzeltmek için yenileme jetonu akışına bağlı kalmak yerine, kullanım alanınız genellikle aşağıda açıklanan hesap güncelleme akışı kullanılarak gerçekleştirilebilir.

Hesap Güncelleme Akışı

Hesap güncelleme akışı, Ödeme Entegratörü'nün kullanıcının entegratör hesabındaki güncellemeler hakkında Google'ı bilgilendirmesine olanak tanır. Bu alanlar başlangıçta Google'a ilişkilendirme akışı sırasında sağlanır. Ödeme Entegratörü'nün güncellemek isteyebileceği hesap verilerine örnek olarak şunlar verilebilir:

  • Kullanıcının aylık, günlük ve öğe başına işlem sınırları
  • kullanıcının entegratör hesabının temel hazırlık durumu
  • Kullanıcının entegre edici hesap türü (ön ödemeli, faturalı, kurumsal vb.)
  • kullanıcının "accountAlias", "accountNickname" veya "fullAccountTakmaadı"
  • kullanıcının önceden paylaşılan statik PIN'i oluşturup kaldırmadığı veya değiştirip değiştirmediği
  • Kullanıcının hesabını kapatmış veya telefon numarasını değiştirmiş olması, kullanıcının Google'ın sistemindeki aracının geçersiz kılınmasına yol açar.
  • jeton akışını sil

DCB3 Spesifikasyonuyla Karşılaştırma

Hesap güncelleme akışı, DCB3 spesifikasyonunun aşağıdaki bileşenlerinin yerini alır:

  • GetTemel Hazırlık SOAP çağrısı yoklama
  • Periyodik jeton geçersiz kılma

Satın Alma Süreci

Token Atanmış FOP'lerin satın alma akışına genel bir bakış için bu sayfayı inceleyin.

Operatör Faturalandırması Ayrıntıları

Bazı operatörler, her satın alma işleminde kullanıcılarından PIN almak için USSD veya başka bir teknoloji kullanır. Bu operatörlerde, reCAPTCHA() işlevini çağırmak yerine asyncCapture() yöntemini çağırırız ve operatörün kullanıcıdan PIN'ini istemesi ve yakalamayı tamamlaması için 30 saniye süre tanırız. Ödemenin son durumu belirlendiğinde operatör, captureResultBildirim() işlevini çağırarak sonucu Google'a bildirir.

DCB3 Spesifikasyonuyla Karşılaştırma

Burada önemli değişiklikler var.

  • Tek, eşzamanlı yöntem çağrısı -- auth() + toplu dosya yerine reCAPTCHA()
  • Hiç toplu dosya yok
  • cancel() yöntemi yok (kimlik doğrulama + iptal yerine yakalama + geri ödeme)
  • Yanıt olarak user_message alanı yok. Reddetme kodları, Google'a ait ve kullanıcının hesap diline göre yerelleştirilmiş mesajlarla eşlenir.
  • Temel terminoloji değişiklikleri:
    • CorrelationId -> requestId
    • BillingSözleşmeId -> paymentIntegratorAccountId
    • OperatorUserToken -> googlePaymentToken

İtiraz Edilen Satın Alma Süreci

Her satın alma işleminden önce kullanıcıya kimlik doğrulama sorgulamasını içeren bir satın alma akışını desteklemek için geliştirme süreci devam etmektedir. İlişkilendirme akışından önce kullanılabilecek çoğu kimlik doğrulama yöntemi, ek kullanıcı kimlik doğrulaması sağlamak için zorlanan satın alma akışından önce de kullanılabilir.

Geri Ödeme Akışı

Token Atanmış FOP'lerle ilgili geri ödeme akışına genel bir bakış için bu sayfayı inceleyin.

Jetonlu FOP, tek bir mesaj geri ödeme akışını destekler. Geri ödeme yöntemi, bir satın alma işleminin tamamının veya bir kısmının geri ödenmesini destekler. Birden fazla kısmi geri ödeme yapıldığında tek bir satın alma işlemi için geri ödeme yapılabilir.

Operatör Faturalandırması Ayrıntıları

Geri ödeme akışında Operatör Faturalandırması araçlarıyla ilgili özel bir durum yoktur.

DCB3 Spesifikasyonuyla Karşılaştırma

Geri ödemeler bir dosya yerine eşzamanlı API çağrısı tarafından tetiklenir. Ayrıca, yalnızca tek bir tam değer geri ödemeyi desteklemek yerine, tek bir orijinal ödeme için birden fazla kısmi geri ödeme yapılabilir.

Havale Akışı

Token Atanmış FOP'lerle ilgili havale akışı hakkında genel bilgi edinmek için bu sayfayı inceleyin.

Havale akışı, Google ve Ödeme Entegratörü'nün anlaşmayı gerçekleştirme şeklidir. Kayıt sistemi Google'dır ve havale transferlerini de muhasebeleştirir. Google, Ödeme Entegratörü'ne düzenli olarak bir havale beyanı gönderir. Bu beyanda, Ödeme Entegratörü'nün Google'a borçlu olduğu tutarın özeti ve Google'a nasıl ödeme yapılacağıyla ilgili talimatlar sağlanır. Ödeme Entegratörü'nün mutabakat sağlaması için Ödeme Entegratörü, Google'dan havale ekstresini oluşturan işlem düzeyindeki ayrıntıları öğrenebilir.

Operatör Faturalandırması Ayrıntıları

Operatör Faturalandırması remittanceStatementDetails, henüz havale akışının API tanımlarında listelenmeyen ek alanları içermektedir. Bunlardan bazıları:

  • revshareCategory
  • itemPrice
  • tax
  • timestamp

Google ile gelir paylaşımı payı 50/50 olan bölüştürme sözleşmesi olan operatörler için remittanceStatementDetails hükümlerinde belirtilen ücretler, etkinlik başına sunulmak yerine revshareCategory başına toplanır.

DCB3 Spesifikasyonuyla Karşılaştırma

Havale akışı, DCB3 spesifikasyonunda yer alan aşağıdaki kavramların yerini almıştır:

  • Aylık Ödeme Raporu/Ödeme Raporu PDF'si
  • Aylık fatura ayrıntıları CSV dosyası
  • Günlük keşif CSV dosyaları

Buradaki önemli farklar, dosyaların kaldırılması ve günlük havalelerin desteklenmesidir. Dosyalar yerine, havale edilecek tutar eşzamanlı bir API aracılığıyla gönderilir ve başka bir API, havale beyanıyla ilgili ayrıntılar için sorgulamayı destekler.

Sahtekarlık Raporlama Akışı

Sahtekarlık raporlama akışı, bir ödeme entegratörünün fraudNotification yöntemini çağırarak sahte olabilecek işlem hakkında Google'ı bilgilendirmesine olanak tanır. Bu akış, Google'ın dahili risk motorunu güncellemek için kullanılır ve herhangi bir para aktarımı başlatmaz.

Operatör Faturalandırması Ayrıntıları

Ödeme geri alma bildirim akışında Operatör Faturalandırması araçlarıyla ilgili özel bir durum yoktur.