IOSOR ガイド

プリペイド hold が失敗したとき:自動返金とステータスの真実

失敗したプリペイド hold をウォレット事象として扱い、自動で解放または返金し、防御可能なステータスをエクスポートし、未決済の資金に Activated や Delivered を付けない。

完了できないプリペイド hold は、資金とステータスを財務が防御できる状態に残さなければなりません。失敗は「後でもう一度」の演出ではありません。予約が利用可能残高に戻るか、決済済み金額を明示的に返金するか、証拠が揃うまで名前付き終端状態で再試行を止めるかのいずれかです。資金が滞留・消失しているのに成功を描くと、プロダクトも財務も台帳を信じなくなります。

IOSOR は white-label prepaid です。同じ規則が messaging、verification、email、voice、および同一ウォレット上の JIT 番号 intent に適用されます。公開最低 USD 20 はパイロット下限であり、fail パスが動く証明ではありません。月 USD 1,000 付近の review は失敗行をより目立たせるだけです。

失敗はトーストではなくウォレット事象

チェックアウトのスピナーや「pending」バナーは資金の真実ではありません。失敗後、ウォレットは hold を解放したか、debit を返金したか、エクスポート可能な理由で intent を凍結したかのいずれかです。予約が開いたまま製品が成功を示すなら台帳は嘘をついています。成功経路は 初回引き落とし前のプリペイド残高確保;本稿はその経路が耐えねばならない失敗経路です。

結果 ウォレット移動 読めるステータス
作業前の検証拒否 hold なし、または即時解放 Rejected — 引き落としなし
hold 下の履行失敗 予約額の全額解放 Failed — 資金返還済み
完了証拠なしのタイムアウト 期限ポリシーに従い解放 Timed out — 資金返還済み
決済済み額の取り消しが必要 明示的な refund 行 Refunded — 元 intent に紐付け
飛行中の不明結果 再試行を凍結;二度目の引き落とし禁止 Needs attention — 調査中

自動返金と解放は自動でなければならない

「運用が後で直す」はプロダクトではありません。未使用 hold の解放と誤った settle の返金は、予約を作った同じ規則から発火すべきです。同じ冪等キーの重複リクエストは元の資金結果を再利用します——冪等・再試行と資金。部分バッチは完了単位だけを決済し、未使用分を一つのエクスポートで戻します。

Release は未使用の予約資金を戻します。Refund は決済済み debit を取り消します。クライアントにはタイムスタンプ、理由、業務 intent ID が必要です。台帳行のない静かな残高編集は禁止です。番号購入失敗後の差し替え UX は DID発注失敗の返金と差し替え;本稿は全チャネルの資金の真実を扱います。

財務がエクスポートできるステータス語彙

CSV で生き残る短い一覧を要求してください:

  • funds held
  • completed / settled
  • released
  • refunded
  • needs attention
  • cancelled

リソース未割当・課金単位未受理の intent に「Activated」「Delivered」「Live」を発明しないでください。「Needs attention」は作業キューであり成功の同義語ではありません。金額・通貨・correlation ID 付きでエクスポートできないステータスは演出です。

Activated や Delivered を偽らない

偽の成功バッジは空検索より早く信頼を焼きます。メッセージング失敗を配信済みに見せてはいけません。開かなかった verify セッションを検証済みに見せてはいけません。未割当の JIT 番号に Activated を付けてはいけません。低残高と上限超過の拒否は可能なら hold 前に起こします——残高不足での送信停止——資金を行き止まり予約に入れないためです。

失敗の誠実さバイヤーチェックリスト

  1. 失敗した hold はすべて release、refund、または担当者付き needs-attention 凍結で終わりますか?
  2. release と refund はチャットチケットではなく製品イベントから自動ですか?
  3. 財務はサポートを開かずに失敗行を元の intent ID に結合できますか?
  4. 同じキーの再試行は資金を最大一度だけ動かしますか?
  5. クライアントエラーは brand-safe で上流ブランド名がありませんか?
  6. 利用可能残高が低すぎるとき stop-line は新しい hold を止めますか? 本番トラフィック前のウォレット停止ライン を確認。

IOSOR で始める

完了できないプリペイド hold をわざと起こす。上限、拒否、不足。資金が available に戻るか、明示の返金行が出ることを示す。財務が守れる失敗状態を書き出す。同じ鍵を二度目の動きなく繰り返す。これは hold 失敗の真実であり、死んだ割当の解放ではない。

Related: プリペイド支出の制御

IOSORの要点

失敗した hold は財布の出来事であり、成功の芝居ではない。

やる:自動解放または返金と名前付き状態。やるな:Activated や Delivered を作ること。

このガイドは役に立ちましたか?

関連ガイド