Các trạng thái giao dịch
Mỗi hàng giao dịch trong bảng điều khiển có một trong các trạng thái này. Trạng thái phản ánh sự kiện gần nhất cho giao dịch đó; hoàn tiền và tranh chấp cập nhật hàng hiện có thay vì chèn một hàng anh em.
| Trạng thái | Ý nghĩa |
|---|---|
succeeded | Thanh toán đã hoàn tất. Tiền đã vào tài khoản của bạn (sau khi trừ phí nhà cung cấp). |
pending | Thanh toán đang trên đường. Thường gặp với các phương thức thanh toán bất đồng bộ (ACH, một số phương thức tiền điện tử) nơi việc xác nhận mất từ vài phút đến vài giờ. |
failed | Thanh toán không hoàn tất: thẻ bị từ chối, ủy quyền hết hạn, từ chối dứt khoát. Không có tiền nào di chuyển. |
partial | Người mua trả ít hơn số hóa đơn (thường gặp khi một người mua tiền điện tử gửi một khoản đã bị trừ phí mạng). amount của hàng phản ánh số thực sự nhận được; kiểm tra metadata.invoicedAmount để biết số được yêu cầu. |
refunded | Tiền đã được trả lại cho người mua, toàn bộ hoặc một phần. amount của hàng là số tiền được hoàn; hoàn tiền có thể xảy ra nhiều ngày hoặc nhiều tuần sau khoản thanh toán gốc. |
disputed | Người mua (hoặc ngân hàng của họ) đã mở một tranh chấp hoặc bồi hoàn. Kiểm tra giao diện của nhà cung cấp để biết thời hạn phản hồi. metadata.reason của hàng mang theo phân loại của nhà cung cấp nguyên văn. |
pending_manual | Một giao dịch thanh toán qua bưu điện đang chờ bạn xác nhận vật lý. Xem mục tiếp theo. |
manual_canceled | Bạn đã nhấp Hủy trên một hàng thanh toán qua bưu điện đang chờ trước khi khoản thanh toán của người mua đến. |
manual_expired | Một hàng thanh toán qua bưu điện đang chờ đã nằm 30 ngày mà không có xác nhận và tự hết hạn. |
manual_revoked | Bạn đã xác nhận đã nhận một khoản thanh toán qua bưu điện nhưng sau đó hủy xác nhận (ví dụ khoản thanh toán hóa ra không hợp lệ). Hàng chuyển từ succeeded trở lại trạng thái chấm dứt này. |
Hoàn tiền, tranh chấp, thanh toán một phần
Coin Moebius lắng nghe các sự kiện này của nhà cung cấp và cập nhật hàng giao dịch gốc trong bảng điều khiển. Cụ thể:
- Hoàn tiền: sự kiện
charge.refundedcủa Stripe (hoàn toàn bộ hoặc một phần, bao gồmamount_refundedđể hoàn tiền một phần hiển thị phần đã được trả lại). IPNrefundedcủa NOWPayments. Trạng thái của hàng chuyển thànhrefunded,amountphản ánh số tiền được hoàn, vàmetadata.originalChargeId/metadata.originalAmountmang theo ngữ cảnh khoản thanh toán gốc. - Tranh chấp (bồi hoàn): sự kiện
charge.dispute.createdcủa Stripe. Trạng thái của hàng chuyển thànhdisputed. Lý do mà nhà cung cấp nêu được truyền nguyên văn đếnmetadata.reason, bạn có thể hiển thị nó trong giao diện của riêng mình theo cách bạn chọn. - Thanh toán một phần: IPN
partially_paidcủa NOWPayments. Trạng thái của hàng chuyển thànhpartial.amountphản ánh số thực sự nhận được (actually_paid);metadata.invoicedAmountlà số được yêu cầu.
Trong v1, các sự kiện này được hiển thị trong bảng điều khiển và qua endpoint /status. Một bản phát hành tương lai sẽ thêm thông báo qua email và một bộ chuyển tiếp webhook đi ra để máy chủ của riêng bạn có thể phản ứng tự động. Hiện tại, hãy thiết lập một tác vụ truy vấn nhỏ (xem mục tiếp theo) hoặc kiểm tra bảng điều khiển.