Referans Numarası Kullanım Alanı

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:

1. Kimlik doğrulama akışı
2. İlişkilendirme akışı
3. Satın alma akışı (Nakit ödeme şekliyle aynı)
4. Geri ödeme süreci
5. 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.