Connecting Braintree

Maven connects to Braintree using your Merchant ID, Public Key, and Private Key. These credentials allow Maven to create transactions and vault customers on your behalf.

Prerequisites

A Braintree merchant account
Merchant ID, Public Key, and Private Key
A Maven app

Getting Your Credentials

Go to Braintree Control Panel and log in.

Navigate to API Keys

Click the gear icon (Settings) in the top right, then click API.

Copy Credentials

Under API Keys, you’ll see your:

Merchant ID
Public Key
Private Key (click “View” to reveal)

Connecting in Maven

Go to Payments

In the Maven Dashboard, navigate to your app and click the Payments tab.

Click Connect Braintree

Click the Braintree card and enter your credentials.

Enter Credentials

Merchant ID: Your Braintree Merchant ID
Public Key: Your Braintree Public Key
Private Key: Your Braintree Private Key

Save

Click Connect. Maven will validate the credentials and save them.

Sandbox Testing

For testing, use Braintree Sandbox credentials. Create a sandbox account at braintreepayments.com/sandbox. Use sandbox credentials with mvn_test_ API keys to test without real charges.

Processor Response Fields

Charge Mode

Field	Description
`braintree_transaction_id`	Transaction ID
`braintree_customer_id`	Customer ID
`braintree_payment_method_token`	Payment method token
`card_brand`	Card brand
`card_last4`	Last 4 digits

Tokenize Mode (Vault)

Field	Description
`braintree_customer_id`	Vault Customer ID
`braintree_payment_method_token`	Payment Method Token
`card_brand`	Card brand
`card_last4`	Last 4 digits

Using Tokenized Cards

After tokenizing, use the vault token to create transactions via the Braintree SDK:

import braintree

result = braintree.Transaction.sale({
    "amount": "49.99",
    "payment_method_token": "abc123",  # from braintree_payment_method_token
    "options": {
        "submit_for_settlement": True,
    },
})

​Connecting Braintree

​Prerequisites

​Getting Your Credentials

​Connecting in Maven

​Sandbox Testing

​Processor Response Fields

​Charge Mode

​Tokenize Mode (Vault)

​Using Tokenized Cards