Braintree Status: How to Check If Braintree Is Down Right Now (2026)

The Official Braintree Status Page

Braintree maintains an official status page at status.braintreepayments.com that tracks availability for Braintree's payment processing infrastructure. Components covered include:

What Each Braintree Status Means

Braintree Gateway vs API: What's the Difference?

Braintree separates "Gateway" and "API" status because they represent different layers of the payment stack. Understanding the distinction helps you diagnose payment failures faster.

Braintree Error Codes During Outages

During Braintree outages or partial degradation, your integration will see specific error patterns. These help distinguish platform outages from individual transaction declines.

Sandbox vs Production: A Critical Distinction

Check Braintree Status Programmatically

You can test Braintree API health from your own infrastructure. A simple approach is to attempt a low-cost API call and check the response:

# Check Braintree status page API
curl -s https://status.braintreepayments.com/api/v2/status.json \
  | python3 -c "import sys,json; d=json.load(sys.stdin); print(d['status']['indicator'])"

# Test Braintree API connectivity (production)
# Uses gateway ping — replace with your merchant ID and keys
curl -s -o /dev/null -w "%{http_code}" \
  -u "$BT_PUBLIC_KEY:$BT_PRIVATE_KEY" \
  "https://api.braintreegateway.com/merchants/$BT_MERCHANT_ID/transactions"

# 401 = API is reachable but credentials invalid (expected without real creds)
# 503/504 = API is down
# Connection refused = network issue or full outage

// Node.js: Test Braintree gateway health
const braintree = require('braintree');

const gateway = new braintree.BraintreeGateway({
  environment: braintree.Environment.Production,
  merchantId: process.env.BT_MERCHANT_ID,
  publicKey: process.env.BT_PUBLIC_KEY,
  privateKey: process.env.BT_PRIVATE_KEY,
});

async function checkBraintreeHealth() {
  try {
    // Attempt a ClientToken generate — lightweight API call
    await gateway.clientToken.generate({});
    return { status: 'ok' };
  } catch (err) {
    // BraintreeServiceError = API reachable but service issue
    // Network error = API unreachable (outage)
    return { status: 'error', message: err.message };
  }
}

What to Do When Braintree Is Down

Setting Up Braintree Monitoring

For production Braintree integrations, you need monitoring that goes beyond the official status page:

Braintree Outage History: How Reliable Is It?

Braintree is a PayPal subsidiary and one of the more mature payment gateways available to developers. Its uptime track record is strong — major outages affecting the payment gateway are rare. The more common incidents involve:

Frequently Asked Questions

Related Guides