Testing and Go Live

Try out your fraud tools integration in the sandbox with these test values:

You can use the following test card number in the sandbox to simulate Premium Fraud Management Tools flagging a transaction as pending review. This feature is only available for Fraud Protection Advanced.
Card TypeTest ValueStatusDecision
Visa4111140000000002authorizedReview
You can use the following test card numbers in the sandbox to simulate Premium Fraud Management Tools or risk threshold rules rejecting a request.
Card TypeTest ValueStatusReason
Visa4000111111111511gateway_rejectedfraud
Visa4111130000000003gateway_rejectedrisk_threshold

The following payment method nonces represent payment methods that will be gateway rejected by Braintree's various fraud tools.

NonceDescription
fake-gateway-rejected-kount-nonce A nonce representing a card that will be gateway rejected by Kount. The fake-gateway-rejected-kount-nonce will only work if Premium Fraud Management Tools are enabled.
fake-gateway-rejected-risk-thresholds-nonce A nonce representing a card that will be gateway rejected by your risk threshold rules. The fake-gateway-rejected-risk-thresholds-nonce will only work if at least one risk threshold rule is enabled

Go liveAnchorIcon

Create an API userAnchorIcon

Production API credentials, including your API keys, must be entered into your server-side code to connect API calls to the Braintree gateway. While each user in your gateway has their own unique set of API keys, only one set can be included in your integration.

We do not recommend including an individual user's API credentials. If you ever need to delete or suspend that user, this could break your connection to Braintree and result in failed transactions.

Instead, create a new user specifically designated as the API user, whose API keys can be used for your integration. This user should be set up with an email address that is not associated with a single employee and should have Account Admin permissions in order to avoid issues such as an authorization error.

Get production credentialsAnchorIcon

Log into your production account as the API user to obtain your API credentials. You'll need the:

  • Production merchant ID
  • Production public key
  • Production private key

Keep in mind that public and private keys are both environment- and user-specific.

Update production account settingsAnchorIcon

Make sure your production account settings mirror the ones in your tested sandbox configuration. Be sure to recreate any recurring billing plans or settings if you plan to use recurring billing in production.

Update live server configurationAnchorIcon

In your server code, update your configuration to production values:

  1. Ruby
gateway = Braintree::Gateway.new(
    :environment => :production,
    :merchant_id => "use_your_merchant_id",
    :public_key => "use_your_public_key",
    :private_key => "use_your_private_key",
);
Once you have updated these values and configured your preferred processing settings, the live production environment will function similarly to the sandbox environment you've been using for development. Learn more about the differences between production and the sandbox.

On the client side, no configuration updates are needed when you make the switch to production – your client obtains its client token from your server, which is all the configuration it needs.

Test transactions in productionAnchorIcon

It is important to test your production account by creating a couple of low-value sale transactions for each of the payment method types you plan to accept. Be sure to submit the transactions for settlement, and then confirm that the funds have deposited into your bank account. This typically happens a few days after they have settled.

Keep in mind that if you run too many test transactions in a short period of time, your Premium Fraud Management Tools may start gateway rejecting the transactions due to fraud concerns. To avoid this, do not use more than two different card numbers to test your production account from the same IP address.