List incoming payments

After one or more incoming payments have been created on a wallet address, an authorized client can look up active and pending incoming payments on that wallet address.

These code snippets retrieve the first ten incoming payments on the given wallet address.

Before you begin

We recommend creating a wallet account on the test wallet. Creating an account allows you to test your client against the Open Payments APIs by using an ILP-enabled wallet funded with play money.

List all incoming payments on a payment pointer

TypeScript

Prerequisites

• Node 20
• A package manager such as NPM or PNPM

• Open Payments SDK

• TSX

Additional configuration

Add "type": "module" to package.json

Add the following to tsconfig.json

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ES2022"
  }
}

Get started

Import dependencies

import { createAuthenticatedClient } from "@interledger/open-payments";

Copied! Copy import { createAuthenticatedClient } from "@interledger/open-payments";

Initialize Open Payments client

const client = await createAuthenticatedClient({
  walletAddressUrl: WALLET_ADDRESS,
  privateKey: PRIVATE_KEY_PATH,
  keyId: KEY_ID,
});

Copied! Copy const client = await createAuthenticatedClient({ walletAddressUrl: WALLET_ADDRESS, privateKey: PRIVATE_KEY_PATH, keyId: KEY_ID, });

List incoming payments

const incomingPayments = await client.incomingPayment.list(
  {
    url: new URL(WALLET_ADDRESS).origin,
    walletAddress: WALLET_ADDRESS,
    accessToken: INCOMING_PAYMENT_ACCESS_TOKEN,
  },
  {
    first: 10,
    last: undefined,
    cursor: undefined,
  },
);

Copied! Copy const incomingPayments = await client.incomingPayment.list( { url: new URL(WALLET_ADDRESS).origin, walletAddress: WALLET_ADDRESS, accessToken: INCOMING_PAYMENT_ACCESS_TOKEN, }, { first: 10, last: undefined, cursor: undefined, }, );

Output

console.log("INCOMING PAYMENTS:", JSON.stringify(incomingPayments, null, 2));

Copied! Copy console.log("INCOMING PAYMENTS:", JSON.stringify(incomingPayments, null, 2));

Run tsx path/to/directory/index.ts.

View full source

JavaScript

Prerequisites

• Node 20 or higher
• A package manager such as NPM or PNPM

• Open Payments SDK

Additional configuration

Add "type": "module" to package.json

Get started

Import dependencies

import { createAuthenticatedClient } from "@interledger/open-payments";

Copied! Copy import { createAuthenticatedClient } from "@interledger/open-payments";

Initialize Open Payments client

const client = await createAuthenticatedClient({
  walletAddressUrl: WALLET_ADDRESS,
  privateKey: PRIVATE_KEY_PATH,
  keyId: KEY_ID,
});

Copied! Copy const client = await createAuthenticatedClient({ walletAddressUrl: WALLET_ADDRESS, privateKey: PRIVATE_KEY_PATH, keyId: KEY_ID, });

List incoming payments

const incomingPayments = await client.incomingPayment.list(
  {
    url: new URL(WALLET_ADDRESS).origin,
    walletAddress: WALLET_ADDRESS,
    accessToken: INCOMING_PAYMENT_ACCESS_TOKEN,
  },
  {
    first: 10,
    last: undefined,
    cursor: undefined,
  },
);

Copied! Copy const incomingPayments = await client.incomingPayment.list( { url: new URL(WALLET_ADDRESS).origin, walletAddress: WALLET_ADDRESS, accessToken: INCOMING_PAYMENT_ACCESS_TOKEN, }, { first: 10, last: undefined, cursor: undefined, }, );

Output

console.log("INCOMING PAYMENTS:", JSON.stringify(incomingPayments, null, 2));

Copied! Copy console.log("INCOMING PAYMENTS:", JSON.stringify(incomingPayments, null, 2));

Run node path/to/directory/index.js.

View full source

References

• API specification