These developer docs are now deprecated and will not contain updated information that you may need to reference, including latest release versions. If you wish to see the current developer docs, please visit developers.braintreepayments.com.
Destination Verification with PHP
When adding a Webhook in the Control Panel, you will be asked to provide a destination URL. This destination will receive all webhook notifications as POST requests, but it will also be responsible for verifying your ownership.
When you attempt to add the destination, our servers will make a GET request to the provided URL with a query param named bt_challenge. This query param should be passed to the verify method. The result of calling this method should be returned as the body of the response. A full example of a verification integration can be found in our Webhooks Guide.
Add the following text to your marketplace's Terms of Service. Don't forget to replace [MSP] with your marketplace's name.
[MSP] uses Braintree, a division of PayPal, Inc. (Braintree) for payment processing. In order for you to use Braintree's payment processing services, you must enter into the Merchant Services Agreement (MSA) with Braintree and its sponsoring bank. The MSA is available at www.braintreepayments.com/agreements/merchant. By accepting this Agreement, you agree: (a) that you have downloaded or printed the MSA, and (b) that you have reviewed and agree to the MSA. Please note that [MSP] is not a party to the MSA and that you, Braintree and Braintree's sponsoring bank are the three parties to the MSA and that [MSP] has no obligations or liability to you under the MSA. If you have questions regarding the MSA, please contact Braintree at 877.434.2894.
Cards from outside the following European countries will incur additional fees:
Andorra, Austria, Belgium, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark (including Faroe Islands & Greenland), Estonia, Faroe Island, Finland, France (including French Guiana, Guadeloupe, Martinique, Reunion, Mayotte, Saint Barthelemy, Saint Martin [French Part])), Germany, Gibraltar, Greece, Greenland, Hungary, Iceland, Ireland, Italy, Latvia, Liechtenstein, Lithuania, Luxemburg, Malta, Monaco, Netherlands, Norway (including Svalbard and Jan Mayen, Antartica), Poland, Portugal, Romania, San Marino, Slovakia, Slovenia, Spain, Sweden, Switzerland, United Kingdom (including Falklands, Gibraltar, Guernsey, Isle of Man, Jersey, Saint Helena, Ascension and Tristan Da Cunha Helena, South Georgia and the South Sandwich Islands)]