Make Payment

URL

Fatura ödemek için kullanılan ilgili endpoint ve http metod bilgisi aşağıda verilmiştir.

NOT: Parçalı ödemeye izin verilen bir ürün ise istek alanında "payment_amount" değerine kısmi tutar, değilse direkt fatura tutarı girilmelidir.

("GetInvoicesByProductAndSubscriber" servis dönüşünde partial_payment_allowed = 1  ise parçalı ödemeye müsade eden bir  ürün demektir)

HTTP Method URL
POST /v1/InvoicePayment/MakePayment

İstek Parametreleri

Parametre Tip Zorunlu Açıklama
account_type_id int Evet Hesap Tipi (1:Bireysel , 2:İşletme)
account_number string Evet Hesap Numarası
wallet_number string Evet Cüzdan Numarası
inv_payment_transaction_query_oid string Evet Fatura İşlem Id'si (GetInvoicesByProductAndSubscriber Servisinden Gelir)
invoice_amount decimal Evet Fatura Tutarı (GetInvoicesByProductAndSubscriber Servisinden Gelir)
payment_amount decimal Evet Ödeme Tutarı
product_oid string Evet Kurum Id'si (GetInvoicesByProductAndSubscriber Servisinden Gelir)
subscriber_no string Evet Fatura tipine göre değişiklik gösterir (Örn: GSM , Sözleşme No , TCKN) GetInvoicesByProductAndSubscriber Servisinden Gelir
bill_term string Evet Fatura Tarihi (GetInvoicesByProductAndSubscriber Servisinden Gelir)
bill_no string Evet Fatura Numarası (GetInvoicesByProductAndSubscriber Servisinden Gelir)

Dönüş Parametreleri

Parametre Tip Açıklama
status int Statü
code string Kod
message string Mesaj
payload obje Veri
invoice_type string Fatura Tipi
inv_payment_transaction_query_oid string Fatura İşlem Id'si
receipt_output_print string
institution_name string Kurum Adı
payment_transaction_id string Ödeme İşlem Id'si
transaction_id string İşlem Id'si
transaction_amount decimal İşlem Tutarı
transaction_fee decimal İşlem Ücreti
charged_amount decimal Çekilen Tutar
ext_order_id string İşlem Numarası
business_code string İşletme Kodu
business_name string İşletme Adı
friendly_name string
receiver_account_number string Alıcı Hesap Numarası
receiver_wallet_number string Alıcı Cüzdan Numarası
sender_wallet_info obje Gönderici Cüzdan Detayı
id string Cüzdan Id
name string Cüzdan Adı
account_number string Hesap Numarası
account_type string Hesap Tipi
created_date_utc string Oluşturulma Tarihi
number string Cüzdan Numarası
phone_country_code string Ülke Telefon Kodu
phone_number string Telefon Numarası
email string E-Posta
total_balance decimal Toplam Bakiye
monthly_incoming_total decimal Aylık Hesaba Gelen Bakiye
monthly_outgoing_total decimal Aylık Hesaptan Giden Bakiye
access_level_status_id int Hesap Durumu Id
access_level_status string Hesap Durumu (Aktif/Pasif)
payment_balance obje Ödeme Bakiyesi
available decimal Ödeme Bakiyesi / Kullanıma Uygun Bakiye
unavailable decimal Ödeme Bakiyesi / Kullanıma Uygun Olmayan Bakiye
cash_balance obje Nakit Bakiye
available decimal Nakit Bakiye / Kullanıma Uygun Bakiye
unavailable decimal Nakit Bakiye / Kullanıma Uygun Olmayan Bakiye
transaction_limits obje İşlem Limitleri
max_balance decimal Maksimum Bakiye
topup_credit_limit decimal Kredi Kartıyla Para Yükleme Limiti
topup_cash_limit decimal Nakit Yüklenebilecek Bakiye Limiti
withdrawal_limit decimal Çekim Limiti
payment_limit decimal Ödeme Limiti
wallet_to_wallet_limit decimal Cüzdanlar Arası Yapılabilecek Transfer Limiti
kyc_level_status string KYC Seviyesi
currency_code string Para Birimi
user_kyc_info string KYC Detayı
is_topup_default boolean Para Yükleme Default mu ?
tax_number string Vergi Numarası
loyalty_record_required boolean

İSTEK (POST):

{
  "tenant_id": 0,
  "account_type_id": 1,
  "account_number": "28XX01",
  "wallet_number": "25XX25",
  "inv_payment_transaction_query_oid": "90XX46-FXX5-4XX3-8DXX-B1XX97",
  "invoice_amount": 196.50, 
  "payment_amount": 196.50, 
  "product_oid": "8064fb0c-c556-4104-8fe4-9779c6dc3721",
  "subscriber_no": "5536557580",
  "bill_term": "03/2023",
  "bill_no": "2023XXX887"
}

YANIT:

{
    "status": 0,
    "code": "100",
    "message": "İşlem başarılı",
    "payload": {
        "invoice_type": null,
        "inv_payment_transaction_query_oid": "90XX46-FXX5-4XX3-8DXX-B1XX97",
        "receipt_output_print": "termal",
        "institution_name": "Türk Telekom (Mobil)",
        "payment_transaction_id": "9623XX2189",
        "transaction_id": "ABRVXXX7304",
        "transaction_amount": 196.5000,
        "transaction_fee": 0.000000,
        "charged_amount": 196.500000,
        "ext_order_id": "90XX46-FXX5-4XX3-8DXX-B1XX97",
        "business_code": "",
        "business_name": "",
        "friendly_name": "",
        "receiver_account_number": "412XX50",
        "receiver_wallet_number": "126XX30",
        "sender_wallet_info": {
            "id": "45X9XX21",
            "name": "",
            "account_number": "28XX01",
            "account_type": "Personal",
            "created_date_utc": "2022-01-18T07:48:51.7092961+00:00",
            "number": "25XX25",
            "phone_country_code": null,
            "phone_number": null,
            "email": null,
            "total_balance": 899.47,
            "monthly_incoming_total": 0.0,
            "monthly_outgoing_total": 0.0,
            "access_level_status_id": 1,
            "access_level_status": "Aktif",
            "payment_balance": {
                "available": 0.0,
                "unavailable": 0.00
            },
            "cash_balance": {
                "available": 899.47,
                "unavailable": 0.00
            },
            "transaction_limits": {
                "max_balance": 1000000.0000,
                "topup_credit_limit": 996004.0060,
                "topup_cash_limit": 996004.0060,
                "withdrawal_limit": 1000000.0000,
                "payment_limit": 997238.4300,
                "wallet_to_wallet_limit": 999699.8000
            },
            "kyc_level_status": null,
            "currency_code": "TRY",
            "user_kyc_info": null,
            "is_topup_default": false,
            "tax_number": null,
            "loyalty_record_required": false
        }
    }
}