A flattened Payment object used by the Ripple-REST API.
All of the 11 first slot lengths must be equal.
Each of the other slot lengths must be 0
or 1
.
All elements of source_slippage
must be greater than or equal to
0
.
The slots partial_payment
and no_direct_ripple
cannot contain
NA
.
source_account
Object of class "RippleAddress"
. The
Ripple account address of the Payment sender.
source_tag
Object of class "UINT32"
. An unsigned 32-bit
integer most commonly used to refer to a sender's hosted account at a
Ripple gateway.
source_amount
Object of class "Amount"
. An optional
amount that can be specified to constrain cross-currency payments.
source_slippage
Object of class "numeric"
. An optional cushion
for the source_amount
to increase the likelihood that the payment
will succeed. The source_account
will never be charged more than
source_amount@value
+ source_slippage
.
destination_account
Object of class "RippleAddress"
.
destination_tag
Object of class "UINT32"
. An unsigned
32-bit integer most commonly used to refer to a receiver's hosted account
at a Ripple gateway.
destination_amount
Object of class "Amount"
. The amount
the destination_account
will receive.
invoice_id
Object of class "Hash256"
. A 256-bit hash that
can be used to identify a particular payment.
paths
Object of class "character"
. A "stringified" version of
the Ripple PathSet structure that users should treat as opaque.
partial_payment
Object of class "logical"
. A boolean that, if
set to TRUE
, indicates that this payment should go through even if
the whole amount cannot be delivered because of a lack of liquidity or
funds in the source_account
account.
no_direct_ripple
Object of class "logical"
. A boolean that can
be set to TRUE
if paths are specified and the sender would like the
Ripple Network to disregard any direct paths from the source_account
to the destination_account
. This may be used to take advantage of an
arbitrage opportunity or by gateways wishing to issue balances from a hot
wallet to a user who has mistakenly set a trustline directly to the hot
wallet.
direction
Object of class "character"
. The direction of the
payment, from the perspective of the account being queried. Possible values
are "incoming"
, "outgoing"
, and "passthrough"
.
state
Object of class "character"
. The state of the payment from
the perspective of the Ripple Ledger. Possible values are
"validated"
and "failed"
and "new"
if the payment has
not been submitted yet.
result
Object of class "character"
. The rippled
code
indicating the success or failure type of the payment. The code
"tesSUCCESS"
indicates that the payment was successfully validated
and written into the Ripple Ledger. All other codes will begin with the
following prefixes: "tec"
, "tef"
, "tel"
, or
"tej"
.
ledger
Object of class "numeric"
. The index number of the ledger
containing the validated or failed payment. Failed payments will only be
written into the Ripple Ledger if they fail after submission to a
rippled
and a Ripple Network fee is claimed.
hash
Object of class "Hash256"
. The 256-bit hash of the
payment. This is used throughout the Ripple protocol as the unique
identifier for the transaction.
timestamp
Object of class "POSIXct"
. The timestamp representing
when the payment was validated and written into the Ripple ledger.
fee
Object of class "numeric"
. The Ripple Network transaction
fee, represented in whole XRP (NOT "drops", or millionths of an XRP, which
is used elsewhere in the Ripple protocol).
source_balance_changes
Object of class "Amount"
. Parsed
from the validated transaction metadata, this represents all of the changes
to balances held by the source_account
. Most often this will have
one amount representing the Ripple Network fee and, if the
source_amount
was not XRP, one amount representing the actual
source_amount
that was sent.
destination_balance_changes
Object of class "Amount"
.
Parsed from the validated transaction metadata, this represents the changes
to balances held by the destination_account
. For those receiving
payments this is important to check because if the partial_payment
flag is set this value may be less than the destination_amount
.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.