MIT desteğine genel bakış
Satıcı tarafından başlatılan işlemler (MIT), kullanıcının aktif oturumda olmadığı durumlarda işlenen işlemlerdir. Google Pay Online API'deki bu güncelleme, bu işlem türleri için daha iyi görünürlük, özel faturalandırma ayrıntıları kullanıcı deneyimi aracılığıyla iyileştirilmiş kullanıcı deneyimi ve daha iyi ödeme sürekliliği sağlar.
Temel Kullanım Alanları
- Tekrarlanan Ödemeler: Dijital akış hizmetleri, üyelikler veya kamu hizmetleri.
- Ertelenmiş Ödemeler: Otel rezervasyonları, ön siparişler veya rezervasyonun kullanılmaması nedeniyle alınan ücretler.
- Otomatik Yeniden Yüklemeler: Toplu taşıma veya hediye kartları için saklanan değer yüklemeleri.
MIT API Uygulaması
MIT API, mevcut
LoadPaymentData
API'nin bir uzantısıdır. Entegrasyon uzmanları, faturalandırma amacını belirtmek için tam olarak bir *TransactionInfo nesnesi eklemelidir.
Google, satıcı tarafından başlatılan işlemin türüne bağlı olarak 3 seçenek sunar:
| İşlem Türü | Nesne Adı | Açıklama |
|---|---|---|
| Yinelenen (Recurring) | RecurringTransactionInfo |
Sabit sıklıkta alınan ücretler için kullanılır. Denemeleri, ön ödemeli ve sonradan ödemeli faturalandırmayı destekler. |
| Ertelendi | DeferredTransactionInfo |
Belirlenmiş bir gelecekteki zamanda tek bir ödeme için kullanılır. |
| Otomatik para yükleme | AutomaticReloadTransactionInfo |
Bakiye minimum eşiğin altına düştüğünde kayıtlı değer hesabına yeniden yükleme yapmak için kullanılır. |
Entegrasyon Adımları
- Dokümanlar: Üç yeni nesne tanımı, dokümanların Nesne Referansı bölümünde yer alır ve önceki listede doğrudan bağlantılıdır.
- Uygulama: API isteğinizde sisteminiz için ilgili
*TransactionInfonesnelerini kullanın.- API'ye istek başına yalnızca bir nesne geçirilebileceğini unutmayın. Hangi nesnenin kullanılacağına ve alanların doldurulacağına satıcı karar verir.
- Test etme: Fatura ayrıntılarının ödeme bordrosunda doğru şekilde oluşturulduğunu doğrulamak için TEST ortamını kullanın.
- Lansman: Parametreler doğrulandıktan sonra canlı yayına başlayın.
Jeton Yaşam Döngüsü Yönetimi (TLM)
Token Yaşam Döngüsü Yönetimi, güvenli ödeme jetonları güncellendiğinde veya devre dışı bırakıldığında anlık bildirimler göndererek ödeme sürekliliğini sağlar. Ayrıntılı bilgi için Jeton Yaşam Döngüsü Yönetimi belgelerine bakın.
Önemli Jeton Etkinlikleri
- Devre dışı bırakma/Silme: Bir jeton artık kullanılamadığında bildirim gönderir.
- FPAN Soneki Güncellemeleri: Temel Ödeme Hesabı Numarası güncellendiğinde gerçekleşir.
Sunucu Kurulumu İçin Gerekenler
Doğrudan satıcılar ve ödeme hizmeti sağlayıcıları (PSP'ler) bu mesajları almak, şifrelerini çözmek ve işlemek için bir sistem oluşturmalıdır.
| Gereksinim | Açıklama |
|---|---|
| Uç nokta | POST çağrılarını almak için güvenli HTTPS uç noktası. |
| Kimlik doğrulama | İmza doğrulama ve ileti şifre çözme işlemlerini gerçekleştirmelidir. |
| Yanıt | Bildirimlere devam etmek için SUCCESS, bildirimleri durdurmak için TOKEN_NOT_FOUND/TOKEN_NOT_IN_USE değerini döndürün. |
| Satıcı Bildirimi | ÖPG'lerin, jeton durumunu satıcılarına bildirmesi gerekir. |
Uygulama Notları
Jetonla ilgili güncellemeleri almak için tokenUpdateUrl uç noktası işlemle birlikte iletilmelidir. Ödeme hizmeti sağlayıcıları için, satıcıların bu URL'yi nasıl alacağını ve ilgili *TransactionInfo nesnesine nasıl dolduracağını belirlemek ödeme hizmeti sağlayıcısının sorumluluğundadır.
Ayrıca, şifrelenmiş yükün MIT'ler için ek bir isteğe bağlı alan olan
merchantTokenId döndüreceğini de unutmayın. Ayrıntılı bilgi için
Ödeme Verisi Kriptografisi
dokümanına (satıcılar için) veya Yük Yapısı
dokümanına (PSP'ler için) bakın.