API Entegrasyonu

Payguru Nakit Ödeme ve Banka Transferi API entegrasyonu, üye işyelerine Payguru hesaplarına kendileri ile ilgili yapılan ödemeleri "dinleme", müşterinin üye işyerine iletmiş olduğu ödeme bildirimlerini Payguru sisteminde sorgulama ve bu iki süreç sonrasında söz konusu ödemeleri kayıt altına alarak finansallaştırma imkanını sağlayan bir finans ve teknoloji çözümüdür. Bu API'nin bileşenleri aşağıda adımları gösterilen ödeme sürecinde kullanılmak üzere üye işyeri ile Payguru arasındaki teknik iletişimi sağlar.

  • Müşteri, üye işyerinin kendi sitesine eklemiş olduğu "Nakit Ödeme ve Para Transferi" opsiyonunu seçer
  • Üye iş yeri müşterisine yapmış olduğu alışveriş/vermiş olduğu sipariş ile ilgili İşlem Kodu (order) unu ve ödeme yapabileceği Payguru'ya ait banka hesap numalarını bu sayfa üzerinde gösterir.
  • Müşteri dilediği banka aracılığı ile ATM'den, banka şubesinden veya dijital ve mobil bankacılık kanalları üzerinden ödemesini gerçekleştirirken söz konusu İşlem Kodu nu, banka arayüzlerindeki "açıklama" alanına girer.
  • Payguru, yapmış olduğu banka entegrasyonları üzerinden kendi hesaplarına yapılmış olan ödeme bilgilerini alır ve açıklama alanına girilmiş olan işlem kodunu üye işyeri kayıtları ile eşleyerek ödemenin ait olduğu ilgili üye iş yerini tesbit eder ve üye iş yerine iş bu API entegrasyonu üzerinden ilgili ödeme bildirimini yapar.
  • İşlem kodunun eşleşmediği durumlarda Payguru ödeme miktarını korumalı hesapları üzerinde tutar. Müşteri'nin bu durumda alışveriş yapmış olduğu üye iş yerinin web sitesi üzerinden "manuel ödeme bildirimi" yapması gerekmektedir.
  • Müşteri'nin üye iş yeri web sitesinde gerekli bildirimi yapmasını takiben, üye iş yeri ilgili parametrelerle Payguru platformunu müşterinin ödemesi için sorgular
  • Payguru sorgulama esnasında almış olduğu ödeme bilgilerini kendi sistemindeki ödeme bilgileri ile eşleştirir ve üye iş yerine ilgili ödemenin yapıldığı bildirimini iletir ve ödeme işlemini finalize eder.

Görüldüğü gibi üye iş yerinden iki adet müşteri arayüzü geliştirmesi beklenmektedir.

  1. Nakit Ödeme ve Para Transferi işlemi için yaratılacak olan İşlem Kodu nun müşteriyle paylaşılacağı arayüz.
  2. Müşteri'nin manuel ödeme bildirimi yapacağı arayüz.

Bunun dışında yukarıda özeti verilen ödeme sürecinde kullanılacak olan tüm API bileşenleri, ilgili başlıklar altında anlatılmış ve çeşitli platformlardaki kod parçaları ile örneklendirilmiştir.

1. Token

Üye iş yerinin Payguru platformuna ulaşımı ve ilgili sorgulama ve bildirimleri yapabilmesi için Payguru tarafından üye iş yerine özel olarak yaratılmış ve sınırlı süre boyunca geçerli olacak bilgi parçasıdır. Üye iş yerinin Payguru entegrasyonunun otantikasyon gerektiren tüm adımlarında kullanılır.

2. Notifications

Payguru Nakit Ödeme ve Banka Transfer hizmeti ile kabul edilen ödemelerin üye işyerine bildirimini sağlayan temel web hizmetleridir . Üye işyeri kendisine ait ödemeler ile ilgili tüm bilgilendirmeleri bu hizmetler üzerinden alır.

3. Transaction

Üye iş yerlerinin tek bir işlemi ya da belirli bir kritere uyan birden fazla işlemi Payguru Platformunda sorgulamasına olanak veren web servisleridir. Aynı servis grubu üye iş yerinin "sipariş tedarikini" takiben "işlem tamamlandı" bilgisini işlemesi için de kullanılır.

4. Bank

Payguru Platformuna entegre olan banka listesini ve ilgili hesap numaralarını dinamik olarak payguru sisteminden çeken, herhangi bir otantikasyon gerektirmeyen sorgulama servisidir.

5. Order Lookup

Üye iş yerinin işlemlerde kendi kodunu kullandığı durumlarda, ilgili kodun Payguru Platformunda İşlem Kodu olarak kullanılmasını sağlayan, ya da üye iş yerinin kendi sistemlerinde kullanmış olduğu sipariş kodu ile eşleşecek İşlem Kodu nun Payguru platfromunda yaratılması sürecini tetikleyen metodlardır. Söz konusu metodlar üye iş yerinin Payguru Platformunda kullanılan işlem kodu'nu kullanmak istemediği süreçlerde kullanılır.

6. Refund

Payguru Platformuna yapılmış olan ödemelerin yine Payguru Platformu aracılığı ile iade ve geri ödemelerini gerçekleştiren servislerdir. Payguru platformundaki tüm iade süreçleri, aşağıdaki API bileşenleri kullanılarak üye işyeri tarafından başlatılır ve tüm entegrasyonda İşlem Kodu ana taşıyıcı bilgi parçası olarak kullanılır.

7. Non-Automatic Order Matching Services

Payguru Platformlarında eşleşmeyen İşlem Koduna sahip ödemeler için, Payguru'nun üye iş yerine açmış olduğu "manuel ödeme bildirimi" süreçlerinin metodlarıdır. Üye iş yeri kendi sitesinde açmış olduğu arayüz aracılığı ile müşteri'den ödeme bilgisini toplar ve aşağıdaki bilgilendirmeler aracılığı ile Payguru Platformunu sorgular ve ödeme bilgisini iletir.

8. Status Code

Tüm notifikasyonlarda kullanılan "durum bilgisi" ilgili linklerde verilen tablolardaki kod eşleşmeleri aracılığı ile yapılır.