Ö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.

İsteğin gönderileceği URL ve metodu

Metot	URL	Açıklama
POST	{payment_intent_url}	Ödeme oturumu niyet bildirimi için kullanılır.

İstek Parametreleri ve Açıklamaları

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:

{
   "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
         }
      ]
   }
}

Önemli

• Loglar takip edilmek istenirse; MERCHANT_PAYMENT_INTENT ilgili loga bakılabilir.