Appearance
Braintree
Accept credit cards, PayPal, and digital wallets with Braintree gateway.
| Detail | Value |
|---|---|
| Category | Payments |
| Base URL | https://payments.braintreegateway.com |
| Authentication | Bearer Token |
| Endpoints | 5 |
| Connector key | braintree |
Using Braintree in a workflow
- Go to Connections and click New Connection.
- Pick Braintree from the marketplace.
- Enter your credentials (see Authentication above for what's expected).
- In a workflow, drop an API Call node and select this connection.
- Pick the operation you need from the Operation dropdown — the full list is below.
Available endpoints
| Endpoint | Summary |
|---|---|
POST /merchants/{merchant_id}/transactions | Create a transaction |
GET /merchants/{merchant_id}/transactions/{transaction_id} | Find a transaction |
POST /merchants/{merchant_id}/customers | Create a customer |
GET /merchants/{merchant_id}/customers/{customer_id} | Find a customer |
POST /merchants/{merchant_id}/transactions/{transaction_id}/refund | Refund a transaction |
Each endpoint is documented in full below. Use the outline on the right to jump to one.
POST /merchants/{merchant_id}/transactions
Create a transaction
| Detail | Value |
|---|---|
| Operation ID | payments.createTransaction |
| Method | POST |
| Path | /merchants/{merchant_id}/transactions |
Parameters
| Name | Location | Type | Required |
|---|---|---|---|
merchant_id | path | string | Yes |
Request Body
| Field | Type |
|---|---|
amount | string |
payment_method_nonce | string |
Using this endpoint in a workflow
- Add an API Call node to your workflow.
- Pick your Braintree connection from the Connection dropdown.
- In the Operation dropdown, select
payments.createTransaction. - Fill in the parameter fields that appear. Use
{{...}}to reference upstream values.
Required fields are marked — fill them or the call will fail at runtime.
What it returns
The API Call node writes the response to the workflow context:
{
status: 200,
success: true,
data: { ...response body from the API... },
latencyMs: 142
}Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Braintree API reference.
GET /merchants/{merchant_id}/transactions/{transaction_id}
Find a transaction
| Detail | Value |
|---|---|
| Operation ID | payments.getTransaction |
| Method | GET |
| Path | /merchants/{merchant_id}/transactions/{transaction_id} |
Parameters
| Name | Location | Type | Required |
|---|---|---|---|
merchant_id | path | string | Yes |
transaction_id | path | string | Yes |
Using this endpoint in a workflow
- Add an API Call node to your workflow.
- Pick your Braintree connection from the Connection dropdown.
- In the Operation dropdown, select
payments.getTransaction. - Fill in the parameter fields that appear. Use
{{...}}to reference upstream values.
Required fields are marked — fill them or the call will fail at runtime.
What it returns
The API Call node writes the response to the workflow context:
{
status: 200,
success: true,
data: { ...response body from the API... },
latencyMs: 142
}Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Braintree API reference.
POST /merchants/{merchant_id}/customers
Create a customer
| Detail | Value |
|---|---|
| Operation ID | payments.createCustomer |
| Method | POST |
| Path | /merchants/{merchant_id}/customers |
Parameters
| Name | Location | Type | Required |
|---|---|---|---|
merchant_id | path | string | Yes |
Request Body
| Field | Type |
|---|---|
first_name | string |
last_name | string |
email | string |
Using this endpoint in a workflow
- Add an API Call node to your workflow.
- Pick your Braintree connection from the Connection dropdown.
- In the Operation dropdown, select
payments.createCustomer. - Fill in the parameter fields that appear. Use
{{...}}to reference upstream values.
Required fields are marked — fill them or the call will fail at runtime.
What it returns
The API Call node writes the response to the workflow context:
{
status: 200,
success: true,
data: { ...response body from the API... },
latencyMs: 142
}Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Braintree API reference.
GET /merchants/{merchant_id}/customers/{customer_id}
Find a customer
| Detail | Value |
|---|---|
| Operation ID | payments.getCustomer |
| Method | GET |
| Path | /merchants/{merchant_id}/customers/{customer_id} |
Parameters
| Name | Location | Type | Required |
|---|---|---|---|
merchant_id | path | string | Yes |
customer_id | path | string | Yes |
Using this endpoint in a workflow
- Add an API Call node to your workflow.
- Pick your Braintree connection from the Connection dropdown.
- In the Operation dropdown, select
payments.getCustomer. - Fill in the parameter fields that appear. Use
{{...}}to reference upstream values.
Required fields are marked — fill them or the call will fail at runtime.
What it returns
The API Call node writes the response to the workflow context:
{
status: 200,
success: true,
data: { ...response body from the API... },
latencyMs: 142
}Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Braintree API reference.
POST /merchants/{merchant_id}/transactions/{transaction_id}/refund
Refund a transaction
| Detail | Value |
|---|---|
| Operation ID | payments.refundTransaction |
| Method | POST |
| Path | /merchants/{merchant_id}/transactions/{transaction_id}/refund |
Parameters
| Name | Location | Type | Required |
|---|---|---|---|
merchant_id | path | string | Yes |
transaction_id | path | string | Yes |
Using this endpoint in a workflow
- Add an API Call node to your workflow.
- Pick your Braintree connection from the Connection dropdown.
- In the Operation dropdown, select
payments.refundTransaction. - Fill in the parameter fields that appear. Use
{{...}}to reference upstream values.
Required fields are marked — fill them or the call will fail at runtime.
What it returns
The API Call node writes the response to the workflow context:
{
status: 200,
success: true,
data: { ...response body from the API... },
latencyMs: 142
}Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Braintree API reference.