UsersGuide

Main.UsersGuide History

Hide minor edits - Show changes to output

Added lines 1-2:
! Ripplepay User's Guide
Added lines 4-5:

[[http://ripplepay.com/ | Ripplepay]] is the original Ripple implementation, but there are now [[Main/Implementations | several others]].  Check them out.
November 08, 2010, at 05:24 AM by Daniel - minor fixes
Deleted lines 52-53:

Changed lines 91-93 from:
!!Goods that can be paid with Ripple

[[http://ripplexchange.com|Ripplexchange]] is a new website (created in june 2010) where you can find offers and requests of goods that you can pay with Ripple.
to:
!!Buy and sell with Ripple

[[https://ripplexchange.com|Ripplexchange]] is a new website (created in June 2010) where you can find offers and requests for goods that you can buy and sell with Ripple.
November 05, 2010, at 08:39 AM by Romualdo Grillo -
Changed line 78 from:
You can freely add Ripple buttons to your site to let people pay you through Ripple. Buttons are easy to add, in a variety of styles:
to:
You can add Ripple buttons to your site to let people pay you through Ripple. Buttons are easy to add, in a variety of styles:
November 05, 2010, at 01:29 AM by Romualdo Grillo -
Changed lines 14-15 from:
[[#Buy_Sell|Offers and Requests of goods that can be paid with Ripple]]
to:
[[#Buy_Sell|Goods that can be paid with Ripple]]
Changed line 93 from:
!!Offers and Requests of goods that can be paid with Ripple
to:
!!Goods that can be paid with Ripple
November 05, 2010, at 01:26 AM by Romualdo Grillo -
Changed lines 14-15 from:
[[#Buy_Sell|Buy and sell using Ripple]]
to:
[[#Buy_Sell|Offers and Requests of goods that can be paid with Ripple]]
Changed line 93 from:
!!Buy and sell using Ripple
to:
!!Offers and Requests of goods that can be paid with Ripple
November 05, 2010, at 01:23 AM by Romualdo Grillo -
Changed line 95 from:
[[ripplexchange.com|Ripplexchange]] is a new website (created in june 2010) where you can find offers and requests of goods that you can pay with Ripple.
to:
[[http://ripplexchange.com|Ripplexchange]] is a new website (created in june 2010) where you can find offers and requests of goods that you can pay with Ripple.
November 05, 2010, at 01:21 AM by Romualdo Grillo -
Changed lines 93-95 from:
Buy and sell using Ripple

[[ripplexchange.com|Ripplexchange]] is a new website where you can find offers and requests of goods that you can pay with Ripple.
to:
!!Buy and sell using Ripple

[[ripplexchange.com|Ripplexchange]] is a new website (created in june 2010) where you can find offers and requests of goods that you can pay with Ripple.
November 05, 2010, at 01:16 AM by Romualdo Grillo - Removed Integration scenarios, adde RippleExchange
Changed lines 14-15 from:
[[#Scenarios|Integration Scenarios]]
to:
[[#Buy_Sell|Buy and sell using Ripple]]
Changed lines 92-121 from:
[[#Scenarios]]
!!Integration scenarios

This section will document real-world situations to address specific issues.

!!!Individual users

Individual users can use Ripplepay accounts to track IOUs with friends, to buy and sell goods and services with their friends, and to make exchanges with any organizations that have Ripplepay accounts.

!!!Non-profit organizations

In addition to the uses individuals can make of Ripplepay, non-profit organizations can track resources such as volunteer hours using Ripplepay. To track volunteer hours, each volunteer would offer the organization credit in the number of hours available. The organization would then pay the volunteer those hours through Ripplepay for the actual hours worked by the volunteer. If the non-profit organization offers any products or services to reward volunteers, then the volunteer could repay those hours to the organization in exchange for the reward.

!!!Businesses

Like non-profit organizations, businesses can track personnel activity and other resources using Ripplepay. Businesses can also accept Ripplepay in exchange for their products.

There are some interesting ways for businesses to use Ripplepay. On top of simple transactions like customers trading Ripplepay credit for products, a business can use Ripplepay to offer and manage customer credit, or to borrow and manage credit with suppliers.

Ripple can enable businesses to avoid taking out bank loans at interest to pay some of their bills while waiting to collect on others.

!!!Co-ops

Any form of co-operative entity such as housing co-ops, production co-ops, intentional communities, and so on, can track their community involvement using Ripplepay. For instance, this could include bills for food or rent, hours for chores, and any other resources.

!!!An integrated example

Jane buys her groceries at the local food cooperative, and makes a Ripple payment in the store. The Ripple routing system finds that the food coop has a balance owing at the local hardware store where they buy maintenance supplies. The hardware store in turn has an outstanding bill with the lawyer up the street. Jane often does landscaping for the lawyer on credit. To complete Jane's payment to the food coop, the Ripple system reduces the food coop's bill at the hardware store, the hardware store's debt to the lawyer, and finally the lawyer's debt to Jane. Jane walks out with her groceries.

to:
[[#Buy_Sell]]
Buy and sell using Ripple

[[ripplexchange.com|Ripplexchange]] is a new website where you can find offers and requests of goods that you can pay with Ripple.

[[#Questions]]
October 23, 2010, at 04:14 PM by Romualdo Grillo -
Changed line 44 from:
*[[#Adjust_settings]]
to:
[[#Adjust_settings]]
October 23, 2010, at 04:12 PM by Romualdo Grillo -
Deleted lines 2-3:
This guide describes the use of Ripple for communities of individuals, businesses, non-profits, co-ops, and any other organizations that make financial transactions. The guide does not require any understanding of the technical development or jargon of Ripple. Instead, it describes actual use of Ripple for anyone.
Changed lines 14-15 from:
[[Scenarios|Integration_Scenarios]]
to:
[[#Scenarios|Integration Scenarios]]
Added line 20:
This guide describes the use of Ripple for communities of individuals, businesses, non-profits, co-ops, and any other organizations that make financial transactions. The guide does not require any understanding of the technical development or jargon of Ripple. Instead, it describes actual use of Ripple for anyone.
Deleted lines 21-23:

The main functions in Ripplepay are to '''create accounts''' for users to interact with, to '''make connections''' between users, to '''adjust settings''' of those connections to reflect the actual users, and to '''make transactions''' over those user connections or '''credit chains'''. We will look at each of these functions in the sections below, and then we will study the most common '''integration scenarios'''.

October 23, 2010, at 04:09 PM by Romualdo Grillo -
Changed lines 16-17 from:
*[[#Questions|Questions]]
to:
[[Scenarios|Integration_Scenarios]]
[[#Questions|Questions]]
Changed lines 77-78 from:
!!!!Integration scenarios
to:

[[#Add_buttons]]
!!Add buttons to your site

You can freely add Ripple buttons to your site to let people pay you through Ripple. Buttons are easy to add, in a variety of styles:

[@<div style="text-align: center;">
<a href="https://ripplepay.com/payUser/vavrek/">
<img border="0" src="https://ripplexchange.com/download/file.php?id=4><br>
Donate to Vavrek<br>
vavrek@vavrek.com</a></div>@]

http://www.ripplexchange.com/images/buttons/rippledonate64.png

http://www.ripplexchange.com/images/buttons/ripplepay64.png

A complete list of Ripple buttons is available [[https://ripplexchange.com/viewtopic.php?f=6&t=9|here]].

[[#Scenarios]]

!!Integration scenarios
Changed lines 100-101 from:
!!!!Individual users
to:
!!!Individual users
Deleted lines 123-138:
[[#Add_buttons]]
!!Add buttons to your site

You can freely add Ripple buttons to your site to let people pay you through Ripple. Buttons are easy to add, in a variety of styles:

[@<div style="text-align: center;">
<a href="https://ripplepay.com/payUser/vavrek/">
<img border="0" src="https://ripplexchange.com/download/file.php?id=4><br>
Donate to Vavrek<br>
vavrek@vavrek.com</a></div>@]

http://www.ripplexchange.com/images/buttons/rippledonate64.png

http://www.ripplexchange.com/images/buttons/ripplepay64.png

A complete list of Ripple buttons is available [[https://ripplexchange.com/viewtopic.php?f=6&t=9|here]].
October 23, 2010, at 04:01 PM by Romualdo Grillo - Changed links in section "Questions"
Changed lines 123-125 from:
Frequently asked questions are answered on the [[FAQ]] page. Please send any questions to [[mailto:info@ripplepay.com|info@ripplepay.com]].

This wiki contains more
[[Main/Concept | discussion of the Ripple concept]], including [[Main/VideosPresentationsSchemes | videos & presentations]].
to:
If you have question you may search the [[Main/FAQ#FAQ_Using_Ripplepay |FAQs about using_Ripplepay]], discuss it on the [[http://ripple-project.org/Main/UsersGuide|User's Group]] or send an email to [[mailto:info@ripplepay.com|info@ripplepay.com]].
October 23, 2010, at 03:38 PM by Romualdo Grillo -
Deleted lines 14-15:
*[[#|]]
*[[#|]]
October 23, 2010, at 03:11 PM by Romualdo Grillo -
Added line 14:
*[[#Credit_chains|Credit chains]]
Changed lines 22-23 from:
To use Ripple, all you need is a free Ripplepay account. The steps in this guide will show you how to use all the functions in Ripplepay, and then we'll look at the bigger picture in effectively integrating these functions into your regular processes.
to:
To use Ripple, all you need is a free [[https://ripplepay.com/|Ripplepay]] account. The steps in this guide will show you how to use all the functions in Ripplepay, and then we'll look at the bigger picture in effectively integrating these functions into your regular processes.
Added lines 61-62:

[[#Make_transactions]]
Changed lines 74-75 from:
!!Credit chains
to:
!!!!Credit chains
Changed lines 78-79 from:
!!Integration scenarios
to:
!!!!Integration scenarios
Changed line 82 from:
!!!Individual users
to:
!!!!Individual users
October 23, 2010, at 02:59 PM by Romualdo Grillo - Added Index Created Two main sections "Setup Account" and "Use Account"
Added lines 5-18:
[[#Overview|Overview]]

[[#Create_account_and_connections|Create and setup your account]]
*[[#Create_accounts|Create accounts]]
*[[#Make_connections|Make connections]]
*[[#Adjust_settings|Adjust settings]]

[[#Use_your_account|Use your account]]
*[[#Make_transactions|Make transactions]]
*[[#|]]
*[[#|]]
*[[#Add_buttons|Add buttons to your site]]
*[[#Questions|Questions]]

Changed lines 21-22 from:
Ripple is an open user-powered payment system design. To use it, all you need is a free Ripplepay account. The steps in this guide will show you how to use all the functions in Ripplepay, and then we'll look at the bigger picture in effectively integrating these functions into your regular processes.
to:
To use Ripple, all you need is a free Ripplepay account. The steps in this guide will show you how to use all the functions in Ripplepay, and then we'll look at the bigger picture in effectively integrating these functions into your regular processes.
Changed lines 25-26 from:
!!Create accounts
to:

[[#Create_account_and_connections]]
!!Create your account and your connections

[[#Create_account]]
!!!Create your account

Changed lines 34-35 from:
!!Make connections
to:
[[#Make_connections]]
!
!!Make connections
Changed lines 47-48 from:
!!Adjust settings
to:
*[[#Adjust_settings]]
!
!!Adjust settings
Deleted lines 51-60:
!!Make transactions

Now that you have a connection with another user, you're ready to make an exchange! In order to pay someone or borrow money, you have to have credit available with that user. In order to receive payment from or lend money to someone, that user has to have credit available with you. In any case, the credit can either be directly with you through a connection established (as above), or indirectly through a chain of credit intermediaries.

To make a payment to a user who has extended you credit, simply log in to your account and open the [[https://ripplepay.com/payments/|payments]] page, then click the link to [[https://ripplepay.com/paymentForm/|pay another user]]. On the page that opens, enter your payment information: recipient, amount, and memo.

You can also have Ripplepay fill in the recipient's account automatically by clicking the payment link directly from that user's connection page in your account.

For someone else to pay you, that user would perform the same steps and fill in ''your'' account.

Changed lines 54-55 from:
Ripplepay also allows you to look at a history of your past payments, and to edit your profile (including contact information, default display units, enabling or disabling automatic currency conversion, and other settings). You can enter multiple e-mail addresses to receive payments.
to:
Ripplepay also allows you to look at a history of your past payments, and to edit your profile (including contact information, default display units, enabling or disabling automatic currency conversion, and other settings).



[[#Use_your_account]]
!!Use your account
!!!Make transactions

Now that you have a connection with another user, you're ready to make an exchange! In order to pay someone or borrow money, you have to have credit available with that user
. In order to receive payment from or lend money to someone, that user has to have credit available with you. In any case, the credit can either be directly with you through a connection established (as above), or indirectly through a chain of credit intermediaries.

To make a payment to a user who has extended you credit, simply log in to your account and open the [[https://ripplepay.com/payments/|payments]] page, then click the link to [[https://ripplepay.com/paymentForm/|pay another user]]. On the page that opens, enter your payment information: recipient, amount, and memo.

You can also have Ripplepay fill in the recipient's account automatically by clicking the payment link directly from that user's connection page in your account.

For someone else to pay you, that user would perform the same steps and fill in ''your'' account.


Added line 103:
[[#Add_buttons]]
Added lines 1-2:
''This page needs editing for conciseness, completeness, and clarity.  It should be a step-by-step introduction to how to use Ripplepay, and what you accomplish by doing so.''
Added lines 96-97:

This wiki contains more [[Main/Concept | discussion of the Ripple concept]], including [[Main/VideosPresentationsSchemes | videos & presentations]].
October 17, 2010, at 08:20 PM by Ryan - moved from "Use"
Added lines 1-93:
This guide describes the use of Ripple for communities of individuals, businesses, non-profits, co-ops, and any other organizations that make financial transactions. The guide does not require any understanding of the technical development or jargon of Ripple. Instead, it describes actual use of Ripple for anyone.

!!Overview

Ripple is an open user-powered payment system design. To use it, all you need is a free Ripplepay account. The steps in this guide will show you how to use all the functions in Ripplepay, and then we'll look at the bigger picture in effectively integrating these functions into your regular processes.

The main functions in Ripplepay are to '''create accounts''' for users to interact with, to '''make connections''' between users, to '''adjust settings''' of those connections to reflect the actual users, and to '''make transactions''' over those user connections or '''credit chains'''. We will look at each of these functions in the sections below, and then we will study the most common '''integration scenarios'''.

!!Create accounts

To create an account, open the Ripplepay [[https://ripplepay.com/register/|sign-up]] page, and fill in your contact details. You can optionally select a default unit if most of your dealings will be in a particular currency. Once you register, you will receive a confirmation e-mail that will check your contact information.

!!Make connections

For a user to conduct any transactions in Ripplepay, the user must first create connections. Ripple makes transactions between connections, i.e. connected peers transmit the payments between each other -- a peer-to-peer (p2p) system.

To connect to another user, log in to your account, and from the [[https://ripplepay.com/summary/|main account]] page enter the other user's e-mail address in the section marked @@Connect to more people@@.

On the next page, you are prompted to enter the maximum amount of credit you will extend to the other user, as well as the unit of account (currency) and interest rate. The amount you enter here will be the maximum amount this user can pay you overall through Ripplepay. For instance, if you set it to $150, then the other user could pay you up to $150. Note that this total includes payments sent from the other user through your account, not just the payments from the other user directly to you.

If you set an interest rate other than 0%, then any balance owed to you by the other user will automatically collect interest at the rate you set.

For the connection to be established, ''the other user has to accept your credit offer''.

!!Adjust settings

Once you have established a connection with another user, you can always go back and edit the settings. To do so, log in to your Ripplepay account and open the [[https://ripplepay.com/accounts/|connections]] page. Find the account you want to adjust, and click the account name or the details link. The next page will show you the details of your connection with this user, and allow you to change settings such as the account name, interest rate, and maximum credit.

!!Make transactions

Now that you have a connection with another user, you're ready to make an exchange! In order to pay someone or borrow money, you have to have credit available with that user. In order to receive payment from or lend money to someone, that user has to have credit available with you. In any case, the credit can either be directly with you through a connection established (as above), or indirectly through a chain of credit intermediaries.

To make a payment to a user who has extended you credit, simply log in to your account and open the [[https://ripplepay.com/payments/|payments]] page, then click the link to [[https://ripplepay.com/paymentForm/|pay another user]]. On the page that opens, enter your payment information: recipient, amount, and memo.

You can also have Ripplepay fill in the recipient's account automatically by clicking the payment link directly from that user's connection page in your account.

For someone else to pay you, that user would perform the same steps and fill in ''your'' account.

!!Other functions

Ripplepay also allows you to look at a history of your past payments, and to edit your profile (including contact information, default display units, enabling or disabling automatic currency conversion, and other settings). You can enter multiple e-mail addresses to receive payments.

!!Credit chains

Credit connections can be chained together to allow payment throughout a community. So far you have seen direct payments without any intermediaries. Ripplepay also lets you make payments to users with whom you have not established a credit connection, ''as long as you are connected by credit intermediaries''. A credit intermediary is any user who is mutually connected to both the payer and payee. Payments can transact through a chain of numerous credit intermediaries to allow for general payment through Ripplepay. For a more detailed explanation of credit chains, including an illustrative diagram, see [[credit relationship]].

!!Integration scenarios

This section will document real-world situations to address specific issues.

!!!Individual users

Individual users can use Ripplepay accounts to track IOUs with friends, to buy and sell goods and services with their friends, and to make exchanges with any organizations that have Ripplepay accounts.

!!!Non-profit organizations

In addition to the uses individuals can make of Ripplepay, non-profit organizations can track resources such as volunteer hours using Ripplepay. To track volunteer hours, each volunteer would offer the organization credit in the number of hours available. The organization would then pay the volunteer those hours through Ripplepay for the actual hours worked by the volunteer. If the non-profit organization offers any products or services to reward volunteers, then the volunteer could repay those hours to the organization in exchange for the reward.

!!!Businesses

Like non-profit organizations, businesses can track personnel activity and other resources using Ripplepay. Businesses can also accept Ripplepay in exchange for their products.

There are some interesting ways for businesses to use Ripplepay. On top of simple transactions like customers trading Ripplepay credit for products, a business can use Ripplepay to offer and manage customer credit, or to borrow and manage credit with suppliers.

Ripple can enable businesses to avoid taking out bank loans at interest to pay some of their bills while waiting to collect on others.

!!!Co-ops

Any form of co-operative entity such as housing co-ops, production co-ops, intentional communities, and so on, can track their community involvement using Ripplepay. For instance, this could include bills for food or rent, hours for chores, and any other resources.

!!!An integrated example

Jane buys her groceries at the local food cooperative, and makes a Ripple payment in the store. The Ripple routing system finds that the food coop has a balance owing at the local hardware store where they buy maintenance supplies. The hardware store in turn has an outstanding bill with the lawyer up the street. Jane often does landscaping for the lawyer on credit. To complete Jane's payment to the food coop, the Ripple system reduces the food coop's bill at the hardware store, the hardware store's debt to the lawyer, and finally the lawyer's debt to Jane. Jane walks out with her groceries.

!!Add buttons to your site

You can freely add Ripple buttons to your site to let people pay you through Ripple. Buttons are easy to add, in a variety of styles:

[@<div style="text-align: center;">
<a href="https://ripplepay.com/payUser/vavrek/">
<img border="0" src="https://ripplexchange.com/download/file.php?id=4><br>
Donate to Vavrek<br>
vavrek@vavrek.com</a></div>@]

http://www.ripplexchange.com/images/buttons/rippledonate64.png

http://www.ripplexchange.com/images/buttons/ripplepay64.png

A complete list of Ripple buttons is available [[https://ripplexchange.com/viewtopic.php?f=6&t=9|here]].

!!Questions

Frequently asked questions are answered on the [[FAQ]] page. Please send any questions to [[mailto:info@ripplepay.com|info@ripplepay.com]].