Webhook Yönetimi

Banksocket webhook servisi ile ilgili hesapta bir hareket oluştuğunda sistem belirlediğiniz adrese hesap hareketinini içeren bir POST ile bildirir.

Webhook servisimiz ile banka hesaplarını belirli aralıklar ile sürekli dinlemek zorunda değilsiniz. Dilerseniz sadece para girişi, dilerseniz sadece para çıkışlarını dinleyebilirsiniz.

Örnek Webhook POST içeriği

dc: Credit
code: EFT
amount: 100.00
balance: 18100.00
currency: TRY
description: SN:276689 TEST BANKA HAREKETİ AÇIKLAMASI ARALIK/2019
account_id: 69
account: Kadıköy İşbank TL Hesabı
bank: Türkiye İş Bankası A.Ş.
opponent_id: 1234567890
opponent_iban: TR5600000111000022200023456
hash: NmYwMGMzMDM2ZjI1Njg5MmE3ODk5NzE4ZjEzMWI4NTg2MDRmZDA3MmYwN2Q1NjVmNDMwMjZmNmUzYmViNDEwOA==

Gönderilen POST içeriğinin Banksocket'ten geldiğinden emin olmak için hash parametresi hesabını doğrulayabilirsiniz. Apisecret değerini hesap ayarları API bölümünden edinebilirsiniz.

Örnek hash hesabı

base64(sha256(dc + code + amount + balance + currency + description + secret))

Webhook oluştur

POST https://api.banksocket.com/v1/webhooks

Sisteme yeni webhook görevi oluşturmak için kullanılır.

Headers

Name	Type	Description
Authentication	string	Kimlik denetimi başlığıdır.

Request Body

Name	Type	Description
title	string	Webhook adıdır.
endpoint	string	Yeni işlem olduğunda POST gönderilecek adrestir.
event	string	Görevin hangi işlemlerde tetikleneceğini belirtir. Tüm hareketler için NEW_TRANSACTION, sadece para çıkışı için NEW_DEBIT, yeni para girişi için NEW_CREDIT gönderilir.
account	string	Tüm hesaplar için all gönderiniz. Sadece bir hesap dinlemek için account_id değeri gönderiniz.

200

{
    "webhook": {
        "id": 1233,
        "endpoint": "http://test",
        "title": "TR işbank api test"
    }
}

Webhook sil

DELETE https://api.banksocket.com/v1/webhooks/:id

Path Parameters

Name	Type	Description
id	integer	Silinecek webhook görevinin ID değeridir.

Headers

Name	Type	Description
Authentication	string	Kimlik denetimi başlığıdır.

200

{
    "status" : "success"
}