Lua Requires Chilkat v9.5.0.65+

PayPal - Capture Authorization

See more PayPal Examples

Capture and process a previously created authorization. The original payment call must have the intent set to authorize. Lua

local chilkat = require("chilkat")

-- 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)
local jsonToken = chilkat.JsonObject.new()
jsonToken:load_file("qa_data/tokens/paypal.json")

-- Build the Authorization request header field value.
local sbAuth = chilkat.StringBuilder.new()
-- token_type should be "Bearer"
sbAuth:append(jsonToken:string_of("token_type"))
sbAuth:append(" ")
sbAuth:append(jsonToken:string_of("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.
local rest = chilkat.Rest.new()
local bAutoReconnect = true
local success = rest:connect("api.sandbox.paypal.com", 443, true, bAutoReconnect)
if not success then
    print(rest.last_error_text)
    return
end

-- ----------------------------------------------------------------------------------------------
-- 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..
-- ----------------------------------------------------------------------------------------------

-- To capture a particular amount, build JSON such as this:
local json = chilkat.JsonObject.new()
json.emit_compact = false
json:update_string("amount.currency", "USD")
json:update_string("amount.total", "6.70")
-- is_final_capture is optional and indicates whether to release all remaining funds that the authorization holds in the funding instrument.
json:update_bool("is_final_capture", true)
print(json:emit())

-- The JSON created by the above code:

--     {
--       "amount": {
--         "currency": "USD",
--         "total": "6.70"
--       },
--       "is_final_capture": true
--     }

-- This is the OAuth2 Authorization header, not to be confused with a PayPal credit card authorization...
rest:add_header("Authorization", sbAuth:get_as_string())
rest:add_header("Content-Type", "application/json")

-- The authorization ID is added to the path.
-- The authorization ID is obtained from payment records as shown here: Find Authorizations
local sbPath = chilkat.StringBuilder.new()
sbPath:append("/v1/payments/authorization/authorization_id/capture")
local numReplaced = sbPath:replace("authorization_id", "6HG91590AX913463C")

-- Send the POST request containing the JSON in the request body, and get the JSON response.
local sbJsonRequest = chilkat.StringBuilder.new()
json.emit_compact = true
json:emit_sb(sbJsonRequest)
local sbJsonResponse = chilkat.StringBuilder.new()

success = rest:full_request_sb("POST", sbPath:get_as_string(), sbJsonRequest, sbJsonResponse)
if not success then
    print(rest.last_error_text)
    return
end

json.emit_compact = false
json:load_sb(sbJsonResponse)

print("Response Status Code = " .. rest.response_status_code)

-- Did we get a 200 success response?
if rest.response_status_code ~= 200 then
    print(json:emit())
    print("Failed.")
    return
end

print(json:emit())
print("Success.")

-- A successful JSON response:

--     {
--       "id": "87S70321AE222860G",
--       "create_time": "2016-11-26T17:27:46Z",
--       "update_time": "2016-11-26T17:27:50Z",
--       "amount": {
--         "total": "6.70",
--         "currency": "USD"
--       },
--       "is_final_capture": true,
--       "state": "completed",
--       "reasonCode": "None",
--       "parent_payment": "PAY-3SL8976592063093RLA3DMAY",
--       "transaction_fee": {
--         "value": "0.49",
--         "currency": "USD"
--       },
--       "links": [
--         {
--           "href": "https://api.sandbox.paypal.com/v1/payments/capture/87S70321AE222860G",
--           "rel": "self",
--           "method": "GET"
--         },
--         {
--           "href": "https://api.sandbox.paypal.com/v1/payments/capture/87S70321AE222860G/refund",
--           "rel": "refund",
--           "method": "POST"
--         },
--         {
--           "href": "https://api.sandbox.paypal.com/v1/payments/authorization/6HG91590AX913463C",
--           "rel": "authorization",
--           "method": "GET"
--         },
--         {
--           "href": "https://api.sandbox.paypal.com/v1/payments/payment/PAY-3SL8976592063093RLA3DMAY",
--           "rel": "parent_payment",
--           "method": "GET"
--         }
--       ]
--     }
--