Ana içeriğe geç

Durumlar

Merchant API üç durum kümesi kullanır: ödemeler, transferler ve diğer işlemler için işlem durumları; kripto faturalarla ödenen siparişler için ödeme durumları; ve bir kripto ödemeyi daha ayrıntılı açıklayan fatura durumları.

İşlem durumları​

İşlem sorgulama ve İşlem geçmişini sorgulama tarafından döndürülür.

DurumAnlamıNihai
CREATEDİşlem oluşturuldu.Hayır
READY_TO_PROCESSİşlem işlenmeye hazır.Hayır
PENDINGİşlem bir eylem veya kontrol bekliyor.Hayır
PROCESSINGİşlem işleniyor.Hayır
EXCHANGINGPara birimi dönüşümü sürüyor.Hayır
COMPLETEDİşlem tamamlandı.Evet
CANCELLINGİptal sürüyor.Hayır
CANCELEDİşlem iptal edildi.Evet
REFUNDINGİade sürüyor.Hayır
REFUNDEDİşlem iade edildi.Evet

Bir ödemeyi yalnızca durumu COMPLETED olduğunda tamamlanmış sayın. İşlemi nihai bir duruma ulaşana kadar izleyin.

Daha sonra iade yapılırsa nihai bir durum yine de değişebilir: bu durumda COMPLETED durumundaki işlem REFUNDING ve REFUNDED durumlarına geçer.

Ödeme durumları​

Ödeme siparişi sorgulama tarafından paymentStatus alanında döndürülür.

DurumAnlamıÖnerilen işlem
CREATEDFatura oluşturuldu. Volet.com bu fatura için bir ödemeyi işlemeyi henüz bitirmedi.Siparişi beklemede tutun.
PROCESSINGVolet.com ödemeyi işliyor.Siparişi beklemede tutun.
COMPLETEDÖdeme tamamlandı ve tutar hesabınıza aktarıldı. Nihai durum.Siparişi ödendi olarak işaretleyin ve teslim edin.
FAILEDÖdeme başarısız oldu veya işlemi iptal edildi. Nihai durum.Siparişi teslim etmeyin.

paymentStatus alanında iadeler için bir değer yoktur. İade, transaction.status ve invoice.invoiceStatus alanlarında görünür.

Faturanın süresi dolduğunda paymentStatus kendiliğinden FAILED olmaz: müşteri süre dolduktan sonra da ödeme gönderebilir.

Fatura durumları​

Ödeme siparişi sorgulama tarafından invoice.invoiceStatus alanında döndürülür. Bunları sorunlu bir ödemeyi açıklamak için kullanın; siparişin ödenip ödenmediğine karar vermek için kullanmayın.

DurumAnlamı
NEWFatura oluşturuldu, henüz ödeme alınmadı.
RECEIVEDFatura için bir blokzincir işlemi alındı. Kontroller hâlâ sürüyor olabilir, bu yüzden tutar henüz hesaba aktarılmadı.
EXCHANGINGVolet.com alınan kriptoyu alıcının para birimine dönüştürüyor.
COMPLETEDFatura işlendi ve tutar hesabınıza aktarıldı.
REFUND_CONFIRMATIONÖdemenin iadesi onay bekliyor.
REFUND_REQUESTEDİade talep edildi.
REFUNDEDÖdeme müşteriye iade edildi.
CLOSEDFatura kapatıldı.

invoice.penalties, alınan ödemenin faturadan nasıl farklı olduğunu gösterir. Ödeme faturayla eşleşiyorsa liste boştur:

  • UNDERPAYMENT — müşteri senderAmount değerinden az gönderdi.
  • OVERPAYMENT — müşteri senderAmount değerinden fazla gönderdi. İzin verilen tolerans içindeki küçük bir fazla ödeme işaretlenmez.
  • EXPIRED — ödeme, faturanın süresi dolduktan sonra geldi. Böyle bir ödeme otomatik olarak hesaba aktarılmaz.

invoice.externalStatus, invoiceStatus ve penalties değerlerini tek bir değerde birleştirir; örneğin UNDERPAYMENT_RECEIVED veya EXPIRED_PAYMENT_REFUNDED. PAYMENT_RECEIVED, tutarın hesaba aktarıldığı anlamına gelmez. externalStatus değerini yalnızca görüntüleme için kullanın.