Send Payments Using JavaScript

The XRP Ledger (XRPL) is a robust, secure, customizable service. You can create your own interface to try out the capabilities and support your specific business needs.

This quickstart describes a test harness interface you can build to try out the XRP Ledger. The test harness displays multiple accounts, so that you can transfer tokens from one account to the other and see the results in real time. The image below shows the Token Test Harness at the completion of step 4.

Quickstart Tutorial Window

That is a lot of fields and buttons, all working together to perform some significant practical tasks. But getting started with the XRP Ledger is not that complicated. When you eat the elephant a bite at a time, none of the tasks are difficult to consume.

Typically, the example functions for interacting with the XRP Ledger involve four steps.

  1. Connect to the XRP Ledger and instantiate your wallet.
  2. Make changes to the XRP Ledger using transactions.
  3. Get the state of accounts and tokens on the XRP Ledger using requests.
  4. Disconnect from the XRP Ledger.

Each lesson shows you how to build the Token Test Harness one section at a time. Each module lets you try out meaningful interactions with the test ledger, with complete JavaScript and HTML code samples and a code walkthrough. There is also a link to the complete source code for each section that can be modified with a text editor and run in a browser. If you cannot wait, you can follow the prerequisites below, then jump to lesson 4, Transfer NFTs, and try out the complete test harness right away.

This quickstart tutorial introduces you to the API used to implement features and explore the capabilities of XRP Ledger. It does not represent all of the capabilities of the API and this example is not intended for production or secure payment use.

Much of this is “brute force” code that sacrifices conciseness for readability. Each example builds on the previous examples, adding a new JavaScript file and the supporting UI. We anticipate that the applications you build greatly improve upon these examples. Your feedback and contributions are most welcome.


To get started, create a new folder on your local disk and install the JavaScript library using npm.

    npm install xrpl

Download and expand the Quickstart Samples .