35-iade-islemi.md

3.5. İade İşlemi

3.5.1. Genel Bakış

İade işlemi, ödeme işleminden sonraki günlerde tahsil edilen paranın müşteri hesabına geri iade edilmesidir.

3.5.2. İade İsteği Oluşturma

İade isteği, Paranoia\Request tipinde bir nesnenin sipariş numarası ile doldurulması suretiyle elde edilir.

$request = new \Paranoia\Request\Request();
$request->setOrderId('987654321');

3.5.3. İade İsteği Sırasında Beklenen Parametreler

Parametre	Tip	Zorunluluk	Açıklama
OrderId	String	Evet	Banka veya sizin tarafınızdan belirlenmiş olan sipariş numarası

3.5.4. İade İşleminin Gerçekleştirilmesi.

• İade işlemi için yeni bir iade isteği oluşturuyoruz.

$request = new \Paranoia\Request\Request();
$request->setOrderId('1234567890');

• Sağlayıcı API'sine bağlantı kurmak için gerekli konfigürasyon bilgilerini dolduruyoruz. Konfigürasyon parametreleri, ödeme sistemi sağlayıcısına göre değişkenlik göstermektedir. Ödeme sağlayıcılarına göre gerekli konfigürasyon tanımlamaları hakkında daha fazla bilgi edinmek için bu bölümü inceleyiniz.

$configuration = new \Paranoia\Configuration\NestPay();
$configuration->setClientId('123456789')
        ->setUsername('API_USERNAME')
        ->setPassword('API_PASSWORD')
        ->setMode('P');

• İade işlemini gerçekleştiriyoruz. Sağlayıcı uyarlamaları, Sağlayıcının 2. Desteklenen Ödeme Sistemleri dökümanında belirtilen ödeme sistemi nin adı ile adlandırılmışlardır. Örnekte belirtilen NestPay uyarlaması için \Paranoia\Pos*NestPay* sınıfını kullanabildiğiniz gibi Posnet uyarlaması için *\Paranoia\Pos*Posnet sınıfını kullanabilirsiniz.

try {
        $adapter = new \Paranoia\Pos\NestPay($configuration);
        $response = $adapter->cancel($request);
} catch(\Paranoia\Exception\CommunicationError $e) {
         // Bağlantı hatası durumunda yapılacak işlemleri
         // bu bölümde greçekleştirebilirsiniz.
} catch(\Exception $e) {
        // Uygulamada beklenmedik bir hata meydana gelmesi durumunda
        // yapılacak işlemleri bu bölümde gerçekleştirebilirsiniz.
}

if($response->isSuccess()) {
        // İade işlemi başarılı olduğu durumda yapılacak
        // işlemleri bu bölümde gerçekleştirebilirsiniz.
} else {
        // İade işlemi başarısız olduğu durumda yapılacak
        // işlemleri bu bölümde gerçekleştirebilirsiniz.
}

• İşlem başarısız olduğu durumda hatanın nedeni ve hata koduna ait bilgilere aşağıdaki gibi ulaşabilirsiniz.

$code = $response->getResponseCode();
$message = $response->getResponseMessage();

• 3. İşlemler sayfasına dön