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?
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