3D Ödeme İşlem Sorgulama
3D Ödeme İşlem Sorgulama Servisi İstek Modeli
| Method | Endpoint | Body |
|---|---|---|
| GET | /external/vpos/v1/payments/{transactionId} | - |
İstek Parametreleri
| Parametre Adı | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| transactionId | string (yol) | Evet | Sorgulanacak ödemenin işlem ID'si. Adreste yer alır; gövde gönderilmez. |
Yanıt Parametreleri
| Parametre Adı | Tip | Açı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ı
| Durum | Anlamı |
|---|---|
| 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.
