Payment
POST https://uygulama.vomsis.com/api/vpos/v3/payment
Bu metod, kart bilgileri ile ödeme işlemini başlatmak için kullanılır. 3D Secure (securePayment: true) ile yapılan işlemlerde, cevap olarak bankanın 3D Secure sayfasına yönlendirme yapabilmek için gerekli bilgiler döner.
Headers
| Field | Type | Description |
|---|---|---|
Authorization | String | Zorunlu. authenticate metodundan alınan token. Bearer {access_token} formatında gönderilmelidir. |
Request Body
| Field | Type | Description |
|---|---|---|
referanceNo | String | Zorunlu. Benzersiz işlem ID'si. Bu değer Vomsis ve banka tarafında saklanır, sorgulama için kullanılabilir. |
creditCardHolderName | String | Zorunlu. Kartın ön yüzündeki ad soyad. |
creditCardPan | Integer | Zorunlu. Kart numarası. |
creditCardExpiryMonth | String | Zorunlu. Son kullanma ayı. Örnek: 06 |
creditCardExpiryYear | String | Zorunlu. Son kullanma yılı. Örnek: 2025 |
creditCardCvc | Integer | Zorunlu. Kartın arkasındaki güvenlik kodu. Örnek: 123 |
installment | Integer | Taksit sayısı. Belirtilmediğinde 1 (tek çekim) olarak kabul edilir. (Opsiyonel) |
installment_ratio | Integer | Vade oranı. bin-check servisinden dönen oranlar veya özel bir oran gönderilebilir. (Opsiyonel) |
amount | Float | Zorunlu. Çekim yapılacak tutar. Örnek: 100.00 |
currency | String | Para birimi. TRY, USD, GBP, EUR değerlerini alabilir. Varsayılan: TRY. (Opsiyonel) |
invoiceType | String | Fatura tipi. commercial veya individual değerlerini alabilir. (Opsiyonel) |
returnUrl | String | Zorunlu. Ödeme işlemi sonrası dönen sonucun uygulamanıza gönderileceği callback URL'idir. |
lang | String | tr, en değerlerini alabilir. (Opsiyonel) |
paymentNote | String | İşleme ait özel not. (Opsiyonel) |
user.title | String | Müşteri ünvanı. (Opsiyonel) |
user.name | String | Müşteri ad soyadı. (Opsiyonel) |
user.email | String | Müşteri e-posta adresi. (Opsiyonel) |
user.phone | String | Müşteri telefon numarası. (Opsiyonel) |
user.tax_office | String | Müşteri vergi dairesi. (Opsiyonel) |
user.tax_no | Integer | Müşteri vergi no / TCKN. (Opsiyonel) |
user.address | String | Müşteri adres bilgisi. (Opsiyonel) |
securePayment | Boolean | Zorunlu. İşlemin 3D Secure ile yapılıp yapılmayacağını belirtir. (true veya false) |
Response Parameters
3D Secure ile yapılan başarılı isteklerde, banka sayfasına yönlendirme için aşağıdaki parametreler döner.
Bilgi
Bankaya bağlı olarak response yapısı değişiklik gösterebilir. Aşağıdaki örnekler, en yaygın kullanılan yapıları temsil eder.
- Örnek 1
- Örnek 2
- Örnek 3
| Field | Type | Description |
|---|---|---|
gateway | String | 3D Secure işleminin başlatılması için yönlendirme yapılacak banka URL'i. |
inputs | Array | gateway adresine POST edilecek parametreleri ve değerleri içeren dizi. |
htmlContent | HTML | Sayfanıza eklendiğinde, formu otomatik olarak gateway adresine POST ederek 3D Secure ekranını açan hazır HTML içeriği. |
| Field | Type | Description |
|---|---|---|
status | Bool | İşlemin başarılı olup olmadığını belirtir (true = başarılı, false = hata). |
pos_type | String | Ödeme işlemini yöneten POS entegrasyon tipini belirtir (ör: vomsis_pos). |
data | HTML | Banka yönlendirme sayfasının HTML içeriği. Bu içerik otomatik form submit edilerek 3D Secure ekranına yönlendirir. |
| Field | Type | Description |
|---|---|---|
resultXml | XML | Bankadan dönen ham 3D Secure XML cevabı. |
result | Object | Bankadan gelen cevabın işlenmiş hali. İçinde Ok, Status, PaReq, ACSUrl, TermUrl, MerchantData gibi alanlar bulunur. |
formData | Object | 3D Secure yönlendirmesi için hazırlanmış veriler. İçinde gateway, inputs ve otomatik yönlendirme için htmlContent bulunur. |
UYARI
Bu yanıt, ödeme işleminin tamamlandığı anlamına gelmez. Müşterinin 3D Secure doğrulamasını tamamlaması gerekmektedir. Doğrulama sonrası, returnUrl adresine işlem sonucu gönderilir.