> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Braintree

The Braintree connector lets your AI agent act in each user's Braintree account. Each user connects their own Braintree API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 27 tools.

**Authentication:** API Keys
**Categories:** Accounting & Finance
**Tools:** 27: 13 read, 7 write, 7 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=BRAINTREE)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Braintree connection

   In **AgentKit > Connections**, create a Braintree connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'braintree_customer_get',
  toolInput: {
    customer_id: '<customer_id>',
  },
  connector: 'braintree',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="braintree_customer_get",
    tool_input={
        "customer_id": "<customer_id>",
    },
    connection_name="braintree",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `braintree_customer_get`

Get Customer · Read-only

Get one Braintree vault customer by GraphQL ID, with their vaulted payment methods.
Returns the customer's id, legacyId, name, email, company, phone, website, custom fields, default payment method and payment methods.
Use Search Customers to find a customer by email.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`string`, required): Braintree GraphQL ID of the customer (not the legacy ID shown in the Control Panel; convert one with Get ID From Legacy ID). Get it from Search Customers. Example: Y3VzdG9tZXJfYWJjMTIz.

Example input: `{"customer_id":"<customer_id>"}`

### `braintree_customers_search`

Search Customers · Read-only

Search Braintree vault customers by ID, email, name, company, phone or creation date, with cursor paging.
Returns pageInfo and customers with id, legacyId, name, email, company, phone, custom fields, default payment method and vaulted payment methods.
Use Get Customer when you have the customer ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `after` (`string`, optional): Cursor to continue after: the pageInfo.endCursor of the previous page. Example: YXJyYXljb25uZWN0aW9uOjI0.
- `criteria` (`object`, optional): Search criteria as a Braintree CustomerSearchInput object. Keys: id {is | in}, email, firstName, lastName, company, phoneNumber as text matches {is | isNot | startsWith | endsWith | contains}, createdAt {greaterThanOrEqualTo, lessThanOrEqualTo}. Pass {} for no filter. Example: {"email": {"is": "jane@example.com"}}.
- `first` (`integer`, optional): Number of results to return, 1 to 50. Example: 25. Default: `25`.

Example input: `{}`

### `braintree_dispute_get`

Get Dispute · Read-only

Get one Braintree dispute by GraphQL ID.
Returns the dispute's id, status, type, caseNumber, referenceNumber, receivedDate, replyByDate, amounts, transaction, evidence and status history.
Use Search Disputes to find open disputes.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `dispute_id` (`string`, required): Braintree GraphQL ID of the dispute (not the legacy ID shown in the Control Panel; convert one with Get ID From Legacy ID). Get it from Search Disputes. Example: ZGlzcHV0ZV9hYmMxMjM.

Example input: `{"dispute_id":"<dispute_id>"}`

### `braintree_disputes_search`

Search Disputes · Read-only

Search Braintree disputes (chargebacks, retrievals, pre-arbitration) by status, type, reason, dates and amounts, with cursor paging.
Returns pageInfo and disputes with id, status, type, caseNumber, receivedDate, replyByDate, amountDisputed, amountWon, transaction and evidence.
Use Get Dispute for one dispute.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `after` (`string`, optional): Cursor to continue after: the pageInfo.endCursor of the previous page. Example: YXJyYXljb25uZWN0aW9uOjI0.
- `criteria` (`object`, optional): Search criteria as a Braintree DisputeSearchInput object. Common keys: id {is | in}, status {in: [OPEN, ACCEPTED, DISPUTED, WON, LOST, EXPIRED, ...]}, type {in: [CHARGEBACK, PRE_ARBITRATION, RETRIEVAL]}, receivedDate and replyByDate {greaterThanOrEqualTo, lessThanOrEqualTo} as dates, transaction {transactionId {is}}. Pass {} for no filter. Example: {"status": {"in": ["OPEN"]}}.
- `first` (`integer`, optional): Number of results to return, 1 to 50. Example: 25. Default: `25`.

Example input: `{}`

### `braintree_legacy_id_convert`

Get ID From Legacy ID · Read-only

Convert a legacy Braintree ID (as shown in the Control Panel and the older SDKs) into the GraphQL ID the other tools need.
Returns the GraphQL ID.
Use this when you only have a Control Panel transaction, customer, refund, dispute or payment method ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `legacy_id` (`string`, required): Legacy ID from the Control Panel or SDK. Example: 8wb5v7nq.
- `type` (`string`, required): What the ID is for: TRANSACTION, CUSTOMER, REFUND, DISPUTE, PAYMENT_METHOD, RECURRING_BILLING_SUBSCRIPTION, RECURRING_BILLING_SUBSCRIPTION_PLAN, VERIFICATION and other Braintree legacy ID types. Example: TRANSACTION. One of: `CUSTOMER`, `DISPUTE`, `MERCHANT_ACCOUNT_APPLICATION`, `PAYMENT_CONTEXT`, `PAYMENT_METHOD`, `RECURRING_BILLING_SUBSCRIPTION`, `RECURRING_BILLING_SUBSCRIPTION_PLAN`, `RECURRING_BILLING_SUBSCRIPTION_PLAN_ADD_ON`, `RECURRING_BILLING_SUBSCRIPTION_PLAN_DISCOUNT`, `REFUND`, `TRANSACTION`, `US_BANK_ACCOUNT_VERIFICATION`, `VERIFICATION`.

Example input: `{"legacy_id":"<legacy_id>","type":"CUSTOMER"}`

### `braintree_payment_method_get`

Get Payment Method · Read-only

Get one vaulted Braintree payment method by its GraphQL ID.
Returns the payment method's id, legacyId, usage, createdAt, details type and customer.
Use Get Customer to list a customer's payment methods.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `payment_method_id` (`string`, required): Braintree GraphQL ID of the payment method (not the legacy ID shown in the Control Panel; convert one with Get ID From Legacy ID). Get it from Get Customer. Example: cGF5bWVudG1ldGhvZF9jY19hYmMxMjM.

Example input: `{"payment_method_id":"<payment_method_id>"}`

### `braintree_ping`

Ping · Read-only

Check that the Braintree connection and credentials work.
Returns the string pong.
Use this to test a new connection. Use Get Viewer for merchant details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `braintree_refunds_search`

Search Refunds · Read-only

Search Braintree refunds by status, date, amount, order ID or customer, with cursor paging.
Returns pageInfo and refunds with id, legacyId, createdAt, status, orderId, amount, refunded transaction and status history.
Use Refund Transaction to create a refund.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `after` (`string`, optional): Cursor to continue after: the pageInfo.endCursor of the previous page. Example: YXJyYXljb25uZWN0aW9uOjI0.
- `criteria` (`object`, optional): Search criteria as a Braintree RefundSearchInput object. Common keys: id {is | in}, status {in: [...]}, createdAt {greaterThanOrEqualTo, lessThanOrEqualTo}, amount {value {greaterThanOrEqualTo, lessThanOrEqualTo}}, orderId {is | contains}, customer {id {is}}. Pass {} for no filter. Example: {"createdAt": {"greaterThanOrEqualTo": "2026-01-01T00:00:00Z"}}.
- `first` (`integer`, optional): Number of results to return, 1 to 50. Example: 25. Default: `25`.

Example input: `{}`

### `braintree_subscription_plans_list`

List Subscription Plans · Read-only

List the recurring billing plans defined in the Braintree Control Panel.
Returns each plan's id, legacyId, name, description, price, billingFrequency, billingDayOfMonth, numberOfBillingCycles and trial.
Use this to interpret planId values on subscriptions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `braintree_subscriptions_search`

Search Subscriptions · Read-only

Search Braintree recurring billing subscriptions by status, plan, price, days past due, next billing date and more, with cursor paging.
Returns pageInfo and subscriptions with id, legacyId, status, planId, paymentMethodId, price, balance, billing cycle details, failureCount, daysPastDue and transactionIds.
Use List Subscription Plans to see plan IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `after` (`string`, optional): Cursor to continue after: the pageInfo.endCursor of the previous page. Example: YXJyYXljb25uZWN0aW9uOjI0.
- `criteria` (`object`, optional): Search criteria as a Braintree RecurringBillingSubscriptionSearchInput object. Common keys: id {is | in}, planId {is | in}, status as a list (ACTIVE, CANCELED, EXPIRED, PAST_DUE, PENDING), inTrialPeriod (true/false), daysPastDue and price {greaterThanOrEqualTo, lessThanOrEqualTo}, nextBillingDate {greaterThanOrEqualTo, lessThanOrEqualTo}. Pass {} for no filter. Example: {"status": ["PAST_DUE"]}.
- `first` (`integer`, optional): Number of results to return, 1 to 50. Example: 25. Default: `25`.

Example input: `{}`

### `braintree_transaction_get`

Get Transaction · Read-only

Get one Braintree transaction by its GraphQL ID.
Returns the transaction's id, legacyId, createdAt, status, orderId, amount, customer, payment method, refunds, disputes and status history.
Use Get ID From Legacy ID first if you only have the Control Panel ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `transaction_id` (`string`, required): Braintree GraphQL ID of the transaction (not the legacy ID shown in the Control Panel; convert one with Get ID From Legacy ID). Get it from Search Transactions. Example: dHJhbnNhY3Rpb25fYWJjMTIz.

Example input: `{"transaction_id":"<transaction_id>"}`

### `braintree_transactions_search`

Search Transactions · Read-only

Search Braintree transactions by status, date, amount, order ID, customer, payment method and more, with cursor paging.
Returns pageInfo and transactions with id, legacyId, createdAt, status, orderId, amount, customer, payment method, refunds, disputes and status history.
Use Get Transaction when you have the transaction ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `after` (`string`, optional): Cursor to continue after: the pageInfo.endCursor of the previous page. Example: YXJyYXljb25uZWN0aW9uOjI0.
- `criteria` (`object`, optional): Search criteria as a Braintree TransactionSearchInput object. Common keys: id {is | in}, status {in: [SETTLED, SUBMITTED_FOR_SETTLEMENT, AUTHORIZED, VOIDED, FAILED, ...]}, createdAt {greaterThanOrEqualTo, lessThanOrEqualTo} as ISO timestamps, amount {value {greaterThanOrEqualTo, lessThanOrEqualTo}}, orderId {is | contains}, customer {id {is}, email {is}}. Pass {} for no filter. Example: {"status": {"in": ["SETTLED"]}, "createdAt": {"greaterThanOrEqualTo": "2026-01-01T00:00:00Z"}}.
- `first` (`integer`, optional): Number of results to return, 1 to 50. Example: 25. Default: `25`.

Example input: `{}`

### `braintree_viewer_get`

Get Viewer · Read-only

Get the Braintree merchant and API user behind the connected API key.
Returns the merchant's id, companyName and merchant accounts, and the user's id, name and email.
Use this to confirm which merchant account and environment are connected.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `braintree_customer_create`

Create Customer · Write

Create a customer record in the Braintree vault.
Returns the new customer's id, legacyId and details.
This stores customer details only. Payment methods are vaulted through Braintree's client-side tokenization.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `company` (`string`, optional): Company name of the customer. Example: Acme Inc.
- `custom_fields` (`array`, optional): Custom field values, each with the name of a custom field defined in the Control Panel and a value. Example: [{"name": "loyalty_tier", "value": "gold"}].
- `email` (`string`, optional): Email address of the customer. Example: jane@example.com.
- `first_name` (`string`, optional): First name of the customer. Example: Jane.
- `last_name` (`string`, optional): Last name of the customer. Example: Doe.
- `phone_number` (`string`, optional): Phone number of the customer. Example: 312-555-1234.
- `website` (`string`, optional): Website URL of the customer. Example: https://acme.example.com.

Example input: `{}`

### `braintree_customer_update`

Update Customer · Write

Update a Braintree vault customer's name, email, company, phone, website or custom fields.
Returns the updated customer.
Only the fields you pass change.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`string`, required): Braintree GraphQL ID of the customer (not the legacy ID shown in the Control Panel; convert one with Get ID From Legacy ID). Get it from Search Customers. Example: Y3VzdG9tZXJfYWJjMTIz.
- `company` (`string`, optional): Company name of the customer. Example: Acme Inc.
- `custom_fields` (`array`, optional): Custom field values, each with the name of a custom field defined in the Control Panel and a value. Example: [{"name": "loyalty_tier", "value": "gold"}].
- `email` (`string`, optional): Email address of the customer. Example: jane@example.com.
- `first_name` (`string`, optional): First name of the customer. Example: Jane.
- `last_name` (`string`, optional): Last name of the customer. Example: Doe.
- `phone_number` (`string`, optional): Phone number of the customer. Example: 312-555-1234.
- `website` (`string`, optional): Website URL of the customer. Example: https://acme.example.com.

Example input: `{"customer_id":"<customer_id>"}`

### `braintree_dispute_finalize`

Finalize Dispute · Write

Finalize an OPEN Braintree dispute, submitting its evidence to the processor to contest it.
Returns the dispute with its new status.
After this no more evidence can be added. Add evidence first with Add Dispute Text Evidence.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `dispute_id` (`string`, required): Braintree GraphQL ID of the dispute (not the legacy ID shown in the Control Panel; convert one with Get ID From Legacy ID). Get it from Search Disputes. Example: ZGlzcHV0ZV9hYmMxMjM.

Example input: `{"dispute_id":"<dispute_id>"}`

### `braintree_dispute_text_evidence_create`

Add Dispute Text Evidence · Write

Add a piece of text evidence to an open Braintree dispute.
Returns the evidence's id, content, category and createdAt.
Add all evidence, then use Finalize Dispute to submit it. File evidence is not supported by this connector.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `content` (`string`, required): Evidence text, for example a tracking number or an explanation. Example: Delivered 2026-01-05, signed by J. Doe.
- `dispute_id` (`string`, required): Braintree GraphQL ID of the dispute (not the legacy ID shown in the Control Panel; convert one with Get ID From Legacy ID). Get it from Search Disputes. Example: ZGlzcHV0ZV9hYmMxMjM.
- `category` (`string`, optional): Evidence category Braintree requires for some dispute reasons, such as TRACKING_NUMBER, CARRIER_NAME or GENERAL. Example: TRACKING_NUMBER. One of: `AVS_RESPONSE`, `CARRIER_NAME`, `CREDIT_ISSUED_AMOUNT`, `CREDIT_ISSUED_ARN`, `CREDIT_ISSUED_DATE_TIME`, `DEVICE_ID`, `DEVICE_NAME`, `DOWNLOAD_DATE_TIME`, `GENERAL`, `GEOGRAPHICAL_LOCATION`, `PRIOR_DIGITAL_GOODS_TRANSACTION_ARN`, `PRIOR_DIGITAL_GOODS_TRANSACTION_DATE_TIME`, `PRIOR_DIGITAL_GOODS_TRANSACTION_ID`, `PRIOR_NON_DISPUTED_TRANSACTION_ARN`, `PRIOR_NON_DISPUTED_TRANSACTION_DATE_TIME`, `PRIOR_NON_DISPUTED_TRANSACTION_EMAIL_ADDRESS`, `PRIOR_NON_DISPUTED_TRANSACTION_ID`, `PRIOR_NON_DISPUTED_TRANSACTION_IP_ADDRESS`, `PRIOR_NON_DISPUTED_TRANSACTION_PHONE_NUMBER`, `PRIOR_NON_DISPUTED_TRANSACTION_PHYSICAL_ADDRESS`, `PURCHASER_EMAIL_ADDRESS`, `PURCHASER_IP_ADDRESS`, `PURCHASER_NAME`, `RECURRING_TRANSACTION_ARN`, `RECURRING_TRANSACTION_DATE_TIME`, `RECURRING_TRANSACTION_ID`, `REFUND_ID`, `TRACKING_NUMBER`.

Example input: `{"content":"<content>","dispute_id":"<dispute_id>"}`

### `braintree_payment_method_charge`

Charge Payment Method · Write

Charge a vaulted Braintree payment method and submit the sale for settlement.
Returns the new transaction's id, status, amount and details.
This takes real money in production. Set api_request_key so a retry cannot charge twice.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `amount` (`string`, required): Amount to charge as a decimal string. Example: 49.99.
- `payment_method_id` (`string`, required): GraphQL ID of a vaulted payment method (or a single-use payment method nonce). Get vaulted ones from Get Customer. Example: cGF5bWVudG1ldGhvZF9jY19hYmMxMjM.
- `api_request_key` (`string`, optional): Idempotency key: a unique string per intended operation, so a retried call is not applied twice. Example: refund-order-1234.
- `customer_id` (`string`, optional): GraphQL ID of the customer to associate. Example: Y3VzdG9tZXJfYWJjMTIz.
- `merchant_account_id` (`string`, optional): Merchant account to charge through, which sets the currency. Defaults to the merchant's default account. Example: acme_USD.
- `order_id` (`string`, optional): Your order ID for the charge. Example: order-1234.

Example input: `{"amount":"<amount>","payment_method_id":"<payment_method_id>"}`

### `braintree_transaction_capture`

Capture Transaction · Write

Submit an authorized Braintree transaction for settlement, in full or for a lower amount.
Returns the transaction's id, status and amount.
This moves the customer's money. Use Search Transactions with status AUTHORIZED to find authorizations.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `transaction_id` (`string`, required): Braintree GraphQL ID of the transaction (not the legacy ID shown in the Control Panel; convert one with Get ID From Legacy ID). Get it from Search Transactions. Example: dHJhbnNhY3Rpb25fYWJjMTIz.
- `amount` (`string`, optional): Amount to capture as a decimal string, up to the authorized amount. Leave empty to capture the full authorization. Example: 25.00.
- `api_request_key` (`string`, optional): Idempotency key: a unique string per intended operation, so a retried call is not applied twice. Example: refund-order-1234.

Example input: `{"transaction_id":"<transaction_id>"}`

### `braintree_transaction_refund`

Refund Transaction · Write

Refund a settled or settling Braintree transaction, in full or in part.
Returns the refund's id, legacyId, status, amount and refunded transaction.
This returns money to the customer. For a transaction not yet settled, use Void Transaction instead. Set api_request_key so a retry cannot refund twice.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `transaction_id` (`string`, required): Braintree GraphQL ID of the transaction (not the legacy ID shown in the Control Panel; convert one with Get ID From Legacy ID). Get it from Search Transactions. Example: dHJhbnNhY3Rpb25fYWJjMTIz.
- `amount` (`string`, optional): Amount to refund as a decimal string. Leave empty to refund the full settled amount. Example: 10.00.
- `api_request_key` (`string`, optional): Idempotency key: a unique string per intended operation, so a retried call is not applied twice. Example: refund-order-1234.
- `description` (`string`, optional): Description of the refund. Example: Damaged item.
- `order_id` (`string`, optional): Order ID to record on the refund. Example: order-1234-refund.

Example input: `{"transaction_id":"<transaction_id>"}`

### `braintree_customer_delete`

Delete Customer · Destructive

Delete a customer from the Braintree vault, unlinking it from its past transactions.
Returns clientMutationId on success.
Braintree refuses while the customer still has vaulted payment methods: remove them first with Delete Payment Method. This cannot be undone.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`string`, required): Braintree GraphQL ID of the customer (not the legacy ID shown in the Control Panel; convert one with Get ID From Legacy ID). Get it from Search Customers. Example: Y3VzdG9tZXJfYWJjMTIz.

Example input: `{"customer_id":"<customer_id>"}`

### `braintree_dispute_accept`

Accept Dispute · Destructive

Accept an OPEN Braintree dispute, conceding it to the customer.
Returns the dispute with its new status.
This cannot be undone and the disputed amount is lost. To fight it, add evidence and use Finalize Dispute instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `dispute_id` (`string`, required): Braintree GraphQL ID of the dispute (not the legacy ID shown in the Control Panel; convert one with Get ID From Legacy ID). Get it from Search Disputes. Example: ZGlzcHV0ZV9hYmMxMjM.

Example input: `{"dispute_id":"<dispute_id>"}`

### `braintree_payment_method_delete`

Delete Payment Method · Destructive

Delete a multi-use payment method from the Braintree vault.
Returns clientMutationId on success.
This cannot be undone. Check Search Subscriptions first for subscriptions billed to it.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `payment_method_id` (`string`, required): Braintree GraphQL ID of the payment method (not the legacy ID shown in the Control Panel; convert one with Get ID From Legacy ID). Get it from Get Customer. Example: cGF5bWVudG1ldGhvZF9jY19hYmMxMjM.

Example input: `{"payment_method_id":"<payment_method_id>"}`

### `braintree_refund_reverse`

Reverse Refund · Destructive

Reverse (void) a Braintree refund that has not settled yet.
Returns the voided refund with its status.
Only refunds that have not settled can be reversed.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `refund_id` (`string`, required): Braintree GraphQL ID of the refund (not the legacy ID shown in the Control Panel; convert one with Get ID From Legacy ID). Get it from Search Refunds or Refund Transaction. Example: cmVmdW5kX2FiYzEyMw.
- `api_request_key` (`string`, optional): Idempotency key: a unique string per intended operation, so a retried call is not applied twice. Example: refund-order-1234.

Example input: `{"refund_id":"<refund_id>"}`

### `braintree_subscription_cancel`

Cancel Subscription · Destructive

Cancel a Braintree recurring billing subscription so it is never billed again.
Returns the subscription with status CANCELED.
This cannot be undone; a canceled subscription cannot be reactivated.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `subscription_id` (`string`, required): Braintree GraphQL ID of the subscription (not the legacy ID shown in the Control Panel; convert one with Get ID From Legacy ID). Get it from Search Subscriptions. Example: c3Vic2NyaXB0aW9uX2FiYzEyMw.

Example input: `{"subscription_id":"<subscription_id>"}`

### `braintree_transaction_reverse`

Reverse Transaction · Destructive

Reverse a Braintree transaction: Braintree voids it if it has not settled, or refunds it in full if it has.
Returns the reversal, which is the voided transaction or the new refund.
Use this when you want the money back without checking the settlement state first.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `transaction_id` (`string`, required): Braintree GraphQL ID of the transaction (not the legacy ID shown in the Control Panel; convert one with Get ID From Legacy ID). Get it from Search Transactions. Example: dHJhbnNhY3Rpb25fYWJjMTIz.
- `api_request_key` (`string`, optional): Idempotency key: a unique string per intended operation, so a retried call is not applied twice. Example: refund-order-1234.

Example input: `{"transaction_id":"<transaction_id>"}`

### `braintree_transaction_void`

Void Transaction · Destructive

Void an authorized or submitted-for-settlement Braintree transaction so it is never settled.
Returns the transaction's id, status and amount.
Only works before settlement. Use Refund Transaction after it has settled.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `transaction_id` (`string`, required): Braintree GraphQL ID of the transaction (not the legacy ID shown in the Control Panel; convert one with Get ID From Legacy ID). Get it from Search Transactions. Example: dHJhbnNhY3Rpb25fYWJjMTIz.
- `api_request_key` (`string`, optional): Idempotency key: a unique string per intended operation, so a retried call is not applied twice. Example: refund-order-1234.

Example input: `{"transaction_id":"<transaction_id>"}`

## Related

Other Accounting & Finance connectors ([all 82](/agentkit/connectors/?category=accounting-finance)):

- [QuickBooks](/agentkit/connectors/quickbooks/): Scalekit connector, OAuth, 117 tools
- [Xero](/agentkit/connectors/xero/): Scalekit connector, OAuth, 94 tools
- [Stripe](/agentkit/connectors/stripe/): Scalekit connector, Access token, 178 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
