取引ステータス
ダッシュボードの各取引行は、これらのステータスのいずれかを持ちます。ステータスはその取引の最新のイベントを反映します。返金と係争は、兄弟の行を挿入せず、既存の行を更新します。
| ステータス | 意味 |
|---|---|
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 エンドポイントで表面化します。将来のリリースで、あなた自身のバックエンドが自動的に反応できるよう、メール通知と送信用の webhook フォワーダーを追加します。当面は、小さなポーリングジョブ(次のセクション参照)を設定するか、ダッシュボードを確認してください。