CheckCash
(Checks Amendmentが必要です)
対応するCheckCreateトランザクションで承認された額まで受領するため、レジャーでCheckオブジェクトの清算を試みます。CheckCashトランザクションでCheckを換金できるのは、CheckのDestination
アドレスだけです。このCheckの換金方法は、送金先により開始されるPaymentの実行に似ています。
Checkに相当する資金があるとは保証されないため、送金元に十分な残高がないか、または資金を送金できるだけの十分な流動性がないことが原因で、Checkの清算が失敗することがあります。このような状況が発生した場合、Checkはレジャーに残り、送金先は後でこのCheckの換金を再試行するか、または異なる額で換金を試みることができます。
CheckCash JSONの例
{ "Account": "rfkE1aSy9G8Upk4JssnwBxhEv5p4mn2KTy", "TransactionType": "CheckCash", "Amount": "100000000", "CheckID": "838766BA2B995C00744175F69A1B11E32C3DBC40E64801A4056FCBD657F57334", "Fee": "12" }
CheckCash フィールド
共通フィールドに加えて、CheckCashトランザクションは以下のフィールドを使用します。
フィールド | JSONの型 | 内部の型 | 説明 |
---|---|---|---|
CheckID | 文字列 | Hash256 | 換金する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
で失敗します。