Skip to content
GitHub

List Outgoing Payments

GET
/outgoing-payments

List all outgoing payments on the wallet address

Authorizations

Parameters

Query Parameters

wallet-address
required
string

URL of a wallet address hosted by a Rafiki instance.

cursor
string
>= 1 characters

The cursor key to list from.

first
integer
>= 1 <= 100

The number of items to return after the cursor.

last
integer
>= 1 <= 100

The number of items to return before the cursor.

Header Parameters

Signature-Input
required

The Signature-Input field is a Dictionary structured field containing the metadata for one or more message signatures generated from components within the HTTP message. Each member describes a single message signature. The member’s key is the label that uniquely identifies the message signature within the context of the HTTP message. The member’s value is the serialization of the covered components Inner List plus all signature metadata parameters identified by the label. The following components MUST be included: - “@method” - “@target-uri” - “authorization”. When the message contains a request body, the covered components MUST also include the following: - “content-digest” The keyid parameter of the signature MUST be set to the kid value of the JWK. See ietf-httpbis-message-signatures for more details.

The Signature-Input field is a Dictionary structured field containing the metadata for one or more message signatures generated from components within the HTTP message. Each member describes a single message signature. The member’s key is the label that uniquely identifies the message signature within the context of the HTTP message. The member’s value is the serialization of the covered components Inner List plus all signature metadata parameters identified by the label. The following components MUST be included: - “@method” - “@target-uri” - “authorization”. When the message contains a request body, the covered components MUST also include the following: - “content-digest” The keyid parameter of the signature MUST be set to the kid value of the JWK. See ietf-httpbis-message-signatures for more details.

Signature
required

The signature generated based on the Signature-Input, using the signing algorithm specified in the “alg” field of the JWK.

The signature generated based on the Signature-Input, using the signing algorithm specified in the “alg” field of the JWK.

Responses

200

OK

object
pagination
object
startCursor

Cursor corresponding to the first element in the result array.

string
>= 1 characters
endCursor

Cursor corresponding to the last element in the result array.

string
>= 1 characters
hasNextPage
required

Describes whether the data set has further entries.

boolean
hasPreviousPage
required

Describes whether the data set has previous entries.

boolean
result
Array<object>

An outgoing payment resource represents a payment that will be, is currently being, or has previously been, sent from the wallet address.

object
id
required

The URL identifying the outgoing payment.

string format: uri
walletAddress
required

The URL of the wallet address from which this payment is sent.

string format: uri
quoteId

The URL of the quote defining this payment’s amounts.

string format: uri
failed

Describes whether the payment failed to send its full amount.

boolean
receiver
required

The URL of the incoming payment that is being paid.

string format: uri
/^(https|http)://(.+)/incoming-payments/(.+)$/
receiveAmount
required

The total amount that should be received by the receiver when this outgoing payment has been paid.

object
value
required

The value is an unsigned 64-bit integer amount, represented as a string.

string format: uint64
assetCode
required

The assetCode is a code that indicates the underlying asset. This SHOULD be an ISO4217 currency code.

string
assetScale
required

The scale of amounts denoted in the corresponding asset code.

integer
<= 255
debitAmount
required

The total amount that should be deducted from the sender’s account when this outgoing payment has been paid.

object
value
required

The value is an unsigned 64-bit integer amount, represented as a string.

string format: uint64
assetCode
required

The assetCode is a code that indicates the underlying asset. This SHOULD be an ISO4217 currency code.

string
assetScale
required

The scale of amounts denoted in the corresponding asset code.

integer
<= 255
sentAmount
required

The total amount that has been sent under this outgoing payment.

object
value
required

The value is an unsigned 64-bit integer amount, represented as a string.

string format: uint64
assetCode
required

The assetCode is a code that indicates the underlying asset. This SHOULD be an ISO4217 currency code.

string
assetScale
required

The scale of amounts denoted in the corresponding asset code.

integer
<= 255
metadata

Additional metadata associated with the outgoing payment. (Optional)

object
createdAt
required

The date and time when the outgoing payment was created.

string format: date-time
updatedAt
required

The date and time when the outgoing payment was updated.

string format: date-time
Examples
{
  "pagination": {
    "startCursor": "241de237-f989-42be-926d-c0c1fca57708",
    "endCursor": "315581f8-9967-45a0-9cd3-87b60b6d6414",
    "hasPreviousPage": false,
    "hasNextPage": true
  },
  "result": [
    {
      "id": "https://ilp.interledger-test.dev/outgoing-payments/8c68d3cc-0a0f-4216-98b4-4fa44a6c88cf",
      "walletAddress": "https://ilp.interledger-test.dev/alice/",
      "failed": false,
      "receiver": "https://ilp.interledger-test.dev/aplusvideo/incoming-payments/45d495ad-b763-4882-88d7-aa14d261686e",
      "receiveAmount": {
        "value": "2500",
        "assetCode": "USD",
        "assetScale": 2
      },
      "debitAmount": {
        "value": "2600",
        "assetCode": "USD",
        "assetScale": 2
      },
      "sentAmount": {
        "value": "2500",
        "assetCode": "USD",
        "assetScale": 2
      },
      "createdAt": "2022-03-12T23:20:50.52Z",
      "updatedAt": "2022-04-01T10:24:36.11Z",
      "metadata": {
        "description": "APlusVideo subscription",
        "externalRef": "customer: 847458475"
      }
    },
    {
      "id": "https://ilp.interledger-test.dev/outgoing-payments/0cffa5a4-58fd-4cc8-8e01-7145c72bf07c",
      "walletAddress": "https://ilp.interledger-test.dev/alice/",
      "failed": false,
      "receiver": "https://ilp.interledger-test.dev/shoeshop/incoming-payments/2fe92c6f-ef0d-487c-8759-3784eae6bce9",
      "debitAmount": {
        "value": "7126",
        "assetCode": "USD",
        "assetScale": 2
      },
      "receiveAmount": {
        "value": "7026",
        "assetCode": "USD",
        "assetScale": 2
      },
      "sentAmount": {
        "value": "7026",
        "assetCode": "USD",
        "assetScale": 2
      },
      "createdAt": "2022-03-12T23:20:50.52Z",
      "updatedAt": "2022-04-01T10:24:36.11Z",
      "metadata": {
        "description": "Thank you for your purchase at ShoeShop!",
        "externalRef": "INV2022-8943756"
      }
    }
  ]
}

401

Authorization required

Headers

WWW-Authenticate
string

The address of the authorization server for grant requests in the format GNAP as_uri=<URI>

403

Forbidden