13. Test ve canlıya geçiş

13.1 Test senaryoları (hepsi partner-api.firsat.dev üzerinde)Başlık bağlantısını kopyala

Fırsat size test kimlik bilgileri, eşleştirme kodu olan bir test işletmesi ve test kuponları verir. Bunları dev@firsat.com adresinden isteyin. Test kuponları otomatik olarak sıfırlanmaz: tükendiklerinde aynı adresten yeni bir set isteyin.

Canlı erişim istemeden önce bunların hepsini geçin:

1. Token: token alın; süresi dolana kadar kullanın; yenileyin.
2. Claim: test eşleştirme kodunu claim edin; bağlantıyı ve şubeleri saklayın. Kullanılmış bir kodu deneyip 404 POS_PAIRING_CODE_INVALID alın. X-Firsat-Pos olmadan bir çağrı gönderip 400 POS_SOLUTION_HEADER_REQUIRED alın.
3. Normal akış: önizleme → satırları ve indirimi yazma → onay → "Fırsat" ile kapatma. Kupon satırları tam olarak saleUnit etmeli.
4. Eşlenmemiş satır: externalItemId değeri null olan bir satır fişe özel ürün olarak girer (POS'unuzda özel ürün yoksa 6.4'teki gibi durdurulur).
5. Kullanılmış kupon: tekrar önizleme yapın ve state: "used" alın; hiçbir şey yazılmaz.
6. Hatalı kod: kasiyere not_found metni gösterilir.
7. Onayda timeout: onayı gönderdikten sonra ağı kesin; aynı key ile tekrar deneyin ve aynı makbuzu alın. Kupon bir kez harcanır.
8. Süresi dolmuş önizleme: expiresAt geçene kadar bekleyin, onaylayın, 410 alın, satırları geri alın.
9. İki kasa, tek kupon: ikinci onay 409 POS_REDEMPTION_PREVIEW_USED alır ve o kasa satırlarını geri alır.
10. İptal edilmiş bağlantı: test bağlantısını biz iptal ederiz; POS'unuz iptal mesajını gösterir ve çağrıları durdurur.

13.2 Canlıya geçişBaşlık bağlantısını kopyala

1. Test sonuçlarınızı bize gönderin (senaryo numarası → redemptionId veya hatanın correlationId'si).
2. Fırsat partner-api.firsat.com için canlı kimlik bilgilerini verir. Bunlar test bilgilerinden farklıdır.
3. İlk canlı işletmeniz Fırsat Patron uygulamasından aldığı eşleştirme koduyla bağlanır.
4. Sorularınız için dev@firsat.com adresine yazın; isteğin correlationId'sini, kupon kullanımlarında da redemptionId'yi ekleyin.