.. _PaymentIntentUrl:

Ödeme Oturumu Niyet Bildirimi
-----------------------------

    * Ödeme oturumu esnasında bu url oluşturulur ve ödeme işlemi başlamadan önce bilgi almak için ``payment_intent_url`` servisine istek gönderilir.
    * Bu parametre zorunlu değildir ve gönderilmezse akış normal devam eder.
    * Url için bir request hazırlanır(PaymentIntentRequest) ve bu request ``POST`` metodu ile ``payment_intent_url`` adresine gönderilir.
    * Dönen cevaptan ``2**`` harici bir cevap alındığında kullanıcıya hata mesajı gösterilir ve işlem sonlandırılır.
    * Ödeme oturumunun durumu ``PAYMENT_INTENT_FAILURE`` olarak güncellenir ve oturum sonlanır.

.. list-table:: İsteğin gönderileceği URL ve metodu
    :width: 600px
    :widths: 20 30 50
    :header-rows: 1

    * - Metot
      - URL
      - Açıklama
    * - POST
      - {payment_intent_url}
      - Ödeme oturumu niyet bildirimi için kullanılır.
    
.. list-table:: İstek Parametreleri ve Açıklamaları
    :width: 600px
    :widths: 25 15 60
    :header-rows: 1

    * - Parametre
      - Tip
      - Açıklama
    * - order_id
      - string
      - Sipariş numarası
    * - merchant_id
      - string
      - Üye iş yeri numarası
    * - akifast_user_id
      - string
      - Akifast kullanıcı numarası
    * - agreements
      - boolean
      - Sözleşmelerin kabul edilip edilmediği
    * - merchant_customer_id
      - string
      - Üye iş yeri müşteri numarası
    * - merchant_customer_phone_number
      - string
      - Üye iş yeri müşteri telefon numarası
    * - merchant_customer_email
      - string
      - Üye iş yeri müşteri email adresi
    * - basket_id
      - string
      - Sepet numarası
    * - conversation_id
      - string
      - Üye iş yeri tarafından gönderilecek iletişim numarası, bumerang değer
    * - transaction
      - object
      - İşlem bilgileri
    * - akifast_user
      - object
      - Akifast kullanıcı bilgileri
    * - shipping_address
      - object
      - Kargo adresi bilgileri
    * - billing_address
      - object
      - Fatura adresi bilgileri
    * - basket
      - object
      - Sepet bilgileri

**Örnek İstek:**

.. code-block:: json

    {
       "order_id":"202403207812457",
       "merchant_id":"9d36ec04-de2f-11ea-87d0-0242ac130003",
       "akifast_user_id":"EAF974A1D4CD420DA7B6317B6A89A2B4",
       "agreements":true,
       "merchant_customer_id":null,
       "merchant_customer_phone_number":null,
       "merchant_customer_email":null,
       "basket_id":"1676024164143",
       "conversation_id":null,
       "transaction":{
          "currency":"TRY",
          "order_amount":1.00,
          "shipping_amount":9.90,
          "shipping_option_key":"12"
       },
       "akifast_user":{
          "name":"G****",
          "surname":"A****",
          "gender":null,
          "email":"g****.a****@a****.com",
          "birth_date":null,
          "identity_number":null,
          "phone_number":"+905********",
          "phone":{
             "country_phone_code":"+90",
             "national_phone_number":"5************"
          },
          "akinon_user_id":"EAF974A1********************",
          "status":"ACTIVE",
          "verification_date":"2024-01-09T12:13:28.10+00:00",
          "email_verified":null
       },
       "shipping_address":{
          "name":"yeni adres test 2",
          "surname":"yeni adres test 2",
          "phone_number":"+902222222222",
          "postal_code":"",
          "notes":null,
          "company_name":null,
          "address_title":"yeni adres test 2",
          "tax_no":null,
          "tax_office":null,
          "is_default":true,
          "line":"yeni adres test 2",
          "address_type":"CUSTOMER",
          "country":{
             "name":"Türkiye",
             "code":"TR"
          },
          "city":{
             "name":"ARDAHAN",
             "code":"ARDAHAN"
          },
          "town":{
             "name":"DAMAL",
             "code":"ARDAHAN_DAMAL"
          },
          "district":{
             "name":"MUSTAFA KEMAL MAH",
             "code":"1****"
          },
          "status":"ACTIVE",
          "hash_data":"F6627D************************A48C",
          "phone":{
             "country_phone_code":"+90",
             "national_phone_number":"2222222222"
          }
       },
       "billing_address":{
          "name":"yeni adres test 2",
          "surname":"yeni adres test 2",
          "phone_number":"+902222222222",
          "postal_code":"",
          "notes":null,
          "company_name":null,
          "address_title":"yeni adres test 2",
          "tax_no":null,
          "tax_office":null,
          "is_default":true,
          "line":"yeni adres test 2",
          "address_type":"CUSTOMER",
          "country":{
             "name":"Türkiye",
             "code":"TR"
          },
          "city":{
             "name":"ARDAHAN",
             "code":"ARDAHAN"
          },
          "town":{
             "name":"DAMAL",
             "code":"ARDAHAN_DAMAL"
          },
          "district":{
             "name":"MUSTAFA KEMAL MAH",
             "code":"102****"
          },
          "status":"ACTIVE",
          "hash_data":"F6627D**********************4225DA48C",
          "phone":{
             "country_phone_code":"+90",
             "national_phone_number":"2222222222"
          }
       },
       "basket":{
          "basket_id":"167602****",
          "total_product_amount":1.00,
          "total_discount_amount":0.00,
          "total_amount":1.00,
          "currency":"TRY",
          "basket_items":[
             {
                "sku":"213f55b1-87cb-4cf2-a3a6-****",
                "base_code":"IPHONE-001",
                "basket_item_id":"1676024164143-3",
                "unit_price":1.00,
                "quantity":1,
                "price":1.00,
                "name":"Iphone 13 128 GB Red",
                "image_url":"https://cdn.dsmcdn.com/ty184/product/media/images/20210928/9/136956048/250485278/1/1_org_zoom.jpg",
                "is_reviewable":false
             },
             {
                "sku":"213f55b1-87cb-4cf2-a3a6-43aa37f0cccd",
                "base_code":"IPHONE-001",
                "basket_item_id":"1676024164143-4",
                "unit_price":0.00,
                "quantity":1,
                "price":0.00,
                "name":"İkincisi Bedava!",
                "image_url":"https://cdn.dsmcdn.com/ty184/product/media/images/20210928/9/136956048/250485278/1/1_org_zoom.jpg",
                "is_reviewable":false
             }
          ],
          "discounts":[
             {
                "description":null,
                "amount":0.00
             }
          ]
       }
    }

.. important::
    * Loglar takip edilmek istenirse; MERCHANT_PAYMENT_INTENT ilgili loga bakılabilir.