Мой опыт знакомства с BrainTree

Итак, началось все с того, что на работе к проекту понадобилось прикрутить систему оплаты BrainTree. Поискав на русскоязычных сайтах инструкцию как это сделать, я понял, что придется во всем разбираться самому.
Сначала вкратце о BrainTree. Система предназначена для электронных платежей с помощью кредитных карт.
Поддерживаются однократные платежи, а также периодические платежи (подписки).
На сайте BrainTree есть раздел Developers. Там довольно понятно изложена инструкция по настройке и запуску оплаты на вашем сайте с использованием различных языков программирования:

• Ruby
• Perl
• Python
• Java
• PHP
• Microsoft .NET
• Node JS

Также разработчикам предоставляется удобная песочница, в которой можно посмотреть все возможные настройки системы.

Безопасность

Для шифрования номера карты и CVV на клиентской стороне используется JavaScript библиотека. Далее данные с формы передаются на ваш сервер, который соединяется сервером BrainTree для осуществления операции. В ответе BrainTree отправляет результат действия, который можно по-разному обработать: выдать ошибку, осуществить подписку и прочее.

Я рассмотрю пример использования данной системы на сайте MVC 4.
Для начала создадим новый проект с шаблоном по умолчанию. (Предполагается, что Вы уже зарегистрировались, это не так уж тяжело).

Однократные платежи

Для того чтобы начать использовать BrainTree необходимо скачать библиотеку и подключить её к проекту.
Далее заходим в BrainTree под своим логином и копируем конфигурацию с использованием вашего языка (у нас .Net).

Внутри контроллера создаем статическую переменную.

public static BraintreeGateway Gateway = new BraintreeGateway         {             Environment = Braintree.Environment.SANDBOX,             PublicKey = "your_public_key",             PrivateKey = "your_private_key",             MerchantId = "your_merchant_id"         }; 

При этом не забываем подключить библиотеку BrainTree.

using Braintree; 

Теперь необходимо создать страничку и разместить форму.

<h1>Braintree Credit Card Transaction Form</h1>     <div>       <form action="@Url.Action("CreateTransaction")" method="POST" id="braintree-payment-form">         <p>           <label>Card Number</label>           <input type="text" size="20" autocomplete="off" data-encrypted-name="number" />         </p>         <p>           <label>CVV</label>           <input type="text" size="4" autocomplete="off" data-encrypted-name="cvv" />         </p>         <p>           <label>Expiration (MM/YYYY)</label>           <input type="text" size="2" name="month" /> / <input type="text" size="4" name="year" />         </p>         <input type="submit" id="submit" />       </form>     </div> 

Также для того чтобы зашифровать номер карты и cvv нужно использовать Braintree.js library. Публичный ключ можно получить в панели управления BrainTree.

     <script type="text/javascript" src="https://js.braintreegateway.com/v1/braintree.js"></script>     <script type="text/javascript">       var braintree = Braintree.create("YourClientSideEncryptionKey");       braintree.onSubmitEncryptForm('braintree-payment-form');     </script> 

Теперь на сервере необходимо принять эту форму.

[HttpPost]     public ActionResult CreateTransaction(FormCollection collection)     {         TransactionRequest request = new TransactionRequest         {             Amount = 1000.0M, //Здесь указывается сумма транзакции в USD             CreditCard = new TransactionCreditCardRequest             {                 Number = collection["number"],                 CVV = collection["cvv"],                 ExpirationMonth = collection["month"],                 ExpirationYear = collection["year"]             },             Options = new TransactionOptionsRequest             {                 SubmitForSettlement = true             }         };          Result<Transaction> result = Gateway.Transaction.Sale(request);          if (result.IsSuccess())         {             Transaction transaction = result.Target;             ViewData["TransactionId"] = transaction.Id;         }         else         {             ViewData["Message"] = result.Message;         }          return View();     } 

А также создать страницу для отображения результатов выполнения транзакции.

@if (ViewData.ContainsKey("TransactionId")) {     <h2>Success! Transaction ID: @ViewData["TransactionId"]</h2> } else {     <h2>Error: @ViewData["Message"]</h2> } 

После этого можно начать тестирование нашей системы. Для проверки используем номер карты «4111111111111111» и cvv «111», т.к. другие система не принимает. В качестве даты карты можно использовать любую валидную дату.

Периодические платежи

Для начала необходимо создать план подписки (а может и не один, если предполагаются различные варианты подписок) в панели управления BrainTree. Для этого нужно в левой панели выбрать Recurring Billing > Plans. Далее создаем новый план:

При необходимости добавляем ему пробный период:

А так же устанавливаем длительности цикла оплаты и длительность подписки:
Теперь создаем страничку с формой для введения данных о карте и о подписчике. Таким образом мы создаем клиента. Не забываем добавить шифрование номера карты и cvv перед оправкой формы.

    <h1>Braintreegateway recurring billing</h1>     <div id="braintreegateway-div-net">                   <h3>Braintree Credit Card Transaction Form</h3>     <div>       <form action="@Url.Action("CreateCustomer")" method="POST" id="braintree-payment-form1">         <p>           <label>First name</label>           <input type="text" data-encrypted-name="first_name" />         </p>         <p>           <label>Last name</label>           <input type="text"  data-encrypted-name="last_name" />         </p>         <p>           <label>Postal code</label>           <input type="text"  data-encrypted-name="postal_code" />         </p>         <p>           <label>Card Number</label>           <input type="text" size="20" autocomplete="off" data-encrypted-name="number" />         </p>         <p>           <label>CVV</label>           <input type="text" size="4" autocomplete="off" data-encrypted-name="cvv" />         </p>           <p>               <label>Expiration (MM/YYYY)</label>                              <input type="text" size="2" name="month"  /> / <input type="text" size="4" name="year" />                          </p>           <table> </table>         <input type="submit" id="submit" value="Create account"/>       </form>     </div>     <script type="text/javascript" src="https://js.braintreegateway.com/v1/braintree.js"></script>     <script type="text/javascript">         var braintree = Braintree.create("YourClientSideEncryptionKey");         braintree.onSubmitEncryptForm('braintree-payment-form1');     </script>     </div> 

Обработаем на сервере передачу формы:

[HttpPost] public ActionResult CreateCustomer(FormCollection collection) {     CustomerRequest request = new CustomerRequest     {         FirstName = collection["first_name"],         LastName = collection["last_name"],         CreditCard = new CreditCardRequest         {             BillingAddress = new CreditCardAddressRequest             {                 PostalCode = collection["postal_code"]             },             Number = collection["number"],             ExpirationMonth = collection["month"],             ExpirationYear = collection["year"],             CVV = collection["cvv"]         }     };      Result<Customer> result = Constants.Gateway.Customer.Create(request);     if (result.IsSuccess())     {         Customer customer = result.Target;         ViewData["CustomerName"] = customer.FirstName + " " + customer.LastName;         ViewData["CustomerId"] = customer.Id;     }     else     {         ViewData["Message"] = result.Message;     }      return View(); } 

Возвращаем страничку с информацией об ошибке, либо с кнопкой «Подписаться».

@if (ViewData.ContainsKey("CustomerId")) { <h2>Customer created with name: @ViewData["CustomerName"]</h2> @Html.ActionLink("Click here to sign this Customer up for a recurring payment", "CreateSubscription", "Home", new { id = ViewData["CustomerId"] }, null) } else { <h2>Error: @ViewData["Message"]</h2> } 

И обрабатываем кнопку создания подписки

public ActionResult CreateSubscription(string id)     {         try         {             Customer customer = Constants.Gateway.Customer.Find(id);             string paymentMethodToken = customer.CreditCards[0].Token;              SubscriptionRequest request = new SubscriptionRequest             {                 PaymentMethodToken = paymentMethodToken,                 PlanId = "test_plan_1"             };             Result<Subscription> result = Constants.Gateway.Subscription.Create(request);              return Content("Subscription Status " + result.Target.Status);         }         catch (Braintree.Exceptions.NotFoundException e)         {             return Content("No customer found for id: " + id);         }     } 

После совершения данных действий клиенты смогут платить за подписку к Вашему продукту.

В следующей статье заинтересовавшимся могу подробнее рассказать о том, как все происходит на боевом сервере, а так же о возможностях использования скидок, наценки, просмотра транзакций и прочих прелестях данной системы.