Payments Basic Auth

Braintree REST API

Payment gateway for online and mobile commerce

Braintree is a full-stack payment platform that enables businesses to accept payments online and in mobile apps. It provides a single integration for credit cards, PayPal, Venmo, Apple Pay, Google Pay, and other payment methods. Developers use Braintree for its robust fraud protection, extensive payment method support, and seamless checkout experiences.

Base URL https://api.braintreegateway.com

API Endpoints

Method	Endpoint	Description
POST	`/merchants/{merchant_id}/transactions`	Create a new transaction to process a payment
GET	`/merchants/{merchant_id}/transactions/{transaction_id}`	Retrieve details of a specific transaction
POST	`/merchants/{merchant_id}/transactions/{transaction_id}/refund`	Refund a settled transaction
POST	`/merchants/{merchant_id}/transactions/{transaction_id}/void`	Void an unsettled transaction
POST	`/merchants/{merchant_id}/customers`	Create a new customer record in the vault
GET	`/merchants/{merchant_id}/customers/{customer_id}`	Retrieve a customer and their stored payment methods
PUT	`/merchants/{merchant_id}/customers/{customer_id}`	Update customer information
DELETE	`/merchants/{merchant_id}/customers/{customer_id}`	Delete a customer from the vault
POST	`/merchants/{merchant_id}/payment_methods`	Create a new payment method for a customer
DELETE	`/merchants/{merchant_id}/payment_methods/{token}`	Delete a stored payment method
POST	`/merchants/{merchant_id}/subscriptions`	Create a recurring subscription
PUT	`/merchants/{merchant_id}/subscriptions/{subscription_id}`	Update an existing subscription
POST	`/merchants/{merchant_id}/subscriptions/{subscription_id}/cancel`	Cancel a subscription
GET	`/merchants/{merchant_id}/disputes/{dispute_id}`	Retrieve details of a payment dispute
POST	`/merchants/{merchant_id}/client_token`	Generate a client token for client-side authorization

Code Examples

curl -X POST https://api.braintreegateway.com/merchants/your_merchant_id/transactions \
  -u public_key:private_key \
  -H 'Content-Type: application/xml' \
  -d '<?xml version="1.0" encoding="UTF-8"?>
<transaction>
  <type>sale</type>
  <amount>10.00</amount>
  <payment-method-nonce>fake-valid-nonce</payment-method-nonce>
  <options>
    <submit-for-settlement>true</submit-for-settlement>
  </options>
</transaction>'

const braintree = require('braintree');

const gateway = new braintree.BraintreeGateway({
  environment: braintree.Environment.Sandbox,
  merchantId: 'your_merchant_id',
  publicKey: 'your_public_key',
  privateKey: 'your_private_key'
});

gateway.transaction.sale({
  amount: '10.00',
  paymentMethodNonce: 'fake-valid-nonce',
  options: {
    submitForSettlement: true
  }
}, (err, result) => {
  if (result.success) {
    console.log('Transaction ID: ' + result.transaction.id);
  } else {
    console.error(err);
  }
});

import braintree

gateway = braintree.BraintreeGateway(
    braintree.Configuration(
        environment=braintree.Environment.Sandbox,
        merchant_id='your_merchant_id',
        public_key='your_public_key',
        private_key='your_private_key'
    )
)

result = gateway.transaction.sale({
    'amount': '10.00',
    'payment_method_nonce': 'fake-valid-nonce',
    'options': {
        'submit_for_settlement': True
    }
})

if result.is_success:
    print(f'Transaction ID: {result.transaction.id}')
else:
    print(f'Error: {result.message}')

Connect Braintree to AI

Deploy a Braintree MCP server on IOX Cloud and connect it to Claude, ChatGPT, Cursor, or any AI client. Your AI assistant gets direct access to Braintree through these tools:

process_payment Process a one-time payment transaction with amount, payment method, and customer details

create_subscription Set up a recurring subscription with specified plan, payment method, and billing cycle

refund_transaction Issue a full or partial refund for a settled transaction

manage_customer_vault Create, update, or retrieve customer records and stored payment methods in the vault

handle_dispute Retrieve dispute information and submit evidence for chargebacks

Deploy in 60 seconds

Describe what you need, AI generates the code, and IOX deploys it globally.

Deploy Braintree MCP Server →

Braintree REST API

API Endpoints

Code Examples

Connect Braintree to AI

Deploy in 60 seconds

Related APIs