Cari hesap entegrasyonu ile bayileriniz PayPortal üzerinden işlem yaptıklarında cari hesap bilgilerini (borç/alacak) ve kur bilgilerini görebilir.
Aşağıdaki formatta hazırlayacağınız bir REST servis ile PayPortal sisteminize bağlanıp bayilerinizin cari hesap bilgilerini çeker.
PayPortal sizin sisteminize bağlanıp bilgileri çekeceği için; sizin sisteminizde oluşacak problemlerden etkilenmemek için "Circuit Braker" design yöntemi ile çalışır.
Parametre İsmi | Tip | Zorunlu | Açıklama |
company_code | string | | Paynet ana firma kodu |
agent_id | string | | Paynet bayi kodu |
reference_no | string | | Bayinin referans numarası |
Parametre İsmi | Tip | Açıklama |
note | string | Ekranda servisle ilgili gösterimde gösterilmesi gereken not bilgisi var ise bu parametre ile gönderilebilir. |
accounts | string | Bayiye ait hesap tutarı |
show_accounts | boolean | Hesap ile ilgili bilgilerin ekranda gösterilip gösterilmeyeceğine dair boolean değer. |
first_column_title | string | İlk sütunda dönülecek sayısal değerlerin başlığı |
second_column_title | string | İkinci sütunda dönülecek sayısal değerlerin başlığı |
accounts.items | dizi | Bayinin belli bir para birimine göre hesap bilgilerinin listesidir. |
currency | string | TRY,USD,EUR değerlerini alabilir. |
first_column_value | decimal | Ekranda ilk başlık altında gösterilmek istenen sayısal değer |
second_column_value | decimal | Ekranda ikinci başlık altında gösterilmek istenen sayısal değer |
currencies | string | Ekranda değerleri gösterilmek istenen ve Paynet içinde hesaplamalarda kullanılmak üzere kur oranlarını dönen parametre |
show_currencies | boolean | Kur oranlarının ekranda görünüp görünmeyeceğini belirtir.True/false |
show_currency_selection | boolean | Kur seçiminin ekranda görünüp görünmeyeceğini belirtir. |
exchange_rate | decimal | Kur oranı |
is_default | boolean | Kurun varsayılan olup olmadığını belirtir. |
{"agent_id":"53983","company_code":"1000","reference_no":"12471"}
{"note":"*Vadesi Dolan Borç","accounts":{"show_accounts":true,"first_column_title":"Bakiye","second_column_title":"*V.D. Borç","items":[{"currency":"TRY","first_column_value":94793.81,"second_column_value":10336.78},{"currency":"EUR","first_column_value":0,"second_column_value":0},{"currency":"USD","first_column_value":4629.3,"second_column_value":2777.58}]},"currencies":{"show_currencies":true,"show_currency_selection":true,"items":[{"currency":"USD","exchange_rate":5.9999,"is_default":false},{"currency":"EUR","exchange_rate":8,"is_default":false},{"currency":"TRY","exchange_rate":1,"is_default":true}]}}
Dikkat edilmesi gereken hususlar:
Başarısız olunan durumlarda Http status code 200 dışında herhangi bir parameter kodu ile dönülmeli( 500 gibi ).
Servis istekleri maximum 10 saniyede data dönmeli.