Java

PayPal - Capture a Previously Authorized Payment

See more PayPal Examples

Captures a previously authorized payment.

Note: This example requires Chilkat v9.5.0.65 or greater.

Chilkat2 Java

import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.JsonObject;
import com.chilkatsoft.chilkat2.Rest;
import com.chilkatsoft.chilkat2.StringBuilder;

public class ChilkatExample {

    public static void main(String[] args) {
        // Note: Requires Chilkat v9.5.0.65 or greater.

        // This requires the Chilkat API to have been previously unlocked.
        // See Global Unlock Sample for sample code.

        // Load our previously obtained access token. (see PayPal OAuth2 Access Token)
        JsonObject jsonToken = new JsonObject();
        jsonToken.loadFile("qa_data/tokens/paypal.json");

        // Build the Authorization request header field value.
        StringBuilder sbAuth = new StringBuilder();
        // token_type should be "Bearer"
        sbAuth.append(jsonToken.stringOf("token_type"));
        sbAuth.append(" ");
        sbAuth.append(jsonToken.stringOf("access_token"));

        // Make the initial connection.
        // A single REST object, once connected, can be used for many PayPal REST API calls.
        // The auto-reconnect indicates that if the already-established HTTPS connection is closed,
        // then it will be automatically re-established as needed.
        Rest rest = new Rest();
        boolean bAutoReconnect = true;
        try {
            rest.connect("api.sandbox.paypal.com", 443, true, bAutoReconnect);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        // ----------------------------------------------------------------------------------------------
        // The code above this comment could be placed inside a function/subroutine within the application
        // because the connection does not need to be made for every request.  Once the connection is made
        // the app may send many requests..
        // ----------------------------------------------------------------------------------------------

        // Build the JSON containing the transaction information.
        JsonObject json = new JsonObject();
        json.setEmitCompact(false);
        json.updateString("amount.currency", "USD");
        json.updateString("amount.total", "4.54");
        json.updateBool("is_final_capture", true);
        System.out.println(json.emit());

        // The JSON created by the above code:

        //     {
        //       "amount": {
        //         "currency": "USD",
        //         "total": "4.54"
        //       },
        //       "is_final_capture": true
        //     }

        rest.addHeader("Authorization", sbAuth.getAsString());
        rest.addHeader("Content-Type", "application/json");

        // To capture payment, make a call to /v1/payments/authorization/[authorization_id]/capture with the authorization ID in the URI.
        // See PayPal Authorize Payment for sample code to create the authorization.
        // The "7X8332687A4929542" comes from the "transactions[0].related_resources[0].authorization.id" part of the authorization response.

        StringBuilder sbPath = new StringBuilder();
        sbPath.append("/v1/payments/authorization/[authorization_id]/capture");
        int numReplacements = sbPath.replace("[authorization_id]", "7X8332687A4929542");

        // Send the POST request containign the JSON in the request body, and get the JSON response.
        StringBuilder sbJsonRequest = new StringBuilder();
        json.setEmitCompact(true);
        json.emitSb(sbJsonRequest);
        StringBuilder sbJsonResponse = new StringBuilder();
        try {
            rest.fullRequestSb("POST", sbPath.getAsString(), sbJsonRequest, sbJsonResponse);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        json.setEmitCompact(false);
        json.loadSb(sbJsonResponse);

        System.out.println("Response Status Code = " + rest.getResponseStatusCode());

        // IMPORTANT: In most PayPal examples, the return status code is 201.
        // For this particular call, PayPal returns status code 200.

        // Did we get a 200 success response?
        if (rest.getResponseStatusCode() != 200) {
            System.out.println(json.emit());
            System.out.println("Failed.");
            return;
        }

        // Sample JSON response is shown below.
        System.out.println(json.emit());

        System.out.println("success");

        // ------------------------------------------------
        // A sample JSON response:

        //     {
        //       "id": "1LY5310469661362J",
        //       "create_time": "2016-11-24T00:40:50Z",
        //       "update_time": "2016-11-24T00:40:54Z",
        //       "amount": {
        //         "total": "4.54",
        //         "currency": "USD"
        //       },
        //       "is_final_capture": true,
        //       "state": "completed",
        //       "reasonCode": "None",
        //       "parent_payment": "PAY-2CY489250W145633HLA3DK3Y",
        //       "transaction_fee": {
        //         "value": "0.43",
        //         "currency": "USD"
        //       },
        //       "links": [
        //         {
        //           "href": "https://api.sandbox.paypal.com/v1/payments/capture/1LY5310469661362J",
        //           "rel": "self",
        //           "method": "GET"
        //         },
        //         {
        //           "href": "https://api.sandbox.paypal.com/v1/payments/capture/1LY5310469661362J/refund",
        //           "rel": "refund",
        //           "method": "POST"
        //         },
        //         {
        //           "href": "https://api.sandbox.paypal.com/v1/payments/authorization/7X8332687A4929542",
        //           "rel": "authorization",
        //           "method": "GET"
        //         },
        //         {
        //           "href": "https://api.sandbox.paypal.com/v1/payments/payment/PAY-2CY489250W145633HLA3DK3Y",
        //           "rel": "parent_payment",
        //           "method": "GET"
        //         }
        //       ]
        //     }
    }
}