iyzico hesabına iade

iyzico hesabına iade servisi, müşterilerinizin iyzico hesaplarına anlık iade yapma olanağı sağlar. İade işlemi banka süreçlerinden bağımsız olduğundan üye işyerinin onayı alınır alınmaz hesaba para aktarımı gerçekleşir.

Bu süreç nasıl başlatılır?

  • Müşteriniz websitenizden iade işlemi yaparken "iyzico hesabıma iade et" seçeneğini seçer. Bu işlem için müşterinize göstereceğiniz link veya button iyzico servisinden bir istekle alınır.
  • Linke tıklayan müşteri, iyzico sayfasına yönlendirilir ve telefon/email ile iyzico sistemine kayıt olur veya giriş yapar. Müşteri telefonuna gönderilen sms kodunu giriş esnasında kullanmak zorundadır.
  • İadenin iyzico hesabına yapılmasını onaylayan müşteri, istek sırasında belirttiğiniz callbackUrl adresine yönlendirilir.
  • Üye işyeri iade onayı verdiği anda müşterinin iyzico hesabına para transferi gerçekleşir.

Servise gönderilmesi gereken parametreler şu şekildedir:

Parametre ismi Tip Zorunluluk Açıklama
locale string hayır iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri tr’dir.
conversationId string hayır İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi yapmak için kullanılabilir.
paymentId string evet iyzico tarafında yapılmış ödeme işleminin benzersiz ödeme numarası.
callbackUrl string evet Müşterinin işlem sonucu yönlendirileceği ve notifikasyon gönderilecek URL

Servisten dönen parametreler şu şekildedir:

Parametre ismi Tip Açıklama
token string iyzico hesabına iade işlemi için oluşturulan eşsiz değer. Yönlendirilme sırasında callBackUrl'e de bu değer gönderilir
url string Müşterinin iyzico hesabına iade sürecini tamamlayabilmesi için yönlendirilmesi gereken link
status string Yapılan isteğin sonucunu bildirir. İşlem başarılı ise success, hatalı ise failure döner.
errorCode string İşlem hatalıysa, bu hataya dair belirtilen koddur.
errorMessage string İşlem hatalıysa, bu hataya dair belirtilen mesajdır. Locale parametresine göre dil desteği sunar.
errorGroup string İşlem hatalıysa, bu hataya dair belirtilen gruptur.
locale string İstekte belirtilen locale değeri geri dönülür, varsayılan değeri tr’dir.
systemTime integer Dönen sonucun o anki unix timestamp değeridir.
conversationId string İstek esnasında gönderilmişse, sonuçta aynen geri iletilir.

$request = new \Iyzipay\Request\CreateRefundToBalanceRequest();
$request->setPaymentId("11654127");
$request->setCallbackUrl("https://www.callback");

$refundToBalance = \Iyzipay\Model\RefundToBalance::create($request, Config::options());
request = {
    locale: Iyzipay::Model::Locale::TR,
    conversationId: '123456789',
    paymentId: '11661247',
    callbackUrl: 'https://merchanturl.com'
}
    refundToBalance = Iyzipay::Model::RefundToBalance.new.create(request, @options)
//Request
{
    "locale": "tr",
    "conversationId": "123456",    
    "paymentId": "11661247",
    "callbackUrl": "https://merchanturl.com"
}

//Response
{
    "status": "success",
    "locale": "tr",
    "systemTime": 1470730913791,
    "conversationId": "123456",
    "token": "1xxyyzzqq345",
    "url": "https://sandbox-consumer.iyzico.com/xyz"
}

Örnek Kodlar