İptal ve İade
Aynı gün işlemleri iptal edin; sonraki günlerde tutar belirterek iade yapın.
Genel Bakış
İptal yalnızca aynı gün içinde yapılan işlemler için geçerlidir. İade sonraki günlerde yapılır ve iade edilecek tutar amount ile gönderilir. Her iki işlem de aynı uca gider; fark type alanıdır.
İptal/iade işlemlerinde kullanılan sx İptal değeri, satış sx'inizden farklıdır — panelinizdeki Ayarlar bölümünden kontrol edin.
Uç NoktaPOST https://paynkolaytest.nkolayislem.com.tr/Vpos/v1/CancelRefundPayment
Gövdemultipart/form-data
Parametreler
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| sx | string | ✅ | İptal sx değeriniz (satış sx'inden farklıdır) |
| referenceCode | string | ✅ | İşlemin Paynkolay referansı (IKSIRPF… ile başlar) |
| type | string | ✅ | Aynı gün iptali için cancel, iade için refund |
| amount | decimal | ✅ | İşlem/iade tutarı (çekimde gönderilen formatta) |
| trxDate | string | ✅ | Ödemenin çekildiği tarih (yyyy.aa.gg) |
| hashDatav2 | string | ✅ | İmza — formül: sx|referenceCode|type|amount|trxDate|merchantSecretKey |
Dönen yanıtta responseCode = 2 ise işlem başarılıdır. Kısmi iade için amount alanına iade edilecek tutarı gönderin.
Örnek İstek ve Yanıt
curl -X POST "https://paynkolaytest.nkolayislem.com.tr/Vpos/v1/CancelRefundPayment" \
-F "sx=118591467|W8a1JLU8A5Cw…FbOO5A==|yDUZaCk6…" \
-F "referenceCode=IKSIRPF142277040" \
-F "type=refund" \
-F "amount=10.00" \
-F "trxDate=2026.09.03" \
-F "hashDatav2=lunnRyNfDu6pdpNjjlFrlATE4Pj…"{
"responseCode": 2, // 2 = işlem başarılı
"responseData": "…"
}Deneme Konsolu
Değerlerinizi girin: imza (hashDatav2) tarayıcınızda üretilir, kopyalanabilir cURL komutu hazırlanır; dilerseniz isteği doğrudan test ortamına gönderip yanıtı burada görün.
Hesaplama tamamen tarayıcınızda yapılır; "İsteği Gönder" yalnızca test ortamı ucuna çağrı yapar. Yine de canlı Secret Key'inizi yalnızca güvendiğiniz bir makinede girin.
Son güncelleme: 10 Eylül 2026