Automatically sending a PayPal payment with Ruby


I found that Chang Sau Sheong’s ruby-paypal library can use Mass Payment ( to automatically send money to any PayPal recipient. What’s confusing is that the RDoc on the site is from an older version that did not support Mass Payment.

Some older (2006) threads mention they want this, but they were never resolved. I hope this information will be useful to people that still don’t have the answer to this.

== Unofficial guide to sending automatic payments with Ruby

  1. gem install ruby-paypal
  2. require ‘ruby-paypal’ at the top of your file
  3. Use this example code for a single transaction or create your own:

Credentials found in environment files.


		# def do_mass_payment(payments, email_subject, receiver_type='EmailAddress', currency_code='USD')

		payments = []

		payments[0] =

		payments[0].email =

		payments[0].unique_id = 1239829

		payments[0].note = "Note"

		payments[0].amount =

		# Make the call.

		response = pp_nvp.do_mass_payment(payments, "Email subject line")

		# Update our own administration.

		if response.ack == 'Success'

			# Do success stuff here


A sidenote:

I could not get the ruby-paypal and the paypal (by Tobias Luetke) gem to work on the same Rails installation - they both use a class called Paypal. I fixed this by including ruby-paypal in my vendor/ dir and renaming the class Paypal to PaypalNVP. The Money library is included with the ‘paypal’ (NOT the ruby-paypal) gem.