Satış (Sale)

Bu sayfada, VPOS üzerinden gerçekleştirilen satış (sale) işleminin API parametreleri, işlem akışı ve entegrasyon detayları açıklanmaktadır.

Satış (Provizyon) İşlemi Nedir?

Satış isteği, kartlı ödemelerde otorizasyon ve tahsilat sürecini tek adımda tamamlayan bir işlem türüdür. Bu işlem, provizyon (otorizasyon) süreci ile birlikte, ödemeyi hızlı ve güvenli şekilde sonuçlandırır.

1️. İşlem Akışı

1. Üye işyeri (merchant), müşterinin ödeme bilgilerini alır ve satış (sale) isteği gönderir.

2. İşlem, acquirer bankası üzerinden ilgili issuer bankaya iletilir.

3. Issuer banka, kartın geçerliliğini ve bakiyesini/limitini kontrol eder:

   • Kart geçerli ve bakiye yeterliyse:

     • İşlem onaylanır.

     • İşlem tutarı kart hesabından çekilir ve üye işyeri hesabına aktarılır.

   • Kart geçersiz veya bakiye yetersizse:

     • İşlem reddedilir ve hata mesajı ile bildirilir.

Bu akış sayesinde satış isteği tek adımda tamamlanır; ek 3D Secure doğrulaması veya ayrı provizyon/adım gerektirmez (Non-3DS senaryolarında özellikle).

2️. Onaylanan İşlem

• Onaylanan satış işlemi, üye işyeri hesabına açık satış (open sale) olarak aktarılır.

• Alışveriş anında işlem tamamlanmış olur; ek bir provizyon veya manuel tahsilat (capture) adımı gerekmez.

3️. Geliştirici Notları

• Satış isteği API çağrısında mutlaka:

  • Header parametreleri (x_client_token, x_signature, nonce, timestamp) doğru şekilde gönderilmelidir.

  • Request gövdesi (HTTP body) hatasız ve imzaya uygun şekilde hazırlanmalıdır.

• Response Kontrolleri:

• state → İşlemin başarılı olup olmadığını gösterir

• result → İşlem sonucunun detaylarını gösterir (tutar, işlem ID, ödeme durumu, vb.)

• resultCode → VPOS uygulaması işlem durum kodu, reddedilen işlemlerde hata kodu döner. resultMessage alanında mesaj detayları bulunmaktadır.

• procReturnCode → ISO-8583 formatında finansal işlem sonucu kodu döner. İşlem sonucu, issuer/acquirer banka tarafından belirlenir.