Get request for payment by ID

Request

Gets a request for payment by request for payment ID.

Security

Bearer

Path

request_for_payment_idstring, (uuid)required

Unique identifier of the request for payment to retrieve.

curl -i -X GET \
  'https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/reference/openapi/request_for_payment/{request_for_payment_id}' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Successfully retrieves a request for payment by its ID.

Bodyapplication/json

request_for_payment_idstring, (uuid)required

Unique identifier of a request for payment.

Example:"1bf93760-ef69-4697-b2b4-47d9e1c42aa7"

request_for_payment_statestringrequired

State of the request for payment.

Enum:"REQUESTED""ACCEPTED""FAILED"

Example:"REQUESTED"

sender_addressstringrequired

RippleNet address of the node that is receiving the request for payment, or the eventual sender of the payment.

Example:"trans_usd_sf@rn.us.ca.san_francisco"

receiver_addressstringrequired

RippleNet address of the node that is sending the request for payment, or the eventual receiver of the payment.

Example:"trans_gbp_lon@rn.eur.uk.london"

amountnumberrequired

Amount requested to be paid.

Example:100.01

currencystringrequired

Currency code for the amount value.

Example:"USD"

quote_typestringrequired

Indicates how the amount field should be treated for calculating quote values.

Enum:"SENDER_AMOUNT""RECEIVER_AMOUNT""SENDER_INSTITUTION_AMOUNT""RECEIVER_INSTITUTION_AMOUNT"

Example:"SENDER_AMOUNT"

end_to_end_idstring

ID that the eventual payment receiver can specify. Persisted on all rippleNet Node instances (namely, the sender and receiver of the payment) that participate in the request for payment.

user_infoArray of objectsrequired

User-provided data with arbitrary key/value pairs.

created_atstring, (date-time)required

Date and time at which the request for payment was created, as an ISO-8601 timestamp in UTC.

payment_idstring, (uuid)

Unique identifier of a payment associated to request for payment.

Example:"5492648d-2132-4e70-9ded-2fc86f22b321"

Response

{
  "request_for_payment_id": "1bf93760-ef69-4697-b2b4-47d9e1c42aa7",
  "request_for_payment_state": "REQUESTED",
  "sender_address": "trans_usd_sf@rn.us.ca.san_francisco",
  "receiver_address": "trans_gbp_lon@rn.eur.uk.london",
  "amount": 100.01,
  "currency": "USD",
  "quote_type": "SENDER_AMOUNT",
  "end_to_end_id": "string",
  "user_info": [
    { … }
  ],
  "created_at": "2019-08-24T14:15:22Z",
  "payment_id": "5492648d-2132-4e70-9ded-2fc86f22b321"
}