ILP TestNet: Getting Started

Create an account on the ILP TestNet to send and receive money.


This tutorial describes how to:

  1. Create an account in the Interledger Testnet.

  2. Fund your account using the TestNet Rainmaker (our version of a "faucet").

  3. Check your balance.

  4. Pay a Friend.

  5. Get paid.

1. Get Super Powers

Create a new account using the following command:

> curl --location --request POST '' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw '{
"assetCode": "XRP",
"assetScale": "6"

Super-powers are granted to anyone who asks - after all, this is just a Testnet!

The above request will return a payload that contains your accountId , an auth token which you will use to authenticate to the connector, as well as a Payment Pointer that can be used to receive value in your test account.

Here's an example response payload for reference:

"accountId": "user_qqGV8nij",
"accountRelationship": "CHILD",
"assetCode": "XRP",
"assetScale": "6",
"maximumPacketAmount": null,
"linkType": {},
"connectionInitiator": true,
"isInternal": false,
"sendRoutes": true,
"receiveRoutes": false,
"balanceSettings": {
"minBalance": null,
"settleThreshold": null,
"settleTo": "0"
"rateLimitSettings": {
"maxPacketsPerSecond": null
"settlementEngineDetails": null,
"customSettings": {
"ilpOverHttp.outgoing.url": "",
"ilpOverHttp.incoming.auth_type": "SIMPLE",
"ilpOverHttp.incoming.simple.auth_token": "JQBzzLkbslrsT",
"ilpOverHttp.outgoing.simple.auth_token": "enc:jks:crypto/crypto.p12:secret0:1:aes_gcm:AAAADDBa7b-nDvY2ydWysQQMoZL7yIOmK-7-3kLiMc9pxhzPw1Ei68OpwcZu6W-j",
"ilpOverHttp.outgoing.auth_type": "SIMPLE"
"paymentPointer": "$",
"parentAccount": false,
"childAccount": true,
"peerAccount": false,
"peerOrParentAccount": false

The generated accountId can be found at accountId, and your generated auth token can be found at "customSettings" -> "ilpOverHttp.incoming.simple.auth_token".

2. Make it Rain

The TestNet has a rainmaker accounts that you can use to send yourself some faux XRP. Use the following command to make it rain:

> curl --location --request POST \

In the call above, make sure to replace {your-account-id} with your own accountId created above.

3. Check Your Balance

To see how much money is in your account, try the following call:

> curl --location --request GET '{your-account-id}/balance' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {auth_token}' \

Be sure to replace {auth_token} above with the auth token returned when you generated your account!

This request will return JSON similar to the JSON below:

"assetCode": "XRP",
"assetScale": "6",
"accountBalance": {
"accountId": "user_qqGV8nij",
"netBalance": "0",
"clearingBalance": "0",
"prepaidAmount": "0"

4. Pay a Friend

Spread the love to a friend by making a payment to a payment pointer. In this case, try sending value to a different wallet on the testnet. Maybe someone at

> curl --location --request POST '{your-account-id}/pay' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {auth_token}' \
--data-raw '{
"amount": "10",
"destinationPaymentPointer": "$"

Be sure to replace {your-account-id} and {auth_token}with the values returned in Step 1!

This request will return JSON similar to the JSON below:

"originalAmount": "10",
"amountDelivered": "10",
"amountSent": "10",
"successfulPayment": true

originalAmount is the amount that you wanted to send.

amountDelivered is the amount your friend actually received.

amountSent is the amount that actually got sent to your friend.

5. Get Paid

Try sending yourself money from your wallet. Then, check your balance to see that the money has arrived in your account.