TahsilatE Logo
Geliştirici Ortamı

3D Ödeme İşlem Sorgulama

3D Ödeme İşlem Sorgulama Servisi İstek Modeli

MethodEndpointBody
GET/external/vpos/v1/payments/{transactionId}-

İstek Parametreleri

Parametre AdıTipZorunluAçıklama
transactionId
string (yol)
Evet
Sorgulanacak ödemenin işlem ID'si. Adreste yer alır; gövde gönderilmez.

Yanıt Parametreleri

Parametre AdıTipAçıklamaÖrnek Değer
message
string
İşlem sonuç mesajı
Örnek:"Ödeme durumu başarıyla getirildi"
"Ödeme durumu başarıyla getirildi"
content.transactionId
string
Ödeme işleminin benzersiz kimliği
Örnek:"2024_0_0"
"2024_0_0"
content.amount
number
Toplam ödeme tutarı
Örnek:2759.76
2759.76
content.netAmount
number
Net ödeme tutarı
Örnek:2621.77
2621.77
content.installment
number
Taksit sayısı
Örnek:1
1
content.status
string
Ödeme durumu (aşağıdaki tabloya bakın)
Örnek:"SUCCESSFUL"
"SUCCESSFUL"
content.createdAt
string
İşlem tarihi ve saati
Örnek:"2024-01-22T18:51:42.000Z"
"2024-01-22T18:51:42.000Z"
content.maskedCardNumber
string
Maskeli kart numarası (ilk 6 ve son 4 hane)
Örnek:"435508****4358"
"435508****4358"
content.bankName
string
Kartın bağlı olduğu banka
Örnek:"Akbank"
"Akbank"
content.cardProgramName
string
Kart programı adı
Örnek:"Axess"
"Axess"
content.resultMessage
string
İşlem sonuç mesajı
Örnek:"Success"
"Success"
content.campaign
string
Uygulanan kampanya (örn. +3 taksit), yoksa boş
Örnek:""
""
content.orderId
string | null
Ödeme sayfası (checkout) ile alındıysa siparişin numarası
Örnek:"WC-1001"
"WC-1001"
content.checkoutToken
string | null
Ödeme sayfası (checkout) ile alındıysa oturumun token'ı
Örnek:null
null
content.refund
object | null
İade yapıldıysa iadenin durumu (status), mesajı (message) ve tarihi (createdAt)
Örnek:null
null
content.customer
object
Ödeme isteğinde gönderdiğiniz müşteri bilgileri (API dışı ödemelerde yoktur)
Örnek:{ "name": "Ada", ... }
{ "name": "Ada", ... }
content.items
array
Ödeme isteğinde gönderdiğiniz sepet (API dışı ödemelerde yoktur)
Örnek:[{ "productId": "1", ... }]
[{ "productId": "1", ... }]

3D Ödeme İşlem Sorgulama Açıklaması

Bu endpoint, daha önce yapılmış bir ödemenin detaylarını ve durumunu sorgulamak için kullanılır. İşlem kimliği (transactionId) kullanılarak ödemenin güncel durumu ve detayları alınabilir. Yalnızca kendi üye işyerinize ait işlemler sorgulanabilir; bulunamayan işlemler için HTTP 404 döner.

Ödeme Durumları

DurumAnlamı
UN_COMPLETED
Kullanıcı henüz 3D doğrulamayı tamamlamadı.
PENDING
Banka sonucu henüz kesinleşmedi; bir süre sonra tekrar sorgulayın.
SUCCESSFUL
Ödeme başarılı, siparişi onaylayabilirsiniz.
FAILED
Ödeme başarısız.
REFUND_PENDING
İade bankaya iletildi, sonucu bekleniyor.
REFUNDED
Ödeme iade edildi.

Örnek Yanıt JSON

İşlem sorgulama sonucu dönen örnek response

1234567891011121314151617181920212223242526272829303132333435

İşlem Bulunamadığında

HTTP 404

1234
Ödeme sonuç kontrolü işlemini kesinlikle server to server olarak yapmanız gerekmektedir.