最終更新:
編集

DepositPreauth

[ソース]

DepositPreauth Amendmentにより追加されました。

DepositPreauthトランザクションは、あなたのアカウントへの支払いを送金するための事前承認を付与します。これは、あなたがDeposit Authorizationを使用している(または使用する予定がある)場合にのみ有用です。

ヒント
このトランザクションを使用して、Deposit Authorizationを有効にする前に事前承認できます。これは、Deposit Authorizationの義務化への円滑な移行に役立ちます。

DepositPreauth JSONの例

{
  "TransactionType" : "DepositPreauth",
  "Account" : "rsUiUMpnrgxQp24dJYZDhmV4bE3aBtQyt8",
  "Authorize" : "rEhxGqkqPPSxQ3P25J66ft5TwpzV14k2de",
  "Fee" : "10",
  "Flags" : 2147483648,
  "Sequence" : 2
}

トランザクションを試してみる >

DepositPreauth フィールド

共通フィールドに加えて、DepositPreauthトランザクションは以下のフィールドを使用します。

フィールドJSONの型内部の型必須?説明
Authorize文字列 - アドレスAccountIDいいえ事前承認するアカウント。
AuthorizeCredentials配列STArrayいいえ承認する資格証明書のセット。 (Credentials amendmentが必要です。 )
Unauthorize文字列AccountIDいいえ事前承認を取り消すアカウント。
UnauthorizeCredentials配列STArrayいいえ事前承認を取り消す資格証明書のセット。 (Credentials amendmentが必要です。 )

Authorize, AuthorizeCredentials, Unauthorize, or UnauthorizeCredentialsいずれかを提供する必要があります。

このトランザクションが成功すると、提供されたフィールドに基づいて、DepositPreauthエントリが作成または削除されます。

AuthorizeCredentialsオブジェクト

提供される場合、AuthorizeCredentialsフィールドまたはUnauthorizeCredentialsフィールドの各メンバーは、次のフィールドを持つ内部オブジェクトでなければなりません。

フィールドJSONの型内部の型必須?説明
Issuer文字列 - アドレスAccountIDはい資格証明書の発行者。
CredentialType文字列 - 16進数値Blobはい資格証明書のタイプ。

エラーケース

すべてのトランザクションで発生する可能性のあるエラータイプに加えて、DepositPreauthトランザクションは次のエラーコードを生成することがあります。

エラーコード説明
tecDUPLICATEトランザクションはすでに存在する事前承認を作成します。
tecINSUFFICIENT_RESERVE送信者は準備金要件を満たしていません。(DepositPreauthエントリは承認者の所有者準備金に1つのアイテムとしてカウントされます。)
tecNO_ENTRYトランザクションは存在しない事前承認を取り消そうとしました。
tecNO_ISSUER指定された資格証明書発行者の1つ以上がレジャーに存在しません。
tecNO_TARGETトランザクションは、レジャーの資金提供アカウントではないアカウントを承認しようとしました。
temCANNOT_PREAUTH_SELFAuthorizeフィールドのアドレスはトランザクションの送信者です。自分自身を事前承認することはできません。
temDISABLED必要なAmendmentが有効になっていません。