QR Oluştur
POST
/partner/1.0/qr/createGerekli scope:
payment:saleKurumsal 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
| Alan | Tip | Açıklama |
|---|---|---|
amountzorunlu | decimal | Tutar. 0'dan büyük olmalıdır. |
currency | enum | Para birimi. Varsayılan: TRYTRYUSDEURGBPJPYCHFRUBAZN |
description | string | Karekod açıklaması. |
type | enum | GÖNDERMENİZE GEREK YOK — yok sayılır; sunucu CORPORATE_MONEY_TRANSFER olarak sabitler. Varsayılan: CORPORATE_MONEY_TRANSFERCORPORATE_MONEY_TRANSFER |
Yanıt
| Alan | Anlamı |
|---|---|
qrData | Karekoda basılacak veri. KPT öneki Kaptan karekodunu işaretler. |
pinCode | Karekodun 6 haneli doğrulama kodu. |
type | Üretilen karekod tipi — partner yüzeyinde her zaman CORPORATE_MONEY_TRANSFER. |
expiryDate | Karekodun 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ı | HTTP | Neden |
|---|---|---|
amount.must.greater.than.0 | 406 | amount eksik ya da 0'dan büyük değil. |
currency.invalid | 400 | currency DEFAULT gönderildi; geçerli bir para birimi verin. |
wallet.not.found.2 | 406 | İşletmenizin ana hesabı yok. |
wallet.account.not.active | 406 | İş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.