Üye iş yerini bilgilendirme

Ödeme işlemi başarılı bir şekilde sonladığında üye iş yerine ödemenin içeriği ile ilgili bilgi geçilir. Ödeme oturumu oluşturma sırasında nereye bilginin gönderileceği notification_url de belirtilir. Aynı zamanda sistem belli zaman dilimlerinde bilgilendirme işlemi başarılı sonuç alana kadar istek göndermeye devam eder.

Önemli

  • Bilgilendirme işlemi senkron olarak gerçekleşir.

  • Üye iş yerinin sağladığı servisten cevap alınamazsa ilgili ödeme işlemi karantine statüsüne düşer.

  • Karantine statüsünde olan bu işlemlerin bildirimleri 10. denemede de yapılamazsa, sistem tarafından ilgili işlemin iptal/iadesi otomatik olarak gerçekleştirilir.

  • Ödemeyi başarıyla tamamlayan kullanıcının tarayıcısı, return_url alanında dönen URL’e yönlendirilir.

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

Metot

URL

Açıklama

POST

{notification_url}

Ödeme oturumu sırasında oluşturulan notification_url istekte bulunulur.

İstek Parametreleri ve Açıklamaları

Parametre

Tip

Açıklama

order_id

string

akinon da kayıtlı olan sipariş numarası.

is_successful

boolean

işlemin başarılı olduğunun bilgisini verir.

merchant_id

string

üye iş yerine ait akinon kimlik numarası.

akifast_user_id

string

Akifast kullanıcısının Akinon kimlik numarası.

transaction

obje

ödeme işlemi sırasında oluşturulan ödeme ye ait bilgilerin tutulduğu obje.

transaction.transaction_date

string

başarılı ödeme işleminin tutulduğu kayıtın tarihi.

transaction.is_preauth

boolean

başarılı ödeme işleminin ön otorizasyon bilgisi.

transaction.is_threed

boolean

başarılı ödeme işleminin 3D ödeme bilgisi.

transaction.currency

currency

ödeme para birimi.

transaction.order_amount

bigdecimal

siparişin tutarı.

transaction.total_paid_amount

bigdecimal

toplam ödenen tutar.

transaction.installment_count

long

taksit sayısı.

transaction.installment_amount

bigdecimal

taksit tutarı.

transaction.interest_rate

bigdecimal

faiz oranı.

transaction.interest_amount

bigdecimal

faiz tutarı.

transaction.shipping_amount

bigdecimal

siparişin kargo tutarı.

transaction.shipping_option_key

string

kargo seçeneğinin akinonda ki key karşılığı.

transaction.akipay_transaction_id

string

başarılı ödeme işleminin akinon kimliği.

transaction.payment_system_raw_response

string

ödeme sisteminden dönen ham cevap.

payment_info

object

başarılı ödeme işleminin geçtiği sistem bilgileri.

payment_info.payment_system_name

string

ödeme işleminin geçtiği sistemin ismi.

payment_info.payment_system_code

string

ödeme işleminin geçtiği sistemin kodu.

payment_info.payment_system_bank

string

ödeme işleminin geçtiği banka ismi.

payment_info.payment_system_eftcode

string

ödeme işleminin geçtiği bankanın eft kodu.

payment_info.pg_transaction_id

string

ödeme sistemindeki bilgilerin tutulduğu benzersiz kimlik numarası.

payment_info.pg_reference_id

string

ödeme sisteminin referans numarası.

payment_info.pg_auth_code

string

ödeme sisteminin authentication kodu.

payment_info.pg_settlement_number

string

ödeme sistemi gün sonu numarası.

payment_info.pg_order_id

string

pos sipariş numarası.

payment_info.pg_group_id

string

pos grup numarası.

payment_info.pg_proc_return_code

string

pos işlem dönüş kodu.

payment_info.pg_merchant_id

string

pos üye iş yeri idsi.

payment_info.pg_terminal_id

string

pos terminal idsi.

payment_info.pg_transaction_date

string

pos işlem tarihi.

payment_info.pg_system_error_message

string

pos sistem hata mesajı.

card_info[0].masked_card_number

string

başarılı ödeme işleminin geçildiği kartın maskeli numarası.

card_info[0].masked_card_holder_name

string

başarılı ödeme işleminin geçildiği kartın üzrindeki maskeli isim.

card_info[0].bin

string

başarılı ödeme işleminin geçildiği kartın bin numarası.

card_info[0].card_type

enum

başarılı ödeme işleminin geçildiği kartın tipi CardType .

card_info[0].card_brand

enum

başarılı ödeme işleminin geçildiği kartın markası CardBrand .

card_info[0].card_network

string

başarılı ödeme işleminin geçildiği kartın bağlı olduğu sistem.

card_info[0].issuer

string

ödeme işleminde kullanılan kartın bankası.

card_info[0].is_commercial

boolean

ödeme işleminde kullanılan kartın ticari bilgisi.

card_info[0].saved_card

boolean

ödeme işleminde kullanılan kartıl kaytılı kart bilgisi.

shipping_address

object

kargo adresi (Obje detayları kargo sorgulamadaki ile aynıdır.)

billing_address

object

fatura adresi (Obje detayları kargo sorgulamadaki ile aynıdır.)

akifast_user

object

akinon kullanıcısın’a ait bilgilerin dönüldüğü obje.

akifast_user.name

string

Akifast kullanıcısının ismi.

akifast_user.surname

string

Akifast kullanıcısının soyismi.

akifast_user.gender

string

Akifast kullanıcısının cinsiyeti.

akifast_user.email

string

Akifast kullanıcısının e-posta adresi

akifast_user.birth_date

date

Akifast kullanıcısının doğum tarihi.

akifast_user.identity_number

string

Akifast kullanıcısının kimlik numarası.

akifast_user.phone_number

string

Akifast kullanıcısının telefon numarası(ülke kodu + telefon numarası).

akifast_user.phone.country_phone_code

string

Akifast kullanıcısının telefon numarasının ülke kodu Örn: +90.

akifast_user.phone.national_phone_number

string

Akifast kullanıcısının telefon numarası Örn: 5554447788.

akifast_user.akinon_user_id

string

Akifast kullanıcısının Akinon kimlik numarası.

akifast_user.status

enum

Akifast kullanıcısının statüsü değerlerini içerebilir. UserStatus.

akifast_user.verification_date

date

Akifast kullanıcısının Akinon hesabını doğrulama tarihi.

akifast_user.email_verified

boolean

Akifast kullanıcısının emailinin doğrulandığının bilgisi.

agreements

boolean

sözleşme onay bilgisi.

merchant_customer_id

string

üye iş yerine ait kullanıcı kimlik numarası.

merchant_customer_phone_number

string

üye iş yerine ait kullanıcı telefon numarası.

merchant_customer_email

string

üye iş yerine ait kullanıcı email adresi.

basket_id

string

sepet kimlik numarası.

conversation_id

string

özel iletişim kimlik numarası.

Dönüş Değerleri ve Açıklamaları

Dönüş Değeri

Tip

Açıklama

status

string

notification status ünü belirtir.

return_url

string

üye iş yerinden dönen url.