Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.trymaven.com/llms.txt

Use this file to discover all available pages before exploring further.

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

1

Log in to Braintree

Go to Braintree Control Panel and log in.
2

Navigate to API Keys

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

Copy Credentials

Under API Keys, you’ll see your:
  • Merchant ID
  • Public Key
  • Private Key (click “View” to reveal)

Connecting in Maven

1

Go to Payments

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

Click Connect Braintree

Click the Braintree card and enter your credentials.
3

Enter Credentials

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

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

FieldDescription
braintree_transaction_idTransaction ID
braintree_customer_idCustomer ID
braintree_payment_method_tokenPayment method token
card_brandCard brand
card_last4Last 4 digits

Tokenize Mode (Vault)

FieldDescription
braintree_customer_idVault Customer ID
braintree_payment_method_tokenPayment Method Token
card_brandCard brand
card_last4Last 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,
    },
})