거래 상태
대시보드의 각 거래 행은 이 상태 중 하나를 가집니다. 상태는 그 거래의 가장 최근 이벤트를 반영합니다. 환불과 분쟁은 형제 행을 끼워 넣는 대신 기존 행을 업데이트합니다.
| 상태 | 의미 |
|---|---|
succeeded | 결제 완료. 돈이 당신의 계정에 있습니다(제공업체 수수료 차감 후). |
pending | 결제가 진행 중입니다. 확인이 몇 분에서 몇 시간 걸리는 비동기 결제 방식(ACH, 일부 암호화폐 수단)에서 흔합니다. |
failed | 결제가 완료되지 않음: 카드 거절, 만료된 승인, 강한 거부. 돈은 움직이지 않았습니다. |
partial | 구매자가 청구된 것보다 적게 냈습니다(암호화폐 구매자가 네트워크 수수료가 차감된 금액을 보낼 때 흔합니다). 행의 amount는 실제로 받은 것을 반영합니다. 요청된 것은 metadata.invoicedAmount를 확인하세요. |
refunded | 돈이 구매자에게 전부 또는 일부 반환되었습니다. 행의 amount는 환불된 금액입니다. 환불은 원래 결제 며칠 또는 몇 주 후에 일어날 수 있습니다. |
disputed | 구매자(또는 그들의 은행)가 분쟁이나 차지백을 제기했습니다. 대응 기한은 제공업체의 인터페이스를 확인하세요. 행의 metadata.reason은 제공업체의 분류를 그대로 실어 옵니다. |
pending_manual | 우편 결제 거래가 당신의 물리적 확인을 기다리고 있습니다. 다음 섹션을 참고하세요. |
manual_canceled | 구매자의 결제가 도착하기 전에 대기 중인 우편 결제 행에서 취소를 클릭했습니다. |
manual_expired | 대기 중인 우편 결제 행이 확인 없이 30일 동안 남아 자동 만료되었습니다. |
manual_revoked | 우편 결제 수령을 확인했지만 나중에 확인을 되돌렸습니다(예: 결제가 무효로 판명됨). 행이 succeeded에서 이 최종 상태로 되돌아갑니다. |
환불, 분쟁, 부분 결제
Coin Moebius는 이 제공업체 이벤트를 수신하고 대시보드의 원래 거래 행을 업데이트합니다. 구체적으로:
- 환불: Stripe의
charge.refunded이벤트(전체 또는 부분 환불, 부분 환불이 반환된 부분을 보여주도록amount_refunded포함). NOWPayments의refundedIPN. 행의 상태가refunded로 바뀌고,amount는 환불된 금액을 반영하며,metadata.originalChargeId/metadata.originalAmount가 원래 결제 맥락을 실어 옵니다. - 분쟁(차지백): Stripe의
charge.dispute.created이벤트. 행의 상태가disputed로 바뀝니다. 제공업체가 명시한 사유가metadata.reason으로 그대로 전달되며, 당신만의 UI에서 원하는 대로 렌더링할 수 있습니다. - 부분 결제: NOWPayments의
partially_paidIPN. 행의 상태가partial로 바뀝니다.amount는 실제로 받은 것(actually_paid)을 반영하고,metadata.invoicedAmount는 요청된 것입니다.
v1에서는 이 이벤트들이 대시보드와 /status 엔드포인트를 통해 노출됩니다. 향후 릴리스에서 당신만의 백엔드가 자동으로 반응할 수 있도록 이메일 알림과 아웃바운드 웹훅 포워더를 추가할 것입니다. 지금은 작은 폴링 작업을 설정하거나(다음 섹션 참고) 대시보드를 확인하세요.