Olaylar

Paymos 16 olay türü yayınlar: 8'i faturalar, 5'i çekimler, 3'ü ödeme kanalları için. Uç nokta düzeyinde kategoriye göre abone olun; bir kategori içindeki olay adları tek tek seçilemez.

Fatura olayları

Olay	Anlamı	Nihai
invoice.awaiting_payment	Derin bir reorg, sayılan tüm transferleri kaldırdı ve fatura ödeme bekler duruma geri döndü. Ödeme bekler durumuna ilk geçiş bu olayı yaymaz	Hayır
invoice.confirming	Bir ödeme algılandı ve gerekli blockchain kesinliği bekleniyor	Hayır
invoice.underpaid_waiting	Alınan tutar beklenen tutarın altında ve fatura hâlâ ödeme kabul edebilir	Hayır
invoice.paid	Beklenen tutar ödendi	Evet
invoice.paid_over	Beklenenden fazla ödendi; alınan tutarın tamamı hesaba geçer	Evet
invoice.underpaid	Fatura nihai eksik ödeme durumuna ulaştı	Evet
invoice.expired	Fatura, uygun bir ödeme alınmadan süresi doldu	Evet
invoice.cancelled	Satıcı faturayı iptal etti	Evet

Çekim olayları

Olay	Anlamı	Nihai
withdrawal.created	Çekim kabul edildi ve oluşturuldu	Hayır
withdrawal.processing	Giden işlem zincir üzerinde gözlemlendi ve işlem hash'i mevcut	Hayır
withdrawal.completed	Giden işlem zincir üzerinde tamamlandı	Evet
withdrawal.failed	Çekim başarısız oldu ve nihai duruma ulaştı	Evet
withdrawal.cancelled	Çekim tamamlanmadan önce iptal edildi	Evet

Ödeme kanalı olayları

Olay	Anlamı	Nihai
payment_channel.deposit.confirming	Kanal adresine bir transfer ulaştı ve gerekli blockchain kesinliğini bekliyor	Hayır
payment_channel.deposit.reorged	Zincirin yeniden düzenlenmesi (reorg) işlemi düşürdü. İşlem yeniden bir bloğa girerse aynı yatırma confirming durumuna döner	Hayır
payment_channel.deposit.confirmed	Yatırma kesinleşti, net tutar bakiyenize geçti	Evet

Başarısız olay yoktur: işlem bir daha bloğa girmezse yatırma reorged durumunda kalır ve başka olay gelmez.

İşleme kuralları

• Tam event_type değerine göre yönlendirin; bilinmeyen gelecek türleri güvenle yok sayın ve inceleme için uyarı verin.
• Durumu olay adından yeniden kurmak yerine yükteki data.status ve data.is_final değerlerini okuyun.
• Teslimat sırası varsaymayın. Paralel teslimat ve yeniden denemeler, daha yeni bir kaynak anlık görüntüsünün önce gelmesine yol açabilir.
• Nihai bir olay, o kaynağın durum makinesi için kesindir. Aynı event_id'nin tekrar teslimi yeni bir geçiş değil, yine de bir kopyadır.
• İş durumunda yinelenenleri data içindeki kaynak kimliğiyle ayıklayın (inv_…, wdr_…, pcd_…); bu kimlik her geçişte ve her uç noktada aynı kalır. event_id bir teslimatı tanımlar, bir ödemeyi değil.

Ortak zarf ve kaynak alanları için bkz. Yük sözleşmesi.