solidus_paypal_commerce_platform 0.3.2 → 0.5.0

data/README.md

@@ -1,7 +1,7 @@
 # Solidus Paypal Commerce Platform
 
-[![CircleCI](https://circleci.com/gh/solidusio-contrib/solidus_paypal_commerce_platform.svg?style=shield)](https://circleci.com/gh/solidusio-contrib/solidus_paypal_commerce_platform)
-[![codecov](https://codecov.io/gh/solidusio-contrib/solidus_paypal_commerce_platform/branch/master/graph/badge.svg)](https://codecov.io/gh/solidusio-contrib/solidus_paypal_commerce_platform)
+[![CircleCI](https://circleci.com/gh/solidusio/solidus_paypal_commerce_platform.svg?style=shield)](https://circleci.com/gh/solidusio/solidus_paypal_commerce_platform)
+[![codecov](https://codecov.io/gh/solidusio/solidus_paypal_commerce_platform/branch/master/graph/badge.svg)](https://codecov.io/gh/solidusio/solidus_paypal_commerce_platform)
 
 The official PayPal integration of Solidus.
 
@@ -120,6 +120,25 @@ With product and cart page checkout, the user is directed to the checkout confir
 
 PayPals API does not allow for admin-side payments. Instead, backend users taking payments for customers will need to use the PayPal Virtual Terminal to take payments. [More info is available on the PayPal website.](https://www.paypal.com/merchantapps/appcenter/acceptpayments/virtualterminal?locale.x=en_US)
 
+## Venmo
+Venmo is currently available to US merchants and buyers. There are also other [prequisites](https://developer.paypal.com/docs/business/checkout/pay-with-venmo/#eligibility).
+
+If the transaction supports Venmo and it is enabled by the following, then a button should appear for it on checkout payment page. Note, Venmo cannot currently be rendered on the product or cart pages.
+
+Set the PaypalCommercePlatform `PaymentMethod` `venmo_standalone` preference to:
+- `render only standalone`, show Venmo on the payment page and do not show the other funding sources (i.e. PayPal, Credit); or
+- `enabled`, show Venmo on the payment page; or
+- `disabled` (default), do not show the Venmo button.
+
+See more about preferences([Configuration](#configuration)) below.
+
+[_As Venmo is only available in the US, you may want to mock your location for testing_](#mocking-your-buyer-country)
+
+## Configuration
+The easiest way to change the `Payment Method`'s preferences is through admin: `Settings > Payments > "PayPal Commerce Platform" > Edit`.
+
+See more about preferences [here](https://guides.solidus.io/developers/preferences/add-model-preferences.html#access-your-preferences)/
+
 ## Development
 
 ### Testing the extension
@@ -162,6 +181,12 @@ $ bin/rails server
 Use Ctrl-C to stop
 ```
 
+### Mocking your buyer country
+PayPal normally looks at your IP geolocation to see where you are located to determine what funding sources are available to you. For example, Venmo is currently only available to US buyers.
+Because of this, you may want to pretend you are from US check that that Venmo is correctly integrated for these customers. To do this, set the payment method's preference of `force_buyer_country` to "US". See more information about preferences above.
+
+This preference has no effect on production.
+
 ### Updating the changelog
 
 Before and after releases the changelog should be updated to reflect the up-to-date status of

data/app/assets/javascripts/spree/frontend/solidus_paypal_commerce_platform/button_actions.js

@@ -84,6 +84,7 @@ SolidusPaypalCommercePlatform.approveOrder = function(data, actions) {
       SolidusPaypalCommercePlatform.verifyTotal(response.purchase_units[0].amount.value).then(function(){
         $("#payments_source_paypal_order_id").val(data.orderID)
         $("#payments_source_paypal_email").val(response.payer.email_address)
+        $("#payments_source_paypal_funding_source").val(SolidusPaypalCommercePlatform.fundingSource)
         $("#checkout_form_payment").submit()
       })
     })
@@ -168,7 +169,8 @@ SolidusPaypalCommercePlatform.addPayment = function(paypal_amount, payment_metho
         payment_method_id: payment_method_id,
         source_attributes: {
           paypal_order_id: data.orderID,
-          paypal_email: email
+          paypal_email: email,
+          paypal_funding_source: SolidusPaypalCommercePlatform.fundingSource
         }
       }
     },

data/app/assets/javascripts/spree/frontend/solidus_paypal_commerce_platform/buttons.js

@@ -2,6 +2,7 @@ SolidusPaypalCommercePlatform.renderButton = function(payment_method_id, style)
   paypal.Buttons({
     style: style,
     createOrder: SolidusPaypalCommercePlatform.sendOrder.bind(null, payment_method_id),
+    onClick: (data) => { SolidusPaypalCommercePlatform.fundingSource = data.fundingSource },
     onApprove: SolidusPaypalCommercePlatform.approveOrder,
     onShippingChange: SolidusPaypalCommercePlatform.shippingChange,
     onError: SolidusPaypalCommercePlatform.handleError
@@ -12,6 +13,7 @@ SolidusPaypalCommercePlatform.renderCartButton = function(payment_method_id, sty
   paypal.Buttons({
     style: style,
     createOrder: SolidusPaypalCommercePlatform.sendOrder.bind(null, payment_method_id),
+    onClick: (data) => { SolidusPaypalCommercePlatform.fundingSource = data.fundingSource },
     onApprove: SolidusPaypalCommercePlatform.finalizeOrder.bind(null, payment_method_id),
     onShippingChange: SolidusPaypalCommercePlatform.shippingChange,
     onError: SolidusPaypalCommercePlatform.handleError
@@ -22,8 +24,20 @@ SolidusPaypalCommercePlatform.renderProductButton = function(payment_method_id,
   paypal.Buttons({
     style: style,
     createOrder: SolidusPaypalCommercePlatform.createAndSendOrder.bind(null, payment_method_id),
+    onClick: (data) => { SolidusPaypalCommercePlatform.fundingSource = data.fundingSource },
     onApprove: SolidusPaypalCommercePlatform.finalizeOrder.bind(null, payment_method_id),
     onShippingChange: SolidusPaypalCommercePlatform.shippingChange,
     onError: SolidusPaypalCommercePlatform.handleError
   }).render('#paypal-button-container')
 }
+
+SolidusPaypalCommercePlatform.renderVenmoStandalone = function(payment_method_id, style) {
+  paypal.Buttons({
+    style: style,
+    fundingSource: paypal.FUNDING.VENMO,
+    createOrder: SolidusPaypalCommercePlatform.sendOrder.bind(null, payment_method_id),
+    onClick: () => { SolidusPaypalCommercePlatform.fundingSource = paypal.FUNDING.VENMO },
+    onApprove: SolidusPaypalCommercePlatform.approveOrder,
+    onError: SolidusPaypalCommercePlatform.handleError
+  }).render('#paypal-button-container')
+}

data/app/controllers/solidus_paypal_commerce_platform/orders_controller.rb

@@ -10,7 +10,7 @@ module SolidusPaypalCommercePlatform
       authorize! :create, ::Spree::Order
 
       @order = ::Spree::Order.create!(
-        user: try_spree_current_user,
+        user: current_api_user,
         store: current_store,
         currency: current_pricing_options.currency
       )

data/app/controllers/solidus_paypal_commerce_platform/payments_controller.rb

@@ -10,11 +10,13 @@ module SolidusPaypalCommercePlatform
       paypal_order_id = paypal_params[:paypal_order_id]
 
       if !paypal_order_id
-        return redirect_to checkout_state_path(@order.state), notice: "Invalid order confirmation data passed in"
+        return redirect_to checkout_state_path(@order.state),
+          notice: I18n.t("solidus_paypal_commerce_platform.controllers.payments_controller.invalid_paypal_order_id")
       end
 
       if @order.complete?
-        return redirect_to spree.order_path(@order), notice: "Order is already in complete state"
+        return redirect_to spree.order_path(@order),
+          notice: I18n.t("solidus_paypal_commerce_platform.controllers.payments_controller.order_complete")
       end
 
       source = SolidusPaypalCommercePlatform::PaymentSource.new(paypal_order_id: paypal_order_id)

data/app/helpers/solidus_paypal_commerce_platform/button_options_helper.rb

@@ -17,5 +17,9 @@ module SolidusPaypalCommercePlatform
     def preferred_paypal_button_layout_options
       [["Vertical", "vertical"], ["Horizontal", "horizontal"]]
     end
+
+    def preferred_venmo_standalone_options
+      [['Render only standalone', 'render only standalone'], ['Enabled', 'Enabled'], ['Disabled', 'disabled']]
+    end
   end
 end

data/app/models/solidus_paypal_commerce_platform/gateway.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require 'paypal-checkout-sdk'
-
 module SolidusPaypalCommercePlatform
   class Gateway
     include PayPalCheckoutSdk::Orders
@@ -45,7 +43,7 @@ module SolidusPaypalCommercePlatform
       request = AuthorizationsCaptureRequest.new(source.authorization_id)
       request.request_body(amount: { currency_code: options[:currency], value: Money.new(money).dollars })
 
-      response = @client.execute_with_response(request)
+      response = capture_with_response(request)
       if response.success?
         source.update(capture_id: response.params["result"].id)
       end
@@ -83,5 +81,24 @@ module SolidusPaypalCommercePlatform
     def get_order(order_id)
       @client.execute(OrdersGetRequest.new(order_id)).result
     end
+
+    private
+
+    def capture_with_response(request, success_message: nil, failure_message: nil)
+      response = @client.execute(request)
+      if response.result&.status == "PENDING"
+        ActiveMerchant::Billing::Response.new(
+          false,
+          "Payment is awaiting processing on PayPal's side"
+        )
+      else
+        i18n_scope = @client.i18n_scope_for(request)
+        @client.wrap_response(
+          response,
+          success_message: success_message || I18n.t("#{i18n_scope}.success", default: nil),
+          failure_message: failure_message || I18n.t("#{i18n_scope}.failure", default: nil)
+        )
+      end
+    end
   end
 end

data/app/models/solidus_paypal_commerce_platform/payment_method.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module SolidusPaypalCommercePlatform
-  class PaymentMethod < SolidusSupport.payment_method_parent_class
+  class PaymentMethod < ::Spree::PaymentMethod
     include SolidusPaypalCommercePlatform::ButtonOptionsHelper
     preference :client_id, :string
     preference :client_secret, :string
@@ -12,6 +12,21 @@ module SolidusPaypalCommercePlatform
     preference :display_on_cart, :boolean, default: true
     preference :display_on_product_page, :boolean, default: true
     preference :display_credit_messaging, :boolean, default: true
+    preference :venmo_standalone, :paypal_select, default: 'disabled'
+    preference :force_buyer_country, :string
+
+    validates :preferred_paypal_button_color, exclusion: {
+      in: %w[gold],
+      message: I18n.t("solidus_paypal_commerce_platform.payment_method.gold_button_message")
+    }, if: :venmo_standalone_enabled?
+
+    def venmo_standalone_enabled?
+      options[:venmo_standalone] != 'disabled'
+    end
+
+    def render_only_venmo_standalone?
+      options[:venmo_standalone] == 'render only standalone'
+    end
 
     def partial_name
       "paypal_commerce_platform"
@@ -73,6 +88,11 @@ module SolidusPaypalCommercePlatform
       }
 
       parameters[:shipping_preference] = 'NO_SHIPPING' if step_names.exclude? 'delivery'
+      parameters['enable-funding'] = 'venmo' if venmo_standalone_enabled?
+
+      if !Rails.env.production? && options[:force_buyer_country].present?
+        parameters['buyer-country'] = options[:force_buyer_country]
+      end
 
       "https://www.paypal.com/sdk/js?#{parameters.to_query}"
     end

data/app/models/solidus_paypal_commerce_platform/payment_source.rb

@@ -1,10 +1,21 @@
 # frozen_string_literal: true
 
 module SolidusPaypalCommercePlatform
-  class PaymentSource < SolidusSupport.payment_source_parent_class
+  class PaymentSource < ::Spree::PaymentSource
     self.table_name = "paypal_commerce_platform_sources"
+    enum paypal_funding_source: {
+      applepay: 0, bancontact: 1, blik: 2, boleto: 3, card: 4, credit: 5, eps: 6, giropay: 7, ideal: 8,
+      itau: 9, maxima: 10, mercadopago: 11, mybank: 12, oxxo: 13, p24: 14, paylater: 15, paypal: 16, payu: 17,
+      sepa: 18, sofort: 19, trustly: 20, venmo: 21, verkkopankki: 22, wechatpay: 23, zimpler: 24
+    }, _suffix: :funding
     validates :paypal_order_id, :payment_method_id, presence: true
 
+    def display_paypal_funding_source
+      I18n.t(paypal_funding_source,
+        scope: 'solidus_paypal_commerce_platform.paypal_funding_sources',
+        default: paypal_funding_source)
+    end
+
     def actions
       %w(capture void credit)
     end

data/app/models/solidus_paypal_commerce_platform/paypal_order.rb

@@ -44,19 +44,12 @@ module SolidusPaypalCommercePlatform
     end
 
     def name(address)
-      if greater_than_2_10?
-        name = ::Spree::Address::Name.new @order.ship_address.name
+      name = ::Spree::Address::Name.new address.name
 
-        {
-          given_name: name.first_name,
-          surname: name.last_name
-        }
-      else
-        {
-          given_name: address.firstname,
-          surname: address.lastname
-        }
-      end
+      {
+        given_name: name.first_name,
+        surname: name.last_name
+      }
     end
 
     def purchase_units(include_shipping_address: true)
@@ -80,11 +73,7 @@ module SolidusPaypalCommercePlatform
     end
 
     def full_name
-      if greater_than_2_10?
-        @order.ship_address.name
-      else
-        @order.ship_address.full_name
-      end
+      @order.ship_address.name
     end
 
     def line_items
@@ -120,9 +109,5 @@ module SolidusPaypalCommercePlatform
         value: amount
       }
     end
-
-    def greater_than_2_10?
-      ::Spree.solidus_gem_version >= Gem::Version.new('2.11')
-    end
   end
 end

data/app/models/solidus_paypal_commerce_platform/wizard.rb

@@ -34,7 +34,7 @@ module SolidusPaypalCommercePlatform
     private
 
     def logo
-      ActionController::Base.helpers.image_url(::Spree::Config[:admin_interface_logo])
+      ActionController::Base.helpers.image_path(::Spree::Config[:admin_interface_logo])
     end
   end
 end

data/bin/rails-engine

@@ -7,7 +7,7 @@ ENGINE_PATH = File.expand_path('../lib/solidus_paypal_commerce_platform/engine',
 
 # Set up gems listed in the Gemfile.
 ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../Gemfile', __dir__)
-require 'bundler/setup' if File.exist?(ENV['BUNDLE_GEMFILE'])
+require 'bundler/setup' if File.exist?(ENV.fetch('BUNDLE_GEMFILE', nil))
 
 require 'rails/all'
 require 'rails/engine/commands'

data/config/locales/en.yml

@@ -18,9 +18,15 @@ en:
   paypal_capture_id: PayPal Capture ID
   paypal_debug_id: PayPal Debug ID
   paypal_email: PayPal Email
+  paypal_funding: 'PayPal Funding: %{funding}'
+  paypal_funding_source: 'PayPal Funding Source'
   payment_email: "Payment Email: %{email}"
   virtual_terminal_notice_html: Backend Credit Card payments can only be accepted through PayPal via the <a href="https://www.paypal.com/merchantapps/appcenter/acceptpayments/virtualterminal">PayPal Virtual Terminal</a>.
   solidus_paypal_commerce_platform:
+    controllers:
+      payments_controller:
+        invalid_paypal_order_id: "Invalid order confirmation data passed in"
+        order_complete: "Order is already in complete state"
     responses:
       pay_pal_checkout_sdk/orders/orders_capture_request:
         success: "Payment captured"
@@ -34,4 +40,31 @@ en:
         success: "Payment refunded for %{amount}"
       pay_pal_checkout_sdk/payments/authorizations_void_request:
         success: "Payment voided"
-
+    payment_method:
+      gold_button_message: "cannot be 'gold' when Venmo standalone is enabled."
+    paypal_funding_sources:
+      applepay: 'Apple Pay'
+      bancontact: 'Bancontact'
+      blik: 'BLIK'
+      boleto: 'Boleto'
+      card: 'Credit or debit card'
+      credit: 'PayPal Credit'
+      eps: 'eps'
+      giropay: 'giropay'
+      ideal: 'iDEAL'
+      itau: 'Itau'
+      maxima: 'Maxima'
+      mercadopago: 'Mercado Pago'
+      mybank: 'MyBank'
+      oxxo: 'Oxxo'
+      p24: 'Przelewy24'
+      paylater: 'Pay Later'
+      paypal: 'PayPal'
+      payu: 'PayU'
+      sepa: 'SEPA-Lastschrift'
+      sofort: 'Sofort'
+      trustly: 'Trustly'
+      venmo: 'Venmo'
+      verkkopankki: 'Verkkopankki'
+      wechatpay: 'WeChat Pay'
+      zimpler: 'Zimpler'

data/db/migrate/20211220133406_add_paypal_funding_source_to_paypal_commerce_platform_sources.rb

@@ -0,0 +1,5 @@
+class AddPaypalFundingSourceToPaypalCommercePlatformSources < ActiveRecord::Migration[6.1]
+  def change
+    add_column :paypal_commerce_platform_sources, :paypal_funding_source, :integer
+  end
+end

data/lib/paypal/access_token.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: false
+
+module PayPal
+  class AccessToken
+    attr_accessor :access_token, :token_type, :expires_in, :date_created
+
+    def initialize(options)
+      @access_token = options.access_token
+      @token_type = options.token_type
+      @expires_in = options.expires_in
+      @date_created = Time.zone.now
+    end
+
+    def expired?
+      Time.zone.now > @date_created + @expires_in
+    end
+
+    def authorization_string
+      "#{@token_type} #{@access_token}"
+    end
+  end
+end

data/lib/paypal/lib.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: false
+
+require 'paypal/paypal_environment'
+require 'paypal/paypal_http_client'
+require 'paypal/token_requests'
+require 'paypal/access_token'
+require 'paypal/paypal_checkout_sdk/orders/orders_authorize_request'
+require 'paypal/paypal_checkout_sdk/orders/orders_capture_request'
+require 'paypal/paypal_checkout_sdk/orders/orders_create_request'
+require 'paypal/paypal_checkout_sdk/orders/orders_get_request'
+require 'paypal/paypal_checkout_sdk/orders/orders_patch_request'
+require 'paypal/paypal_checkout_sdk/orders/orders_validate_request'
+require 'paypal/paypal_checkout_sdk/payments/authorizations_capture_request'
+require 'paypal/paypal_checkout_sdk/payments/authorizations_get_request'
+require 'paypal/paypal_checkout_sdk/payments/authorizations_reauthorize_request'
+require 'paypal/paypal_checkout_sdk/payments/authorizations_void_request'
+require 'paypal/paypal_checkout_sdk/payments/captures_get_request'
+require 'paypal/paypal_checkout_sdk/payments/refunds_get_request'
+require 'paypal/paypal_checkout_sdk/payments/captures_refund_request'

data/lib/paypal/paypal_checkout_sdk/orders/orders_authorize_request.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: false
+
+# This class was generated on Mon, 27 Aug 2018 13:51:59 PDT by version 0.1.0-dev+904328-dirty of Braintree SDK Generator
+
+require 'cgi'
+
+module PayPalCheckoutSdk
+  module Orders
+    #
+    # Authorizes payment for an order. The response shows details
+    # of authorizations. You can make this call only if you specified
+    # `intent=AUTHORIZE` in the create order call.
+    #
+    class OrdersAuthorizeRequest
+      attr_accessor :path, :body, :headers, :verb
+
+      def initialize(order_id)
+        @headers = {}
+        @body = nil
+        @verb = "POST"
+        @path = "/v2/checkout/orders/{order_id}/authorize?"
+
+        @path = @path.gsub("{order_id}", CGI.escape(order_id.to_s))
+        @headers["Content-Type"] = "application/json"
+      end
+
+      def pay_pal_client_metadata_id(pay_pal_client_metadata_id)
+        @headers["PayPal-Client-Metadata-Id"] = pay_pal_client_metadata_id
+      end
+
+      def pay_pal_request_id(pay_pal_request_id)
+        @headers["PayPal-Request-Id"] = pay_pal_request_id
+      end
+
+      def prefer(prefer)
+        @headers["Prefer"] = prefer
+      end
+
+      def request_body(order_action_request)
+        @body = order_action_request
+      end
+    end
+  end
+end

data/lib/paypal/paypal_checkout_sdk/orders/orders_capture_request.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: false
+
+# This class was generated on Mon, 27 Aug 2018 13:51:59 PDT by version 0.1.0-dev+904328-dirty of Braintree SDK Generator
+
+require 'cgi'
+
+module PayPalCheckoutSdk
+  module Orders
+    #
+    # Captures a payment for an order.
+    #
+    class OrdersCaptureRequest
+      attr_accessor :path, :body, :headers, :verb
+
+      def initialize(order_id)
+        @headers = {}
+        @body = nil
+        @verb = "POST"
+        @path = "/v2/checkout/orders/{order_id}/capture?"
+
+        @path = @path.gsub("{order_id}", CGI.escape(order_id.to_s))
+        @headers["Content-Type"] = "application/json"
+      end
+
+      def pay_pal_client_metadata_id(pay_pal_client_metadata_id)
+        @headers["PayPal-Client-Metadata-Id"] = pay_pal_client_metadata_id
+      end
+
+      def pay_pal_request_id(pay_pal_request_id)
+        @headers["PayPal-Request-Id"] = pay_pal_request_id
+      end
+
+      def prefer(prefer)
+        @headers["Prefer"] = prefer
+      end
+
+      def request_body(order_action_request)
+        @body = order_action_request
+      end
+    end
+  end
+end

data/lib/paypal/paypal_checkout_sdk/orders/orders_create_request.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: false
+
+# This class was generated on Mon, 27 Aug 2018 13:51:59 PDT by version 0.1.0-dev+904328-dirty of Braintree SDK Generator
+
+require 'cgi'
+
+module PayPalCheckoutSdk
+  module Orders
+    #
+    # Creates an order. Supports only orders with one purchase unit.
+    #
+    class OrdersCreateRequest
+      attr_accessor :path, :body, :headers, :verb
+
+      def initialize
+        @headers = {}
+        @body = nil
+        @verb = "POST"
+        @path = "/v2/checkout/orders?"
+        @headers["Content-Type"] = "application/json"
+      end
+
+      def pay_pal_partner_attribution_id(pay_pal_partner_attribution_id)
+        @headers["PayPal-Partner-Attribution-Id"] = pay_pal_partner_attribution_id
+      end
+
+      def prefer(prefer)
+        @headers["Prefer"] = prefer
+      end
+
+      def request_body(order)
+        @body = order
+      end
+    end
+  end
+end

data/lib/paypal/paypal_checkout_sdk/orders/orders_get_request.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: false
+
+# This class was generated on Mon, 27 Aug 2018 13:51:59 PDT by version 0.1.0-dev+904328-dirty of Braintree SDK Generator
+
+require 'cgi'
+
+module PayPalCheckoutSdk
+  module Orders
+    #
+    # Shows details for an order, by ID.
+    #
+    class OrdersGetRequest
+      attr_accessor :path, :body, :headers, :verb
+
+      def initialize(order_id)
+        @headers = {}
+        @body = nil
+        @verb = "GET"
+        @path = "/v2/checkout/orders/{order_id}?"
+
+        @path = @path.gsub("{order_id}", CGI.escape(order_id.to_s))
+        @headers["Content-Type"] = "application/json"
+      end
+    end
+  end
+end

data/lib/paypal/paypal_checkout_sdk/orders/orders_patch_request.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: false
+
+# This class was generated on Mon, 27 Aug 2018 13:51:59 PDT by version 0.1.0-dev+904328-dirty of Braintree SDK Generator
+
+require 'cgi'
+
+module PayPalCheckoutSdk
+  module Orders
+    #
+    # Updates an order that has the `CREATED` or `APPROVED` status. You cannot update an order with `COMPLETED` status.
+    # You can patch these attributes and objects:
+    # <table>
+    #   <thead>
+    #     <tr>
+    #       <th align="left">Attribute or object</th>
+    #       <th align="left">Operations</th>
+    #     </tr>
+    #   </thead>
+    #   <tbody>
+    #     <tr>
+    #       <td><code>intent</code></td>
+    #       <td align="left">Replace</td>
+    #     </tr>
+    #     <tr>
+    #       <td><code>purchase_units</code></td>
+    #       <td align="left">Replace, add</td>
+    #     </tr>
+    #     <tr>
+    #       <td><code>purchase_units[].custom_id</code></td>
+    #       <td align="left">Replace, add, remove</td>
+    #     </tr>
+    #     <tr>
+    #      <td><code>purchase_units[].description</code></td>
+    #      <td align="left">Replace, add, remove</td>
+    #     </tr>
+    #     <tr>
+    #       <td><code>purchase_units[].payee.email</code></td>
+    #       <td align="left">Replace, add</td>
+    #     </tr>
+    #     <tr>
+    #       <td><code>purchase_units[].shipping</code></td>
+    #       <td align="left">Replace, add, remove</td>
+    #     </tr>
+    #     <tr>
+    #       <td><code>purchase_units[].soft_descriptor</code></td>
+    #       <td align="left">Replace, add, remove</td>
+    #     </tr>
+    #     <tr>
+    #       <td><code>purchase_units[].amount</code></td>
+    #       <td align="left">Replace</td>
+    #     </tr>
+    #     <tr>
+    #       <td><code>purchase_units[].invoice_id</code></td>
+    #       <td align="left">Replace, add, remove</td>
+    #     </tr>
+    #   </tbody>
+    # </table>
+    #
+    class OrdersPatchRequest
+      attr_accessor :path, :body, :headers, :verb
+
+      def initialize(order_id)
+        @headers = {}
+        @body = nil
+        @verb = "PATCH"
+        @path = "/v2/checkout/orders/{order_id}?"
+
+        @path = @path.gsub("{order_id}", CGI.escape(order_id.to_s))
+        @headers["Content-Type"] = "application/json"
+      end
+
+      def request_body(patch_request)
+        @body = patch_request
+      end
+    end
+  end
+end