Braintree
Verification available
Authenticates encoded XML in bt_payload; form accepts only bt_payload/bt_signature. API public/private key pair; no merchant ID or network call required. HMAC-SHA1 is provider's documented MAC, not an unsigned SHA1 checksum.
Signature scheme
- Algorithm
- HMAC-SHA1 with SHA1-derived key
- Signature
- form bt_signature and bt_payload
- Signed data
- URL-decoded bt_payload base64 text, with provider SDK trailing-LF compatibility
- Encoding
- public_key|hex, ampersand separated signatures inside bt_signature
- Timestamp
- none
Configure verification
Create or edit a source, enable Verify signature and search for Braintree. The source remains active independently of this switch. Save the provider and its configuration together.
Copy the exact ingress URL from your source when configuring the sender. Save every required field together; saved configuration is encrypted and never returned in source reads.
- public key (
public_key) (required). - private key (
private_key) (required).
For API clients, encode these fields as one JSON object inside the signing_secret string. The dashboard assembles it from the fields above.
Inspect the recorded valid, invalid or not-checked signature result after sending a new event. Changing configuration does not change historical results; replay preserves the original bytes and does not re-sign the webhook.
Capture, delivery and acknowledgement
Verification availability describes the inbound validator. The original incoming query string is not retained or forwarded, and the destination URL or path can differ from the signed request. Acklane does not re-sign deliveries; schemes using that original context may not be verifiable again at the destination.
With async enabled, a failed signature may still be captured and retained, but does not become eligible for signature-on delivery. Replay requires current source eligibility, preserves the event ID and original content, and creates a separate delivery history.
Async capture returns 202 after durable acceptance. A provider that requires HTTP 200 or a special acknowledgement may retry; an implemented validator does not establish compatibility with its acknowledgement rules. No real provider sandbox delivery is certified by this catalog.