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.
| Durum | Anlamı | 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 |
EXCHANGING | Para 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.
| Durum | Anlamı | Önerilen işlem |
|---|---|---|
CREATED | Fatura oluşturuldu. Volet.com bu fatura için bir ödemeyi işlemeyi henüz bitirmedi. | Siparişi beklemede tutun. |
PROCESSING | Volet.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.
| Durum | Anlamı |
|---|---|
NEW | Fatura oluşturuldu, henüz ödeme alınmadı. |
RECEIVED | Fatura için bir blokzincir işlemi alındı. Kontroller hâlâ sürüyor olabilir, bu yüzden tutar henüz hesaba aktarılmadı. |
EXCHANGING | Volet.com alınan kriptoyu alıcının para birimine dönüştürüyor. |
COMPLETED | Fatura 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. |
CLOSED | Fatura 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üşterisenderAmountdeğerinden az gönderdi.OVERPAYMENT— müşterisenderAmountdeğ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.
İlgili sayfalar
- Hatalar — hata biçimi ve hataların ele alınması
- Ödeme kabulü için API entegrasyonu — ödeme akışının tamamı
- Toplu ödemeler için API entegrasyonu — toplu ödeme akışının tamamı