QR Oluştur

POST/partner/1.0/qr/create
Gerekli scope: payment:sale

Kurumsal tahsilat karekodu (QR) oluşturur. Partner yüzeyi her zaman CORPORATE_MONEY_TRANSFER üretir; bireysel karekod tipleri bu uçtan üretilemez.

amount ve geçerli bir currency zorunludur — kurumsal tahsilat karekodu tutarsız üretilemez.

Karekodla alınan para işletmenizin ana hesabına gider; işletmenizin aktif bir ana hesabı yoksa karekod üretilmez.

Örnek

curl -X POST https://<host>/partner/1.0/qr/create \
  -H "X-Api-Key: ..." \
  -H "X-Timestamp: ..." \
  -H "X-Signature: ..." \
  -H "Content-Type: application/json" \
  -d '{
  "amount": 100,
  "currency": "TRY",
  "description": "Tahsilat"
}'

İstek Body

AlanTipAçıklama
amountzorunludecimalTutar. 0'dan büyük olmalıdır.
currencyenumPara birimi.
Varsayılan: TRY
TRYUSDEURGBPJPYCHFRUBAZN
descriptionstringKarekod açıklaması.
typeenumGÖNDERMENİZE GEREK YOK — yok sayılır; sunucu CORPORATE_MONEY_TRANSFER olarak sabitler.
Varsayılan: CORPORATE_MONEY_TRANSFER
CORPORATE_MONEY_TRANSFER

Yanıt

AlanAnlamı
qrDataKarekoda basılacak veri. KPT öneki Kaptan karekodunu işaretler.
pinCodeKarekodun 6 haneli doğrulama kodu.
typeÜretilen karekod tipi — partner yüzeyinde her zaman CORPORATE_MONEY_TRANSFER.
expiryDateKarekodun geçerlilik sonu. Süresi dolan karekod çözülemez.
Örnek yanıt (content)
{
  "qrData": "KPT7F3QA9X",
  "pinCode": "482913",
  "type": "CORPORATE_MONEY_TRANSFER",
  "expiryDate": "2026-08-17T11:15:30.000Z"
}

Hatalar

Mesaj anahtarıHTTPNeden
amount.must.greater.than.0406amount eksik ya da 0'dan büyük değil.
currency.invalid400currency DEFAULT gönderildi; geçerli bir para birimi verin.
wallet.not.found.2406İşletmenizin ana hesabı yok.
wallet.account.not.active406İşletmenizin ana hesabı aktif değil.

İsteği Dene

İsteği Dene
Önizleme modu — değerler kod örneklerini günceller, gerçek istek atılmaz.
Mock