Ödeme

Ödeme servisi, ödeme işlemlerinin API üzerinden güvenli ve standart bir şekilde gerçekleştirilmesini sağlar.

Önemli: Bu servisi kullanabilmek için geçerli bir API Key bilgisine sahip olmanız gerekir. API Key temini ve yetkilendirme süreci hakkında detaylı bilgi için “Nasıl Erişirim?” sayfasını inceleyebilirsiniz.

Servis Url Adresi:

https://api.postapos.com/v2/payment

Servis Açıklaması Bu endpoint, ödeme işlemlerinin Postapos API üzerinden başlatılmasını ve tamamlanmasını sağlar.

Ödeme isteğinin başarılı şekilde işlenebilmesi için, ödeme akışından önce installments servisinin çağrılması gerekmektedir. Bu servis sonucunda dönen ve seçilen taksit seçeneğine ait ins_id ve pos_id alanlarının, ödeme isteği ile birlikte iletilmesi zorunludur.

ins_id ve pos_id değerlerinin eksik, hatalı veya ödeme akışıyla uyumsuz şekilde gönderilmesi durumunda ödeme işlemi başarıyla tamamlanamayacaktır.

Önemli: Ödeme isteği başarılı şekilde işlendiğinde servis 200 OK yanıtı ile birlikte redirect_url alanını döner. İstemci uygulamanın, kullanıcıyı bu alanda dönen adrese yönlendirmesi gerekmektedir. Ödeme akışı, kullanıcının redirect_url üzerinden ilgili 3D Secure / ödeme sayfasına aktarılmasıyla devam eder.

Akış:

• İstek sonucunda HTTP durum kodu 200 OK dönerse, yanıt içindeki redirect_url değeri alınmalıdır.

• Kullanıcı, bu URL'e yönlendirilerek ödeme adımına geçirilmelidir.

• redirect_url alanı, ödeme işleminin 3D Secure doğrulama / ödeme ekranı başlangıç adresini ifade eder.

Servis Paremetreleri

Adı	Tipi	Zorunlu	Açıklama
ins_id	int	Evet	Seçilen taksit değerindeki ins_id değeri alınmalıdır
pos_id	text	Evet	Seçilen taksit değerindeki pos_id değeri alınmalıdır
binNumber	int	Evet	Kartın ilk 6 hanesi
cardHolderName	txt	Evet	Kart sahibi adı soyadı
cardNumber	int	Evet	Kredi kart numarası
expiryDate	txt	Evet	Son kullanım Tarihi (Format : 02/30)
cvv	int	Evet	Kartın güvenlik kodu
amount	decimal	Evet	Tutar (1500.00-1500.60) formatına uygun
commissionStatus	int	Evet	Komisyon hizmeti (1- hariç) / (2-dahil)
description	txt	Hayır	Açıklama/Not/Mesaj
ipAddress	txt	Evet	Ip adresiniz
return_url	txt	Evet	Sizin url adresiniz. Tarafınıza başarılı veya başarısız işlem durumu Post edilecektir

Request

{
    "ins_id" : "123497",
    "pos_id" : "CU04074*******",
    "binNumber" : "123456",
    "cardHolderName" : "Ayşe Yılmaz",
    "cardNumber" : "1234567890718006",
    "expiryDate" : "02/30",
    "cvv" : "123",
    "amount" : "1500.60",
    "commissionStatus" : 1,
    "description": "eticaret sanal pos ödeme",
    "ipAddress" : "192.168.2.1",
    "return_url": "https://example.com/12345/return"
}

Response

{
    "status": 200,
    "guid": "0AF94989-9E28-492F-A530-7FE7917A5B3C",
    "redirect_url": "/payment/3d/secure?tk=0AF94989-9E28-492F-A530-7FE7917A5B3C"
}

3D Sonucunda tarafında gönderilen post değerlerini kontrol etmek için Ödeme Sonuç sayfasına gidin. Tarafınıza sonuç bilgisi gönderilmesi zorunludur lütfen return_url bilginizi doğru ve eksiksiz gönderin.