Kayıtlı Kart Tekrarlayan Ödeme

KAYITLI KART İLE TEKRARLAYAN ÖDEME ALMA (RECURRING PAYMENT)

Bu servisi kullanarak tekrarlayan ödeme için PAYTR’da kullanıcınıza ait kayıtlı bir kart ile dilediğiniz zaman veya aralıklarla ödeme alabilirsiniz.

1- Recurring Payment adımında belirtilen değerlerle birlikte ödeme istek bloğunu oluşturun. Ödeme işlemi, kendi oluşturacağınız yapı üzerinden, kayıtlı kart bilgileri ile servise göndereceğiniz istek sonucunda oluşacaktır. Bu sebepten dolayı kullanıcıyla etkileşime girecek form oluşturulmasına gerek bulunmamaktadır.

2- İşlemler Non3D (Non Secure) olarak gerçekleşecektir. Kullanıcınız herhangi bir ek işlem yapmayacak veya işlem sırasında kendisinden herhangi bir bilgi talep edilmeyecektir (Kullanabilmek için mağazanızda Non3D yetkilerinin açık olması gerekmektedir).

3- CAPI LIST servisinden, adına ödeme gerçekleştirilmek istenen kullanıcınıza ait utoken verisini kullanarak, ctoken verisine ulaşmanız gerekmektedir. Akabinde utoken, ctoken ve aşağıda ki tabloda belirtilen değerlerle birlikte https://www.paytr.com/odeme adresine POST metodu ile ödeme isteğinde bulunabilirsiniz.

POST REQUEST içeriğinde gönderilecek değerler:

Alan adı / tipi Açıklama Zorunlu Kısıtlar
merchant_id (integer) Mağaza no: PayTR tarafından size verilen Mağaza numarası Evet
paytr_token (string) paytr_token: İsteğin sizden geldiğine ve içeriğin değişmediğine emin olmamız için oluşturacağınız değerdir Evet Hesaplama ile ilgili olarak örnek kodlara bakmalısınız
user_ip (string) Müşteri ip: İstek anında aldığınız müşteri ip numarası (Önemli: Lokal makinenizde yapacağınız denemelerde mutlaka dış IP adresini gönderdiğinizden emin olun) Evet En fazla 39 karakter (ipv4)
merchant_oid (string) Mağaza sipariş no: Satış işlemi için belirlediğiniz benzersiz sipariş numarası. (Not: Sipariş no ödeme sonuç bildirimi esnasında geri dönen değerler arasındadır) Evet En fazla 64 karakter, Alfa numerik
email (string) Müşteri eposta adresi: Müşterinin sisteminizde kayıtlı olan veya form aracılığıyla aldığınız eposta adresi Evet En fazla 100 karakter
payment_type(string) Ödeme tipi Evet ('card')
payment_amount (double), ondalık olarak nokta (.) ve noktadan sonra iki hane Ödeme tutarı: Siparişe ait toplam ödeme tutarı Evet Örn: 100.99 veya 150 veya 1500.35
installment_count(int) Taksit sayısı Evet 0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12
card_type(string) Kart tipi (Taksitli işlemlerde kullanmak üzere) Hayır advantage, axess, combo, bonus, cardfinans, maximum, paraf, world
currency(string) Para birimi Hayır TL(veya TRY), EUR, USD (Boş ise TL kabul edilir)
client_lang(string) Ödeme sürecinde kullanılacak dil Hayır Türkçe için tr veya İngilizce için en (Boş gönderilirse tr geçerli olur)
test_mode Mağaza canlı modda iken test işlem yapmak için 1 olarak gönderilebilir Hayır 0 veya 1
non_3d Tekrarlayan ödeme için 1 gönderilmelidir Evet 0 veya 1
non3d_test_failed Non 3D işlemde, başarısız işlem durumunu test etmek için 1 gönderilir (test_mode ve non_3d değerleri 1 ise dikkate alınır!) Hayır 0 veya 1
merchant_ok_url(string) Müşterinin başarılı ödeme sonrası yönledirileceği sayfa (Örn.Siparişlerim takip sayfası)(Uyarı: Müşteri bu sayfaya ulaştığında henüz sipariş onaylanmış olmaz) Evet En fazla 400 karakter Uyarı: Tam URL olmalıdır
merchant_fail_url(string) Müşterinin ödemesi sırasında beklenmeyen bir hatada yönlendirileceği sayfa Evet En fazla 400 karakter Uyarı: Tam URL olmalıdır
user_name (string) Müşteri adı ve soyadı: Müşterinin sisteminizde kayıtlı olan veya form aracılığıyla aldığınız adı ve soyadı Evet En fazla 60 karakter
user_address (string) Müşteri adresi: Müşterinin sipariş sırasında ilettiği adresi Evet En fazla 400 karakter
user_phone (string) Müşteri telefon numarası: Müşterinin sipariş sırasında ilettiği telefon numarası Evet En fazla 20 karakter
user_basket (string) Sepet içeriği: Müşterinin siparişindeki ürün/hizmet bilgilerini içermelidir Evet JSON tipinde(Örnek kodları inceleyin)
debug_on (int) Hata döndür: PayTR’a yanlış veya eksik bilgi iletilmesi durumunda sistemden hata mesajı döndürülmesi için 1 gönderilmelidir Hayır 0 veya 1(Entegrasyon ve test sürecinde hataları tespit etmek için mutlaka 1
utoken(string) User Token: Sitenizdeki kullanıcıya özel PAYTR tarafından oluşturulmuş token. Bu token’ı sisteminizde işlemi yapan kullanıcıyla eşleştirmelisiniz Evet -
ctoken(string) Card Token: Kullanıcının kayıtlı kartını tanımlayan token Evet -
recurring_payment(int) Recurring: Ödeme isteğinin gönderilmesi ardından işlem sonucuna göre başarılı veya başarısız sayfasına yönlendirme yapılmadan, JSON formatında olan yanıt direkt olarak istek sonucuna döner. Ek olarak; işleme ait detaylar tanımlı olan Bildirim URL adresine gönderilir. Recurring sonucunda dönen status alanının alabileceği değerler “failed”, “wait_callback” ve “success” şeklindedir.Not: Bu işlem için mağazanızda Non3D yetkisinin açık olması gerekmektedir. Hayır 0 veya 1(İlgili yetkinin mağazaya tanımlanabilmesi için tarafımıza talep iletilmesi gerekmektedir Birimlerimizin onayından geçmesi halinden yetki mağazaya tanımlanacaktır.)


RECURRING YANITLARI

status msg (açıklama) try_again
failed “Kart banka tarafından kapatılmış. Bu kart ile tekrar işlem göndermeyin.”veya farklı bir hata mesajı. false
failed Henüz devam eden bir işleminiz bulunmaktadır, sonuçlandıktan sonra tekrar deneyebilirsiniz. true
wait_callback Ödeme Kontrol Ediliyor, Bildirimi Bekleyin -
success Ödeme Başarılı. -


<!doctype html>
<html>
    <head>
        <meta charset="UTF-8">
    </head>

    <?php

    ## Kullanıcının ödeme yaparken kayıtlı kartını kullanması için örnek kodlar ##

        $merchant_id = 'MAGAZA_NO';
        $merchant_key = 'XXXXXXXXXXX';
        $merchant_salt = 'YYYYYYYYYYY';

        $merchant_ok_url="http://site-ismi/basarili";
        $merchant_fail_url="http://site-ismi/basarisiz";

        $user_basket = htmlentities(json_encode(array(
            array("Altis Renkli Deniz Yatağı - Mavi", "18.00", 1),
            array("Pharmasol Güneş Kremi 50+ Yetişkin & Bepanthol Cilt Bakım Kremi", "33,25", 2),
            array("Bestway Çocuklar İçin Plaj Seti Beach Set ÇANTADA DENİZ TOPU-BOT-KOLLUK", "45,42", 1)
        )));

        srand(time(null));
        $merchant_oid = rand();

        $test_mode="0";

        //3d'siz işlem
        $non_3d="1";

        //non3d işlemde, başarısız işlemi test etmek için 1 gönderilir (test_mode ve non_3d değerleri 1 ise dikkate alınır!)
        $non3d_test_failed="0";

        if( isset( $_SERVER["HTTP_CLIENT_IP"] ) ) {
            $ip = $_SERVER["HTTP_CLIENT_IP"];
        } elseif( isset( $_SERVER["HTTP_X_FORWARDED_FOR"] ) ) {
            $ip = $_SERVER["HTTP_X_FORWARDED_FOR"];
        } else {
            $ip = $_SERVER["REMOTE_ADDR"];
        }

        $user_ip = $ip;

        $email = "testnon3d@paytr.com";

        // 100.99 TL ödeme
        $payment_amount = "100.99";
        $currency="TL";
        //
        $payment_type = "card";

        //      $card_type = "bonus";       // Alabileceği değerler; advantage, axess, bonus, cardfinans, maximum, paraf, world
        //      $installment_count = "5";

        $post_url = "https://www.paytr.com/odeme";

        $recurring_payment = "1";

        $hash_str = $merchant_id . $user_ip . $merchant_oid . $email . $payment_amount . $payment_type . $installment_count. $currency. $test_mode. $non_3d;
        $token = base64_encode(hash_hmac('sha256',$hash_str.$merchant_salt,$merchant_key,true));

        $utoken = "";
        $ctoken = "";       

    ?>

    <body>
        <form action="<?php echo $post_url;?>" method="post">
          <input type="hidden" name="merchant_id" value="<?php echo $merchant_id;?>">
          <input type="hidden" name="user_ip" value="<?php echo $user_ip;?>">
          <input type="hidden" name="merchant_oid" value="<?php echo $merchant_oid;?>">
          <input type="hidden" name="email" value="<?php echo $email;?>">
          <input type="hidden" name="payment_type" value="<?php echo $payment_type;?>">
          <input type="hidden" name="payment_amount" value="<?php echo $payment_amount;?>">
          <input type="hidden" name="installment_count" value="0">
          <input type="hidden" name="currency" value="<?php echo $currency;?>">
          <input type="hidden" name="test_mode" value="<?php echo $test_mode;?>">
          <input type="hidden" name="non_3d" value="<?php echo $non_3d;?>">
          <input type="hidden" name="merchant_ok_url" value="<?php echo $merchant_ok_url;?>">
          <input type="hidden" name="merchant_fail_url" value="<?php echo $merchant_fail_url;?>">
          <input type="hidden" name="user_name" value="Paytr Test">
          <input type="hidden" name="user_address" value="test test test">
          <input type="hidden" name="user_phone" value="05555555555">
          <input type="hidden" name="user_basket" value="<?php echo $user_basket; ?>">
          <input type="hidden" name="debug_on" value="1">
          <input type="hidden" name="paytr_token" value="<?php echo $token; ?>">
          <input type="hidden" name="non3d_test_failed" value="<?php echo $non3d_test_failed; ?>">
          <input type="hidden" name="installment_count" value="<?php echo $installment_count; ?>">
          <input type="hidden" name="card_type" value="<?php echo $card_type; ?>">
          <input type="hidden" name="utoken" value="<?php echo $utoken; ?>">
          <input type="hidden" name="ctoken" value="<?php echo $ctoken; ?>">
          <input type="hidden" name="recurring_payment" value="<?php echo $recurring_payment; ?>">
          <br />
          <input type="submit" value="Submit">
        </form>
    </body>
</html>

Recurring Payment Servisi örnek kodlarını indirmek için tıklayın.