Braintree

A simple, robust way to accept payments or enable commerce from almost anywhere – in your mobile app or online.

The integration works with a special plugin and some setup in Braintree merchant panel.

Braintree configuration

The very first step is to define a new custom field which we will use for tracking. Navigate to your Braintree Control Panel – Settings> Processing and scroll down to Custom Fields. Create a new field with API Name as ‘visitorid‘ and Display name set e.g. to ‘Visitor ID‘. Finally, choose the ‘Store and Pass Back‘.

Payment form integration

This step is a bit marginal as you might be using different methods of creating payment forms.

So, in general you have to add this special code to your form:

<input type="hidden" name="pap_custom" value="" id="pap_dx8vc2s5">
<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/notifysale.php" type="text/javascript">
</script>

The script will automatically load the needed tracking value and include it to the form.

Now, you have to use the value to create a new customer in Braintree (next step).

Braintree customer integration

In this step we will use the custom field value and send it to Braintree along with other customer details. We will use the custom field we defined in the first step.

Find the script which uses the Brantree Customer create function and add the custom value sent from the form. Here’s an example with use of Braintree’s PHP SDK:

$result = Braintree_Customer::create([
    'firstName' => 'Mike',
    'lastName' => 'Jones',
    'company' => 'Jones Co.',
    'email' => 'mike.jones@example.com',
    'phone' => '281.330.8004',
    'fax' => '419.555.1235',
    'website' => 'http://example.com',
    'customFields' => array('visitorid' => $_POST['pap_custom'])
]);

This change will send the needed tracking value as a custom field and save it to the customer.

Webhook setup

The final step is to enable the Braintree plugin in your Post Affiliate Pro Plugins section and setting up a Braintree webhook which will communicate with the plugin.

To create a webhook, navigate to your Braintree Control Panel – Settings> Webhooks and create a new webhook. For the URL use the following one:

https://URL_TO_PostAffiliatePro/plugins/Braintree/braintree.php

In case of notifications you can use all the ‘Subscription‘ type notifications.

That’s it, you are now integrated.

Do not forget to integrate your site with the click tracking code to make it all working properly.