---
title: Braintree
description: Process and query payments using the Braintree payment gateway API with support for filters and time-based operations.
category: Application
tags: [braintree, payments, gateway, integration, transactions]
---

# Braintree

## **Description**

Braintree is a full-stack payment platform by PayPal that supports credit cards, digital wallets, recurring billing, and more.

The **Braintree** activity enables secure integration with the Braintree Payment Gateway for performing various payment operations. It supports both **transaction-related tasks** (like creating payments, querying transactions) and **data retrieval** based on a time range or filters.

> **Use case**:  
> In a financial reporting workflow, this activity can retrieve all **successful transactions** for the last 30 days. The results can then be summarized using **Group By** and uploaded to a finance dashboard or exported to Excel.

## **Input**

_Not Applicable_

## **Output**

| Output Type | Format | Description                                   |
| ----------- | ------ | --------------------------------------------- |
| **Data**    | JSON   | API response from Braintree with payment data |

## **Configuration Fields**

| Field Name       | Description                                                                                                             |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Connection**   | Authentication settings for Braintree API. Typically includes API key, client ID, or OAuth credentials.                 |
| **Base URL**     | Braintree API base endpoint. Example: `https://api.sandbox.braintreegateway.com` or `https://api.braintreegateway.com`. |
| **Operation**    | The type of operation to perform. Example: `CreateTransaction`, `SearchTransactions`, `GetCustomer`.                    |
| **Query**        | Optional parameters to refine the API request, such as `status=settled`, `amount>100`, etc.                             |
| **Variables**    | Key-value inputs required for the operation (e.g., `customerId`, `paymentMethodNonce`, etc.).                           |
| **Get Data for** | Time range for fetching transaction data (e.g., `Today`, `Yesterday Days`, `Custom Range`).                             |
| **Start Date**   | Start date for the custom date range, used when `Get Data for` is set to `Custom Range`. Example: `2025-01-01`.         |
| **End Date**     | End date for the custom date range. Example: `2025-01-31`.                                                              |

## **Sample Input**

_Not applicable_

## **Sample Configuration**

| Field           | Value                                       |
| --------------- | ------------------------------------------- |
| `connection.id` | `braintree-auth`                            |
| `baseUrl`       | `https://api.sandbox.braintreegateway.com`  |
| `operation`     | `SearchTransactions`                        |
| `query`         | `status=settled&amount>100`                 |
| `variables`     | `{ "merchantAccountId": "infoveave-main" }` |
| `getDataFor`    | `Today`                                     |

## **Sample Output**

| Transaction ID | Customer ID | Amount | Status  | Date       |
| -------------- | ----------- | ------ | ------- | ---------- |
| txn_abc123     | cust_001    | 150.00 | Settled | 2025-06-10 |
| txn_xyz789     | cust_002    | 220.00 | Settled | 2025-06-11 |

> Output fields depend on the selected **operation** and the Braintree API's response schema. Use **ExtractFields** or **TransformFields** downstream to shape the data.

---