Braintree Webhook with Node.js — Production Integration Guide

What does "process and normalize webhook from Braintree" mean?

When Braintree fires a payment event, its webhook body contains dozens of nested fields specific to its internal data model. To process and normalize webhook means extracting only the relevant data and converting it to a flat, universally consumable format — without any custom parsing logic on your end.

The normalized output always follows the same 6-field schema regardless of the source platform:

{
  "platform":       "braintree",
  "transaction_id": "pi_3ABC...",
  "amount":         49.99,
  "currency":       "USD",
  "customer_email": "buyer@example.com",
  "payment_status": "succeeded"
}

Raw Braintree webhook example

This is the actual payload Braintree POSTs to your server endpoint:

{
  "kind": "transaction_settled",
  "transaction": {
    "id": "dw7dt5",
    "amount": "49.99",
    "currencyIsoCode": "USD",
    "customer": { "email": "buyer@example.com" },
    "status": "settled"
  }
}

As you can see, the object contains dozens of fields irrelevant to most integration use cases. The Webhook Translator API strips the noise and returns only the essential contract.

How to process and normalize webhook from Braintree in under 60 seconds

Option 1 — API call (recommended)

Forward the raw webhook with a single query parameter:

POST https://webhook-translator-microapi.vercel.app/?plataforma=braintree
Content-Type: application/json
X-RapidAPI-Key: YOUR_KEY

[Braintree webhook body here]

Option 2 — Manual Node.js parser

// ⚠ You must maintain this code on every Braintree API update
const amount = event.data.object.amount_received / 100;
const email = event.data.object.customer_email
           ?? event.data.object.billing_details?.email;
// ... 20+ more lines to handle all edge cases and platform versions

Related documentation