Ödemeler

Webhooklar aracılığıyla, ödeme işlemlerini sunucunuza nasıl alacağınızı öğrenin

Bu webhook hizmeti, tek seferlik ve aboneliğe dayalı ödemeler de dahil olmak üzere her türlü başarılı ödeme işlemi hakkında sizi bilgilendirir.

Endpoint URL'inizi Ayarlayın

Webhook bildirimleri sunucunuza HTTP POST aracılığıyla gönderilir. Endpoint URL'sini projenizin altındaki Developer Tools / Webhooks menüsünden yapılandırabilirsiniz.

Webhook Bildirimlerinin Formatı

Webhook bildirimleri JSON formatında düzenlenir. Sunucunuza gönderilen POST isteğinin içeriği, düzenlenmiş bildirimin bilgilerini içerir.

{
  "queue" : {
    "type" : "TransactionInsert",
    "createDate" : "2020-03-20 12:35:41",
    "appId" : "1"
  },
  "parameters" : {
    "credit_card" : "41111111******1111",
    "status" : "start_paid",
    "refund_price" : null,
    "country" : "TR",
    "transaction_id" : "f5e58d26-ce4e-4e8c-bbc4-0b250d0ed396",
    "provider_transaction_id" : "20225RBnF07028494",
    "currency" : "TRY",
    "provider_name" : "İş Bankası (Payten)",
    "create_date" : "2020-08-12 14:01:40",
    "subscriber_id" : "1",
    "custom_parameters" : {
      "country" : "RU",
      "adjust" : {
        "idfa" : "A16122492-7DC3-4B15-B14C-33453995AFCC"
      },
      "source" : "Landing"
    },
    "original_purchase_date" : "2020-08-12 14:01:40",
    "app_id" : 5,
    "package_id" : "package",
    "expire_date" : "2020-09-11 14:01:40",
    "provider_status" : "Approved",
    "id" : "1740",
    "purchase_date" : "2020-08-12 14:01:40",
    "payment_type" : "subscription",
    "quantity" : 1,
    "refund_date" : null,
    "original_transaction_id" : "f5e58d26-ce4e-4e8c-bbc4-0b250d0ed396",
    "provider_id" : 8,
    "package_price" : 1,
    "is_refund" : "0",
    "price" : 1,
    "comment" : null,
    "refund_reason" : null,
    "team_id" : 5
  }
}

Parametreler

queue	Webhook türü ve tarihi ile ilgili bilgiler yer alır.
parameters	Webhook'a ait bilginin detayları yer alır.
status	İşleme ait durum değeridir. trial : Kullanıcı deneme süresindedir. trial_to_paid : Deneme süresinin bittiğini ve asıl fiyat ile ödeme işleminin gerçekleştiğini belirtir. renewal : Aboneye ait yenileme işlemi. reactive : Hesabı pasif olan bir kullanıcının ödeme yaparak hesabını aktif duruma getirdiği durumlarda gönderilir. consumable : Tek seferlik paket satın alındığında gönderilir. start_paid : Ücretli olarak yeni bir abonelik başlatıldığında gönderilir.
transaction_id	Satın alma işlemine ait uniq id değeridir. İade işlemlerinde bu bilgi kullanılmaktadır.
package_id	Satın alma işleminin yapıldığı pakettir.
credit_card	İşlemde kullanılan kredi kartıdır.
provider_name	İşlemin gerçekleştiği provider bilgisidir.
provider_transaction_id	Satın almanın ilgili provider üzerindeki id'sidir.
currency	Satın alma para birimidir.
create_date	Satın almanın Zotlo veritabanlarına kayıt tarihidir.
subscriber_id	Ödeme işleminin gerçekleştiği abone id'dir.
custom_parameters	Aboneye ait özel parametreler var ise bu parametrede gönderilmektedir.
original_purchase_date	Aboneye ait aboneliğin başladığı ilk tarih değeridir.
expire_date	Eğer abonelik ile ilgili bir satın alma ise ilgili satırın son geçerlilik tarihidir.
purchase_date	İşlem gerçekleşme tarihidir.
payment_type	Ödeme türüdür. subscription ,consumable parametrelerinden birini alabilir. subscription ise abonelik ile ilgili ödeme, consumable ise de tek seferlik ödeme ile ilgili işlemdir.
quantity	İlgili satırdaki paketten kaç adet alındığıdır.
price	İşleme ait toplam tutardır.
package_price	Satın alınan paketin fiyatıdır.