CheckCash
対応するCheckCreateトランザクションで承認された額まで受領するため、レジャーでCheckオブジェクトの清算を試みます。CheckCashトランザクションでCheckを換金できるのは、CheckのDestinationアドレスだけです。このCheckの換金方法は、送金先により開始されるPaymentの実行に似ています。
Checkに相当する資金があるとは保証されないため、送金元に十分な残高がないか、または資金を送金できるだけの十分な流動性がないことが原因で、Checkの清算が失敗することがあります。このような状況が発生した場合、Checkはレジャーに残り、送金先は後でこのCheckの換金を再試行するか、または異なる額で換金を試みることができます。
（Checks Amendmentが必要です）
CheckCash JSONの例
{
"Account": "rfkE1aSy9G8Upk4JssnwBxhEv5p4mn2KTy",
"TransactionType": "CheckCash",
"Amount": "100000000",
"CheckID": "838766BA2B995C00744175F69A1B11E32C3DBC40E64801A4056FCBD657F57334",
"Fee": "12"
}CheckCash フィールド
共通フィールドに加えて、CheckCashトランザクションは以下のフィールドを使用します。
| フィールド | JSONの型 | 内部の型 | 説明 |
|---|---|---|---|
CheckID | 文字列 | UInt256 | 換金するCheckレジャーオブジェクトのID（64文字の16進文字列）。 |
Amount | 通貨額 | Amount | （省略可） 可能であればCheckを厳密にこの額で清算します。通貨は対応するCheckCreateトランザクションのSendMaxの通貨と一致している必要があります。このフィールドまたはDeliverMinのいずれかを指定する必要があります。 |
DeliverMin | 通貨額 | Amount | （省略可） Checkをこの額以上の可能な限りの額で清算します。通貨は対応するCheckCreateトランザクションのSendMaxの通貨と一致している必要があります。このフィールドまたはAmountのいずれかを指定する必要があります。 |
AmountまたはDeliverMinのいずれかを指定する必要がありますが、両方は指定しないでください。
エラーケース
- CheckCashトランザクションの送信者がCheckの
Destinationではない場合、トランザクションは結果コードtecNO_PERMISSIONで失敗します。 CheckIDフィールドにより識別されるCheckが存在していない場合、トランザクションは結果コードtecNO_ENTRYで失敗します。CheckIDフィールドにより識別されるCheckが有効期限切れである場合、トランザクションは結果コードtecEXPIREDで失敗します。- Checkの送金先でRequireDestフラグが有効であるが、作成されるCheckには送金先タグが指定されていない場合、トランザクションは結果コード
tecDST_TAG_NEEDEDで失敗します。 - トランザクションで
AmountとDeliverMinの両方が指定または省略される場合、トランザクションは結果コードtemMALFORMEDで失敗します。 AmountまたはDeliverMinがCheckの通貨（およびXRP以外の通貨の場合はイシュアー）に一致しない場合、トランザクションは結果コードtemBAD_CURRENCYで失敗します。