Skip to main content
精算は、Payments Account の利用可能な資金を、自社の Treasury Account のいずれか、または指定した外部の銀行口座へ移動します。Hello Clever はこれらの精算について定期的にレポートを作成します。アカウントで有効にしたレポートの頻度ごとに、その期間の精算をまとめた精算レポートを生成します。 これは、以前メールで送られていたものと同じレポートを API から取得するものです。期間内に生成されたレポートを一覧で取得すると、各項目からファイルへのリンクが得られます。ファイルは一度生成されると変わらないため、先月照合した数値は来年読み直しても同じです。

​
レポートの流れ

1

Hello Clever がレポートを生成する

日次の精算処理の後、アカウントで設定したタイムゾーンの 09:00 にレポートが生成されます。有効にした頻度ごと、通貨ごとに1件です。
2

生成されたレポートを一覧で取得する

from_date と to_date を指定して Get Settlement Reports を呼び出します。返されるのはメタデータのみです。ファイル名、対象期間、期間の合計を含む summary オブジェクト、file_url が含まれます。ファイルの中身は転送されません。
3

リンクからファイルを取得する

file_url がファイルそのものです。これに対して通常の GET を送ると、レスポンスが CSV になります。リンクは署名付きなので app-id や secret-key は含まれず、2回目の API 呼び出しも必要ありません。
レポートのファイルを取得する

​
レポートの頻度

レポートは、アカウントで有効にした頻度ごとに、アカウントで設定したタイムゾーンで生成されます。
頻度が異なるレポートの間では期間が重なります。日次と月次のレポートを両方有効にしている場合、9 月 14 日の精算は 9 月 14 日の日次レポートに含まれ、10 月 1 日に生成される月次レポートにも再び含まれます。各精算を台帳に一度だけ計上するため、report_frequency で絞り込んでください。
日次レポートの対象は、アカウントのタイムゾーンの 09:00 から 09:00 までです。0 時から 0 時までではありません。会計期間が暦日の場合、各日の最後の数時間は翌日のレポートに含まれます。

​
ファイルの形式

ファイル名には空白と括弧が含まれます。たとえば Daily Report (AUD) (Sep 06, 2026 - Sep 07, 2026).csv です。パスに使う場合は URL エンコードしてください。

​
列

各行は、期間に含まれる1件の精算を表します。 ファイルは次のようになります。
Daily Report (AUD) (Sep 06, 2026 - Sep 07, 2026).csv
期間の合計を出すためにファイルを開く必要はありません。一覧の項目にある summary オブジェクトに、これらの数値がすでに含まれています。その内訳となる精算ごとの詳細が必要なときにファイルを取得してください。

​
summary オブジェクト

summary は、レポートの対象期間を表します。すべての数値はファイルの行から算出され、ファイルと同じ方法で通貨の精度に丸められるため、両者は常に一致します。 closing_balance は、期間内の最後の精算に対して台帳自体が記録した残高です。ファイルから計算した数値ではありません。
期間内の精算のいずれにも、台帳が記録した残高がまだない場合、closing_balance と closing_balance_at は null になります。他の3つの数値は常に含まれます。
期間終了時点の数値ではなく現在の残高が必要な場合は、Get Balance Details V2 を呼び出してください。Reporting API は、意図的に締めた期間のみを対象としています。

​
リンクの有効期限

file_url はレポートを一覧で取得したときに発行され、3 分間有効です。
リンクを自社のデータベースに保存したり、後で実行するバックグラウンドのジョブに渡したりしないでください。レポートの id を保持し、レポートを再度一覧で取得して新しいリンクを受け取ってください。返された項目ごとにリンクが発行されるため、その処理で取得する分だけの size を指定してください。
リンクには独自の署名が含まれるため、リンクを持っていれば誰でも有効期限までファイルを読めます。ファイルの内容そのものと同様に扱い、ログに記録されたり共有されたりする URL には決して含めないでください。

​
期間の照合

1

期間のレポートを取得する

締める期間を指定して Get Settlement Reports を呼び出します。頻度の重なりによる二重計上を防ぐため、report_frequency で絞り込んでください。範囲は生成日時に対して適用されるため、期間の始まりを含むレポートを取りこぼさないよう、範囲を1期間分広げてください。
2

各ファイルを取得する

リンクが有効なうちに同じ処理の中で各項目の file_url に GET を送り、has_more が false になるまでページを進めます。
3

銀行の取引明細の入金と照合する

Reference をキーとして、Amount から Fee amount を差し引いた金額と照合します。1つの参照番号は1件の入金に対応し、期間の合計は summary.settled_amount と summary.settled_fee です。
4

一致しないものを追跡する

Balance ID を Get Balance History V2 に渡すと、残高のタイムラインでその精算を確認できます。精算元の残高を構成した決済、返金、手数料も併せて表示されます。
夜間のジョブでは、実行をまたいでカーソルを追跡するのではなく、固定の範囲（たとえば UTC で直前の丸2日間を report_frequency=daily で絞り込んだもの）を照会してください。範囲が重なっても二重に計上されないよう、レポートの id で重複を排除してください。

​
Payments Account

1つのレポートは、1つの通貨について、期間内に精算を行った Payments Account 全体の精算を対象とします。ファイルの Account Nickname 列で各精算の精算元のアカウントがわかるため、複数のアカウントにまたがるレポートでも、自社の側でアカウントごとに分けられます。 現時点では、1つの Payments Account のみを対象とするレポートを要求する方法はありません。必要な場合はお問い合わせください。各モデルでアカウントが残高を保持する仕組みは、残高モデルを参照してください。