取引・アカウント・鍵

Partial Paymentとは:指定額と実際の受取額が違う理由

Partial Payment(部分支払い)は、受取額を減らしてでも送金を成功させるXRPLの送金方法です。Amountが上限になるしくみ、実際の受取額を示すdelivered_amount、受け取る側が気をつけたい攻撃の手口、返金での使い方を紹介します。

「Partial Paymentとは:指定額と実際の受取額が違う理由」のイメージ画像

先に知っておきたい要点

  • Partial Paymentでは、Amountは届ける額の上限になり、受取額を減らしてでも送金を成功させます。
  • 実際に届いた額は、取引の結果に記録されるdelivered_amountで確かめます。
  • Amountだけを見て入金を処理すると、少額しか届いていないのに満額を入金扱いにしてしまう攻撃を受けるおそれがあります。
この記事の目次
  1. 1. Partial Paymentは「受取額を減らしてでも成功させる」送金
  2. 2. 実際に届いた額は、delivered_amountで読む
  3. 3. Amountだけを見ると、攻撃を受けるおそれがある
  4. 4. DeliverMinとSendMaxで、受取額と支払額に枠を決める
  5. 5. 使いどころは、手数料を負担しない返金
  6. 注意しておきたいこと
  7. よくある疑問
  8. まとめ
  9. 出典・参考資料

Partial Payment(部分支払い)は、受取額を減らしてでも送金を成功させる、XRP Ledgerの送金方法です。送金の指示に書いた額と、実際に届いた額が違うことがあるのはこのためです。

この記事では、Partial Paymentのしくみ、実際の受取額の読み方、受け取る側が気をつけたい攻撃の手口を紹介します。Paymentの基本的な読み方はPayment JSONの記事で紹介しています。

広告

1. Partial Paymentは「受取額を減らしてでも成功させる」送金

Partial Paymentは、届ける額を減らすことで、送る側の負担を増やさずに送金を成功させるしくみです。資料1

通常の送金では、Amount(届ける額)に書いた額がそのまま届きます。トークンの送金で手数料がかかったり、通貨の交換で足りなくなったりすると、送金は失敗します。

Partial Paymentでは、PaymentにtfPartialPaymentというフラグ(値は131072)を付けます。資料2 するとAmountは「届ける額の上限」になり、不足分だけ受取額を減らして送金が成功します。

例えるなら、「最大1万円分の品物を届けて」と頼む買い物の代行です。送料や値上がりで1万円分を届けられないとき、通常の送金は「届けられないので中止」、Partial Paymentは「届けられる分だけ届ける」と判断します。

2. 実際に届いた額は、delivered_amountで読む

Partial Paymentで実際に届いた額は、取引の結果(メタデータ)に記録されるdelivered_amountで確かめます。資料1

{
  "tx_json": {
    "TransactionType": "Payment",
    "Flags": 131072,
    "DeliverMax": { "currency": "USD", "issuer": "r...", "value": "100" }
  },
  "meta": {
    "TransactionResult": "tesSUCCESS",
    "delivered_amount": { "currency": "USD", "issuer": "r...", "value": "98.5" }
  }
}

この例では、届ける額の上限は100 USDですが、実際に届いたのは98.5 USDです。結果コードはどちらも成功を示すtesSUCCESSなので、結果コードだけでは受取額の違いに気づけません。

API v2では、誤解を防ぐためにAmountの名前がDeliverMaxに変わりました。資料2

delivered_amountは、成功したPayment、CheckCash、AccountDeleteの結果に記録されます。資料3

広告

3. Amountだけを見ると、攻撃を受けるおそれがある

Partial Paymentを知らずに入金を処理するシステムは、攻撃の標的になります。XRPLの公式ドキュメントは、この手口を「Partial Payments Exploit」として注意しています。資料1

  1. 攻撃者が、Amountに大きな額を書いたPartial Paymentを送る
  2. 実際に届くのはごくわずかな額だが、結果は成功(tesSUCCESS)になる
  3. Amountだけを見るシステムは、満額が届いたと誤って入金扱いにする
  4. 攻撃者は、入金扱いになった額を引き出す

対策は、入金の処理で必ずdelivered_amountを使うことです。取引所や決済サービスなど、XRPLの入金を受け付けるシステムを作るときの基本ルールです。

4. DeliverMinとSendMaxで、受取額と支払額に枠を決める

Partial Paymentには、受取額の下限と、支払額の上限を決める項目があります。資料2

項目 役割
Amount(DeliverMax) 届ける額の上限
DeliverMin 届ける額の下限。これを下回るなら送金は失敗する(省略可)
SendMax 送る側が支払う額の上限。通貨の交換を伴う送金で使う

画面に収まらない場合は、表を左右にスクロールできます。

XRPをXRPのまま直接送る送金は、Partial Paymentにできません。資料1 Partial Paymentで新しいアカウントを作ることもできないので、アカウントの作成は通常の送金で行います。

広告

5. 使いどころは、手数料を負担しない返金

Partial Paymentは、受け取った送金を返すときに役立ちます。資料4 受け取った額をAmountに入れ、SendMaxを省いて部分支払いで返すと、返す側が追加の手数料を負担せずに済みます。

宛先タグの付け忘れなどで受け取った送金を送り主に戻すときに使われます。宛先タグについては宛先タグの記事で紹介しています。

注意しておきたいこと

  • 入金処理はdelivered_amountで:Amountは上限で、実際の受取額とは限りません。入金を処理するときは、必ず結果のdelivered_amountを使いましょう。
  • 古い取引の例外:2014年1月20日より前の台帳に入った部分支払いでは、delivered_amountが「unavailable」と表示されます。その場合は、台帳の変化(AffectedNodes)から受取額を読み取ります。資料3
  • トークンの丸め:通常の送金でも、トークンでは端数の丸めでAmountとdelivered_amountがわずかに違うことがあります。
  • 検証済みの台帳で確かめる:受取額は、検証済みの台帳に入った取引の結果で確かめましょう。結果コードの読み方は結果コードの記事で紹介しています。

よくある疑問

XRPをウォレットに送るだけなら、Partial Paymentを気にする必要はある?

XRPをXRPのまま直接送る場合は、Partial Paymentにできません。送られたXRPを受け取る個人が特別な対応をする場面は多くありませんが、入金を自動で処理するシステムでは必ず考慮が必要です。

送金の画面に表示される「受取額」は、どちらの値?

ウォレットやエクスプローラーの多くは、取引の結果から実際の受取額を表示します。表示がAmountなのかdelivered_amountなのかは、使っているツールの説明で確かめましょう。

まとめ

Partial Paymentは、Amountを上限として、受取額を減らしてでも送金を成功させるしくみです。実際に届いた額はdelivered_amountで確かめ、入金の処理では必ずこの値を使います。「Amountは上限、delivered_amountが実際の額」という軸で、送金の結果を見分けられます。

出典・参考資料

技術はXRPLの公式文書、事業は発表元、裁判・制度は原典を参照します。資料の対象と時点を本文の説明と合わせて読むことを大切にしています。

  1. 01
    Partial PaymentsXRPL公式ドキュメント|受取額を減らして送金を成功させるしくみ。Amountは届ける額の上限。直接のXRP同士の送金は部分支払いにできない。Partial Paymentを使った攻撃と、delivered_amountを使う対策|確認:2026年10月13日
  2. 02
    PaymentXRPL公式ドキュメント|tfPartialPaymentのフラグ値は0x00020000(131072)。DeliverMin、SendMaxの項目。API v2ではAmountの名前がDeliverMaxに|確認:2026年10月13日
  3. 03
    Transaction MetadataXRPL公式ドキュメント|delivered_amountは成功したPayment・CheckCash・AccountDeleteにある。2014年1月20日より前の検証済み台帳に入った部分支払いでは「unavailable」|確認:2026年10月13日
  4. 04
    Bouncing PaymentsXRPL公式ドキュメント|受け取った送金を返すときは、Partial Paymentで、Amountに受け取った額を入れ、SendMaxを省いて送る|確認:2026年10月13日