Skip to main content

​
Overview

Phinite’s Braintree predefined tool lets workspace assistants call Braintree APIs through DevStudio after you save a connection under Integrations → Predefined tools. Interact with the Braintree (PayPal) GraphQL API — run GraphQL queries/mutations plus convenience operations for transactions and customers.
Predefined tools require a saved connection before they appear in Graph Studio’s tool picker. See Predefined Tools in GraphStudio.

​
What this integration enables

  • Automate workflows using this predefined tool from agent graphs
  • Connect once under Integrations and reuse across assistants
  • Enable individual subtools per agent in Graph Studio

​
Required credentials

  • Public Key public_key (required)
  • Private Key private_key (required)
  • Environment environment (optional)
  • API Version api_version (optional)

​
Setup steps

  1. Create a Braintree sandbox account at braintreepayments.com.
  2. In the Control Panel go to Settings → API and generate API keys.
  3. Copy the public key, private key, and set environment to sandbox or production.
  4. Log into your Phinite workspace at app.phinite.ai
  5. Navigate to Integrations → Predefined tools
  6. Select Braintree
  7. Click + Add Configuration
  8. Enter the credential fields listed above
  9. Select assistants that should use this connection
  10. Click Save Configuration

​
Configure in Graph Studio

  1. Open an agent in Graph Studio
  2. Select the agent node → Tools tab → Add a new tool
  3. Choose BraintreeTool (or search for Braintree)
  4. Select your saved connection or add a new one
  5. Enable the subtools your workflow needs and save

​
Predefined tools

Phinite provides 7 subtools for Braintree:
  • Execute Graphql: Run an arbitrary Braintree GraphQL query or mutation with optional variables.
  • Ping: Connectivity/auth check (GraphQL ping).
  • Create Transaction: Charge a stored payment method. Requires payment_method_id and amount.
  • Find Transaction: Fetch a transaction by its node id.
  • Refund Transaction: Refund a settled transaction. Optionally provide a partial amount.
  • Create Customer: Create a customer. Pass an input object (firstName, lastName, email, …).
  • Find Customer: Fetch a customer by its node id.

​
Documentation & resources

  • Official documentation: https://developer.paypal.com/braintree/docs
  • Phinite documentation: Braintree

​
Notes

  • Store API keys and tokens securely; many providers show secrets only once
  • Use separate connections for Dev, UAT, and Prod environments where possible
  • Test with a minimal subtool call after saving credentials