Skip to content
A Braintree fake so that you can avoid hitting Braintree servers in tests.
Find file
New pull request
Pull request Compare This branch is 284 commits behind highfidelity:master.
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

fake_braintree, a Braintree fake Build Status

This library is a way to test Braintree code without hitting Braintree's servers. It uses Capybara::Server to intercept all of the calls from Braintree's Ruby library and returns XML that the Braintree library can parse. The whole point is not to hit the Braintree API.

Currently in alpha (i.e. it does not support every Braintree call).

Supported API methods


  • Braintree::Customer.find
  • Braintree::Customer.create
  • Braintree::Customer.update
  • Braintree::Customer.delete


  • Braintree::Subscription.find
  • Braintree::Subscription.create
  • Braintree::Subscription.update


  • Braintree::CreditCard.find




  • Braintree::TransparentRedirect.url
  • Braintree::TransparentRedirect.confirm (only for creating customers)

Quick start

Just require the library and you're good to go:

require 'fake_braintree'

FakeBraintree.clear! will clear all data, which you almost certainly want to do before each test.

Full example:

# spec_helper.rb
require 'fake_braintree'

RSpec.configure do |c|
  c.before do

If you're using Cucumber, add this too:

# env.rb
require 'fake_braintree'

Before do

Verifying credit cards

To verify every credit card you try to use, call:


This will stay "on" until you set

FakeBraintree.verify_all_cards = false

Calling FakeBraintree.clear! will not change this setting. It does very basic verification: it only matches the credit card number against these: and rejects them if they aren't one of the listed numbers.

Declining credit cards

To decline every card you try, call:


This will decline all cards until you call


This behavior is different from FakeBraintree.verify_all_cards, which will stay on even when clear! is called.

Note that after decline_all_cards! is set, Braintree will still create customers, but will not be able to charge them (so charging for e.g. a subscription will fail). Setting verify_all_cards!, on the other hand, will prevent creation of customers with bad credit cards - Braintree won't even get to trying to charge them.

Generating transactions

You can generate a transaction using FakeBraintree.generate_transaction. This is for use in testing, e.g. before { user.transaction = FakeBraintree.generate_transaction }.

It takes the following options:

  • :subscription_id: the ID of the subscription associated with the transaction.
  • :created_at: when the transaction was created (defaults to
  • :amount: the amount of the transaction
  • :status: the status of the transaction, e.g. Braintree::Transaction::Status::Failed

Any or all of these can be nil, and in fact are nil by default. You can also call it with no arguments.

Full example:

transaction = FakeBraintree.generate_transaction(:amount => '20.00',
                                                 :status => Braintree::Transaction::Status::Settled,
                                                 :subscription_id => 'foobar',
                                                 :created_at => + 60)
p transaction
# {
#   "status_history" =>
#     [{
#       "timestamp"  => 2011-11-20 12:57:25 -0500,
#       "amount"     => "20.00",
#       "status"     => "settled",
#       "created_at" => 2011-11-20 12:58:25 -0500
#     }],
#   "subscription_id" => "foobar"
# }
Something went wrong with that request. Please try again.