Braintree

overview this guide outlines the steps for integrating your braintree account with recover the integration relies on the following information from braintree real time failed transaction feed a real time feed of all failed payments delivered via a braintree webhook customer and payment methods retrieval of limited customer information and active payment methods linked to a subscription subscription status access to up to date information on the state of each braintree subscription configuration options recover has a few configuration options that the merchant can select from, these include dunning length required by recover, this is the length of time determined by the business in which a failed payment will be attempted to be recovered a common length many merchants settle on is 30 days end of dunning actions if configured, recover will cancel subscriptions on the merchant's behalf when an invoice is unable to be recovered by the close of the dunning cycle card rotator if enabled, this will help improve payment recovery performance by intelligently using alternative cards on file one off payment recovery if enabled, recover will attempt to recover one off invoices on your behalf, in addition to recurring invoices supported integration butter offers direct support for integrating your system with recover by assigning a dedicated butter solutions engineer this engineer will serve as your hands on resource, guiding you through the configuration process and ensuring a smooth integration with recover integration steps create braintree api key recover requires a dedicated braintree api key with assigned permissions this key enables recover to interact with your braintree environment and manage retries on your behalf log in as admin to your braintree account and go to settings > team > manage roles > + new role give the role a name like butter recover api check the following permissions type permission transactions create sales transactions submit sales for settlement customer management manage customers and payment methods (add/edit/delete) processing and security options processing options (add/edit ) recurring billing manage subscriptions recurring billing download subscription records recurring billing view modifications recurring billing view subscription plans recurring billing view subscriptions recurring billing search subscriptions read only access all search all butter initializes recover for your account after the api key has been generated and shared with butter, the butter team will configure api access and create a webhook destination for your account this webhook destination is designed to forward invoice charge attempts to recover the details of the webhook destination will be provided, allowing you to configure the necessary webhook endpoint in braintree during the next step the webhook endpoint url will have the following syntax webhooks recover serverless services butterpayments com/braintree/ts xxxxx where ts xxxxx is the transaction source (uniquely generated) for the webhook create braintree webhook click on the settings icon in the upper right hand corner, then > api > create a webhook endpoint copy and past the webhook endpoint url provided by the butter team as the desitination url in notifications, select to receive went past due events click save pre launch data ingest recover requires your braintree account to begin forwarding payment data to recover before going live during this pre launch period, no failed payments will be retried required pre launch data ingest required pre launch data ingest 1 dunning cycle integration with braintree requires an extended pre launch data integration because of how braintree handles payment failure notifications notifications are sent immediately when a payment fails a second notification is only sent at the end of the dunning process to ensure no payments are missed, recover must wait until all potential failure notifications have been received before completing the cutover launch day with recover on launch day, your butter solutions engineer will work closely with your team to make sure all configurations are setup correctly and done in the required order disable braintree automatic retries the launch process requires careful sequencing to prevent duplicate retries from being executed by multiple retry systems this involves disabling braintree automatic retries and any third party decline salvage services once this step is complete, butter will configure recover to take full responsibility for managing all retry attempts on failed invoices moving forward additional configurations there are a few additional configurations that can be added in discussion with you dedicated solutions engineer enable card rotator we recommend enabling this by default as it helps improve recover performance unless the merchant indicates otherwise enable one off invoices if you process non recurring, one off invoices, recover can be configured to retry these as well post launch monitoring once you are live with recover, the butter team will be closely tracking performance of failed payments as they are ingested and then optimally scheduled for retry butterboard as part of your launch with recover, you will receive email invitation to your butter account and access to your company's butterboard the butterboard provides realtime performance of revenue recovered, your recovery rate, and feed of most recent recovered transactions interested in working with butter to bring more revenue back to your business? reach out to us here contact\@butterpayments com