Set Up Your Server

JavaSDK

• Current Braintree Languages
• Java
• .NET
• Node.js
• PHP
• Python
• Ruby

Install and configure

Download Java library

• Version: 3.40.0
• SHA256: 63de4e5aba8f1b1f7060785de3dbf9fc213ffa990de90f920ed0552d07ed7cae

Or use Maven

Edit the pom.xml for your project, and in dependencies add:

<dependency>
  <groupId>com.braintreepayments.gateway</groupId>
  <artifactId>braintree-java</artifactId>
  <version>3.40.0</version>
</dependency>

In your code, configure the environment and API credentials:

private static BraintreeGateway gateway = new BraintreeGateway(
  Environment.SANDBOX,
  "your_merchant_id",
  "your_public_key",
  "your_private_key"
);

Generate a client token

ClientTokenRequest clientTokenRequest = new ClientTokenRequest()
  .customerId(aCustomerId);
// pass clientToken to your front-end
String clientToken = gateway.clientToken().generate(clientTokenRequest);

If the customer can't be found, it will return null.

Set Up Your Client covers the client side of the exchange.

Send a client token to your client

Here is an example of how your server would generate and expose a client token:

get(new Route("/client_token") {
  @Override
  public Object handle(Request request, Response response) {
    return gateway.clientToken().generate();
  }
});

How the token is used by the client may vary. In JavaScript integrations the client token is often included in the generated HTML/JS, while in mobile apps the client token must be requested. These methods are discussed in the client token setup section.

Receive a payment method nonce from your client

Once your client successfully obtains a customer payment method, it receives a payment_method_nonce representing customer payment authorization, which it then sends to your server.

Your server implementation is then responsible for receiving the payment_method_nonce and using it appropriately.

post(new Route("/checkout") {
  @Override
  public Object handle(Request request, Response response) {
    String nonceFromTheClient = request.queryParams("payment_method_nonce");
    // Use payment method nonce here
  }
});

Create a transaction

TransactionRequest request = new TransactionRequest()
  .amount(new BigDecimal("10.00"))
  .paymentMethodNonce(nonceFromTheClient)
  .deviceData(deviceDataFromTheClient)
  .options()
    .submitForSettlement(true)
    .done();

Result<Transaction> result = gateway.transaction().sale(request);

The sale call returns a Transaction Result Object which contains the transaction and information about the request.

Test your integration

Transition to production

At this point, you should be able to accept a payment method nonce and create a transaction in our sandbox. When you're ready to start charging real money, transition over to our production environment. We'll explain that process next.

Further reading

• Server SDK deprecation policy
• Best Practices