Genel bakış
Token atanmış FOP, referans numarası kullanım alanını destekleyebilir. Ürünler için ödeme yapmak isteyen bir kullanıcı, Ödeme entegratörü üzerinden bir referans numarası oluşturur. Daha sonra kullanıcı, bu referans numarasını bir markete, kiosk veya bankaya gönderir ve referans numarasını öder.
Nakit ödeme şekli, referans numarası kullanım alanını da destekler. Token Atanmış FOP ile Nakit Ödeme Şekli arasındaki en önemli fark, token atanmış ödeme şeklinin ilişkilendirme gerektirmesi ve geri ödemeleri desteklemesi, nakit ödeme ödeme yönteminin ilişkilendirme gerektirmemesi ve geri ödemeleri desteklememesidir. Bu belgede, entegrasyonun Referans Numarası Kullanım Alanı için nasıl çalışacağı açıklanmaktadır.
Genel olarak entegrasyon aşağıdaki akışları içerir:
- Kimlik doğrulama akışı
- İlişkilendirme akışı
- Satın alma akışı (Nakit ödeme şekliyle aynı)
- Geri ödeme süreci
- Havale akışı
Satın alma akışı, Nakit Ödeme Şekli Satın Alma akışıyla aynı olur.
Web yönlendirmesi kimlik doğrulaması kullanılan entegrasyon örneği.
İlgili API'ler
Kimlik doğrulama akışı
Entegratör tarafından uygulanan API: Web Kimlik Doğrulaması.
İlişkilendirme akışı
Entegratör tarafından uygulanan API: Payment Integrator Barındırılan Jetonlu FOP API'sinde associateAccount.
Satın alma süreci
Payment Integrator tarafından Barındırılan Tokenized FOP API'de entegratör tarafından uygulanan API: generateReferenceNumber ve cancelReferenceNumber.
Google tarafından uygulanan API: Google Tarafından Barındırılan Jetonlu FOP API'de referenceNumberPaidNotification.
Geri ödeme süreci
Entegratör tarafından uygulanan API: Ödeme Entegratörü Tarafından Barındırılan Jetonlu FOP API'de refund.
Havale akışı
Entegratör tarafından uygulanan API: Ödeme Entegratörü Tarafından Barındırılan Remittance API'ye göz atın.
Google tarafından uygulanan API: Google Tarafından Barındırılan Remittance API'ye göz atın.
Tüm akışlar nasıl birbirine denk gelir?
Araç Oluştur
Google'ın kullanıcı arayüzünde, kullanıcı Web Kimlik Doğrulaması yapmak için entegratör tarafından barındırılan bir web sayfasına yönlendirilir. Kullanıcı, başarılı bir kimlik doğrulama işleminden sonra tekrar Google'a yönlendirilir. Daha sonra Google associateAccount özelliğini çağırır. authenticationResponse
öğesindeki requestId
, associateAccount isteğinin authenticationRequestId
değeri olacaktır. Başarılı bir ilişkilendirme sonrasında Google, googlePaymentToken
(GPT) ve diğer meta verileri kullanıcı için araç olarak depolar.
Araç Oluşturma - Kimlik doğrulama akışı
Araç Oluşturma - İlişkilendirme akışı
Referans numarası oluştur
Kullanıcı enstrümanla ürün/hizmet satın almak istediğinde Google, GPT ile generateReferenceNumber çağrısını yapar. generateReferenceNumber isteğinin başlığındaki requestId
, ilgili API'lere yönelik işlemi tanımlamak için kullanılır.
Referans numarasını ödeyin
Kullanıcı, referans numarasını çevrimdışı olarak ödedikten sonra, entegrasyon aracı referenceNumberPaidNotification'i çağırır. generateReferenceNumber isteğinin başlığındaki requestId
, referenceNumberPaidNotification isteğinin generateReferenceNumberRequestId
değeri olacaktır.
İşlemi iptal etme
Kullanıcı ödeme yapmadan önce işlemi iptal etmeye karar verirse Google, cancelReferenceNumber numaralı telefonu arar. generateReferenceNumber isteğinin başlığındaki requestId
, cancelReferenceNumber isteğinin generateReferenceNumberRequestId
değeri olur.
İşlem için geri ödeme yapma
Referans numarası ödendikten sonra, kullanıcı parayı geri almak isterse Google geri ödeme işlemini gerçekleştirir. generateReferenceNumber isteğinin başlığındaki requestId
, geri ödeme isteğinin transactionId
değeri olacaktır.
Havale
Sözleşme uyarınca Google, beyan hazır olduğunda entegratörü bilgilendirmek için remittanceStatementNotification numaralı telefonu arayacaktır. Ardından entegratör mutabakatı gerçekleştirmek için Google Barındırılan Remittance API'yi çağırır.