İptal ve İade
Genel Bakış
iyzico üzerinden yapılan bir ödeme 365 gün içerisinde 7/24 iade edilebilmektedir.
Bu işlemleri iki başlık altında toplayarak maddeleyelim.
İade işleminin ekstreye yansıtılacağını unutmamakla birlikte, iadenin karta yansıma süresi ilgili bankaya göre değişebilmekte ve genellikle birkaç gün sürmektedir.
Bankaların çoğu, ödemenin kredi kartı ekstresinde görünmeyeceği durumlarda (bankalar kendi mutabakatlarını gerçekleştirmeden önce) ödemenin alındığı gün içinde herhangi bir ödemeyi iptal edebilmektedir.
Ödeme işleminin iadesi için kullanılır. İade işlemi paymentTransactionId üzerinden, ödeme kırılımı baz alınarak yapılır. Ödeme tutarı için tamamen ya da kısmi iade yapılabilir.
Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.
IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
İstek içeriğinin formatı.
application/json
İade edilecek ödeme kırılımı numarası (paymentTransactionId).
27169345
İstek/yanıt eşleştirmesi için uniq ID.
123456789
İşlemin gönderildiği IP adresi.
1.1.1.1
Yanıt dili.
tr
Possible values: İade edilmek istenen tutar. Kırılım tutarından yüksek olmamalıdır.
5
Ödemenin yapıldığı para birimi.
TRY
Başarılı yanıt
Başarısız yanıt
POST https://api.iyzipay.com/payment/refund
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json
{
"locale": "tr",
"conversationId": "conversationId",
"paymentTransactionId": "27169345",
"price": 5,
"ip": "85.34.78.112",
"currency": "TRY"
}
{
"status": "success",
"locale": "tr",
"systemTime": 1755703798426,
"conversationId": "conversationId",
"paymentId": "25180188",
"paymentTransactionId": "27169345",
"price": 5,
"currency": "TRY",
"authCode": "512821",
"hostReference": "mock00007iyzihostrfn",
"refundHostReference": "mock00007iyzihostrfn",
"retryable": false,
"signature": "269ce670ac4027fc95644812d38bc1c3c3897848573215c5bf03e8dd86b328fd"
}
Örnek Kodlar
paymentId üzerinden iade yapılmasını sağlar. Ödeme kırılımı belirtilmez; iade edilecek kırılım sistem tarafından otomatik belirlenir. Ödeme tutarı için tamamen ya da kısmi iade yapılabilir.
Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.
IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
İstek içeriğinin formatı.
application/json
İade edilecek ödeme numarası.
25180208
İstek/yanıt eşleştirmesi için uniq ID.
123456789
İşlemin gönderildiği IP adresi.
1.1.1.1
Yanıt dili.
tr
Possible values: İade edilmek istenen tutar. Ödeme tutarından büyük olmamalıdır.
5
Ödemenin yapıldığı para birimi.
TRY
Başarılı yanıt
Başarısız yanıt
POST https://api.iyzipay.com/v2/payment/refund
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json
{
"locale": "tr",
"conversationId": "123456789",
"price": 15,
"paymentId": "25180208",
"currency": "TRY",
"ip": "1.1.1.1"
}
{
"status": "success",
"locale": "tr",
"systemTime": 1755704177107,
"conversationId": "123456789",
"paymentId": "25180208",
"price": 15,
"currency": "TRY",
"authCode": "581421",
"hostReference": "mock00007iyzihostrfn",
"refundHostReference": "mock00007iyzihostrfn",
"retryable": false,
"signature": "429ba48e9eef33c89cc942e626c8f4aa4a4784fdc82df64f252caa5ad6233db9"
}
Örnek Kodlar
Ödeme işlemini iptal etmek için kullanılır.
Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.
IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
İstek içeriğinin formatı.
application/json
İptal edilmek istenen ödeme işlemine ait iyzico tarafından verilen uniq ödeme numarası.
25180158
İstek/yanıt eşleştirmesi için uniq ID. İstekte gönderilen değer yanıtta aynen geri döner.
123456789
İşlemin gönderildiği IP adresi.
1.1.1.1
iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır.
tr
Possible values: Başarılı yanıt
Başarısız yanıt
POST https://api.iyzipay.com/payment/cancel
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json
{
"locale": "tr",
"conversationId": "123456789",
"paymentId": "24511629",
"ip": "1.1.1.1"
}
{
"status": "success",
"locale": "tr",
"systemTime": 1755703480229,
"conversationId": "123456789",
"paymentId": "25180158",
"price": 50,
"currency": "TRY",
"authCode": "532238",
"hostReference": "mock00007iyzihostrfn",
"cancelHostReference": "mock00007iyzihostrfn"
}
Örnek Kodlar
Last updated