Cüzdan Ödemeleri

Güncel public cüzdan API'si /payment/v1/wallet ana yolunu kullanır.

Cüzdan Ödemesi Başlatma

Header'da merchantId ile POST /payment/v1/wallet/init çağrılır. Gövde, Payments bölümünde açıklanan güncel CreatePaymentRequest sözleşmesini kullanır. walletIntegratorType alanı yapılandırılmış entegrasyona göre ODERO_PAY, GARANTI_PAY, OLIZ_PAY veya ABB_PAY olabilir. Başarılı istek 201 Created döner.

Yanıt id, source, timestamp, resultCode, resultMessage, errors ve response alanlarını içerir. Hata öğeleri code, type ve message; response verisi orderId, status, redirectUrl ve qrText içerir.

Tamamlama Callback'leri

  • POST /payment/v1/wallet/complete/garantipay: gövde alanları orderId ve signMessage'tır; standart wrapper içinde OK döner.
  • POST /payment/v1/wallet/complete/abb-pay: gövde alanları orderId, externalId ve status'tur; standart wrapper içinde OK döner.

Bu tamamlama endpointleri ödeme sağlayıcısı callback'leridir ve güncel controller'da merchant header istemez.

Ödeme Durumu Sorgulama

Header'da merchantId ile GET /payment/v1/wallet/status/{orderId} çağrılır. Yanıt ödeme durumunu içerir. Merchant uyuşmazlığında 404 kodlu wrapped hata döner.

GarantiPay Taksit Seçenekleri

GarantiPay taksit seçenekleri request sözleşmesiyle POST /payment/v1/wallet/garantipay/v0/options çağrılır. Sağlayıcı yanıtı standart API wrapper'ında döner.

Güncel kaynakta aktif public cüzdan iptal veya iade endpointi yoktur; ilgili metotlar yorum satırında olduğundan çağrılabilir API olarak dokümante edilmemiştir.