paypal-rest-api 0.0.3 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9dac5031d1b2e2fe6f58b269801cd0e818280d4ed9b54fafc948e1b758d99b87
-  data.tar.gz: 4992abcc8678eca0bbc31702d49e6d6a596f7e614f3e8d6966a5716004adde26
+  metadata.gz: f8570bf045fe3986e03358401550d77f16dc5667c9da1c3e233fd07b95231c3e
+  data.tar.gz: e41098ed451a8997eff6bc0720f0c957c68fd843f8d2bee7b44cbd794c7913f0
 SHA512:
-  metadata.gz: 63cc5c666b4483eb92bd6d5282173cb2841b517eb39762421c5c546b23d4c2b1e44fe689495aa75dca15f1a86ac66064e9db7fa77d4d389deb1f0e370de107aa
-  data.tar.gz: 2e0e52e4fb9e324017f2af0fefe410daab14b01a3f7b322a686c00fb64ca8c1987bec7ece18958eb0c85327bb25f5f20e5fefdb5111043023efa29a049c8a893
+  metadata.gz: 193437cd7bf07228015eaead34a84952c14e02e3eca154df7df6df1eabcd28a26c4cc99a92ee16df03810b7c1c6824a4605fadf8e3008cf98053d1fa6cd1c883
+  data.tar.gz: dd2098b7c52ba4b8d1fc41a2152d7848168b7c831a2705acdfcacb5aab9ea3c80194401a2d883f7853fd8614cd4079c49788da0c6e7cfd35c614a7d41ff27f8c

data/README.md

@@ -16,36 +16,66 @@ bundle add paypal-rest-api
 
 ## Usage
 
-- All APIs accept optional `:query`, `:body` and `:headers` keyword parameters.
-- Response has `#body` method to get parsed JSON body.
-  This body has `symbolized` hash keys.
-- Response contains methods to get original HTTP response.
-- Failed request error (for non `2**` status codes) contains HTTP request and
-  response
-- Failed request error (for network errors) contains request and original error
+There are two options:
+
+- Setting global client
+- Setting local client (for possibility to use multiple PayPal environments)
+
+### Setting global client
 
 ```ruby
-# Initiate client
+# in config/initializers/paypal_rest_api.rb
+PaypalAPI.client = PaypalAPI::Client.new(
+  client_id: ENV['PAYPAL_CLIENT_ID'],
+  client_secret: ENV['PAYPAL_CLIENT_SECRET'],
+  live: false
+)
+
+# in your business logic
+response = PaypalAPI::Orders.show(order_id)
+response = PaypalAPI::Orders.create(body: body)
+```
+
+### Setting local client
+
+```ruby
+# in your business logic
 client = PaypalAPI::Client.new(
   client_id: ENV['PAYPAL_CLIENT_ID'],
   client_secret: ENV['PAYPAL_CLIENT_SECRET'],
   live: false
 )
 
-# Usage example:
-response = client.orders.create(body: body)
 response = client.orders.show(order_id)
-response = client.authorized_payments.capture(authorization_id, headers: headers)
-response = client.webhooks.list(query: query)
+response = client.orders.create(body: body)
+```
+
+### Client REST methods
+
+Client can call HTTP methods directly:
 
-# Client also can send requests directly, bypassing specific resources methods
+```ruby
 response = client.post(path, query: query, body: body, headers: headers)
 response = client.get(path, query: query, body: body, headers: headers)
 response = client.patch(path, query: query, body: body, headers: headers)
 response = client.put(path, query: query, body: body, headers: headers)
 response = client.delete(path, query: query, body: body, headers: headers)
 
-# Getting response
+# Or, after setting global client:
+response = PaypalAPI.post(path, query: query, body: body, headers: headers)
+response = PaypalAPI.get(path, query: query, body: body, headers: headers)
+response = PaypalAPI.patch(path, query: query, body: body, headers: headers)
+response = PaypalAPI.put(path, query: query, body: body, headers: headers)
+response = PaypalAPI.delete(path, query: query, body: body, headers: headers)
+```
+
+### Parsing response
+
+`response.body` is a main method that returns parsed JSON respoonse as a HASH.
+
+There are also many others helpful methods:
+
+```
 response.body # Parsed JSON. JSON is parsed lazyly, keys are symbolized.
 response[:foo] # Gets :foo attribute from parsed body
 response.fetch(:foo) # Fetches :foo attribute from parsed body
@@ -56,32 +86,6 @@ response.http_headers # Hash with response headers (keys are strings)
 response.requested_at # Time when request was sent
 ```
 
-Also PaypalAPI client can be added globally and class methods can be used instead:
-
-```ruby
-# in config/initializers/paypal_api.rb
-PaypalAPI.client = PaypalAPI::Client.new(
-  client_id: ENV['PAYPAL_CLIENT_ID'],
-  client_secret: ENV['PAYPAL_CLIENT_SECRET'],
-  live: false
-)
-
-# in your business logic
-response = PaypalAPI.orders.create(body: body)
-response = PaypalAPI.webhooks.verify(body: body)
-
-# same
-PaypalAPI::Orders.create(body: body)
-PaypalAPI::Webhooks.verify(body: body)
-
-# Also now PaypalAPI class can be used as a client
-response = PaypalAPI.post(path, query: query, body: body, headers: headers)
-response = PaypalAPI.get(path, query: query, body: body, headers: headers)
-response = PaypalAPI.patch(path, query: query, body: body, headers: headers)
-response = PaypalAPI.put(path, query: query, body: body, headers: headers)
-response = PaypalAPI.delete(path, query: query, body: body, headers: headers)
-```
-
 ## Configuration options
 
 PaypalAPI client accepts this additional options: `:live`, `:retries`, `:http_opts`
@@ -168,11 +172,12 @@ All errors have additional methods:
 
 ```ruby
 begin
-  response = PaypalAPI.payments.capture(authorization_id, body: body)
+  response = PaypalAPI.authorized_payments.capture(authorization_id, body: body)
 rescue PaypalAPI::Error => error
   YourLogger.error(
     error,
     context: {
+      paypal_request_id: error.paypal_request_id,
       error_name: error.error_name,
       error_message: error.error_message,
       error_debug_id: error.error_debug_id,
@@ -184,17 +189,183 @@ end
 
 ```
 
+## APIs
+
+All API endpoints accept this parameters:
+
+- `resource_id` - Resource ID (Unless `create`/`list` endpoint)
+- `query` - Hash with request query params
+- `body` - Hash with request body params
+- `headers` - Hash with request headers
+
+### Orders
+
+- `PaypalAPI::Orders.create`
+- `PaypalAPI::Orders.show`
+- `PaypalAPI::Orders.update`
+- `PaypalAPI::Orders.confirm`
+- `PaypalAPI::Orders.authorize`
+- `PaypalAPI::Orders.capture`
+- `PaypalAPI::Orders.track`
+- `PaypalAPI::Orders.update_tracker`
+
+### Payments
+
+- `PaypalAPI::AuthorizedPayment.show`
+- `PaypalAPI::AuthorizedPayment.capture`
+- `PaypalAPI::AuthorizedPayment.reauthorize`
+- `PaypalAPI::AuthorizedPayment.void`
+
+<!-- -->
+
+- `PaypalAPI::CapturedPayment.show`
+- `PaypalAPI::CapturedPayment.refund`
+
+<!-- -->
+
+- `PaypalAPI::Refunds.show`
+
+### Webhooks
+
+- `PaypalAPI::Webhooks.create`
+- `PaypalAPI::Webhooks.list`
+- `PaypalAPI::Webhooks.show`
+- `PaypalAPI::Webhooks.update`
+- `PaypalAPI::Webhooks.delete`
+- `PaypalAPI::Webhooks.event_types`
+- `PaypalAPI::Webhooks.verify`
+
+<!-- -->
+
+- `PaypalAPI::WebhookEvents.available`
+- `PaypalAPI::WebhookEvents.list`
+- `PaypalAPI::WebhookEvents.show`
+- `PaypalAPI::WebhookEvents.resend`
+- `PaypalAPI::WebhookEvents.simulate`
+
+<!-- -->
+
+- `PaypalAPI::WebhookLookups.create`
+- `PaypalAPI::WebhookLookups.list`
+- `PaypalAPI::WebhookLookups.show`
+- `PaypalAPI::WebhookLookups.delete`
+
+### Subscriptions
+
+- `PaypalAPI::Subscriptions.create`
+- `PaypalAPI::Subscriptions.show`
+- `PaypalAPI::Subscriptions.update`
+- `PaypalAPI::Subscriptions.revise`
+- `PaypalAPI::Subscriptions.suspend`
+- `PaypalAPI::Subscriptions.cancel`
+- `PaypalAPI::Subscriptions.activate`
+- `PaypalAPI::Subscriptions.capture`
+- `PaypalAPI::Subscriptions.transactions`
+
+<!-- -->
+
+- `PaypalAPI::SubscriptionPlans.create`
+- `PaypalAPI::SubscriptionPlans.list`
+- `PaypalAPI::SubscriptionPlans.show`
+- `PaypalAPI::SubscriptionPlans.update`
+- `PaypalAPI::SubscriptionPlans.activate`
+- `PaypalAPI::SubscriptionPlans.deactivate`
+- `PaypalAPI::SubscriptionPlans.update_pricing`
+
+### Shipment Tracking
+
+- `PaypalAPI::ShipmentTracking.add`
+- `PaypalAPI::ShipmentTracking.update`
+- `PaypalAPI::ShipmentTracking.show`
+
+### Catalog Products
+
+- `PaypalAPI::CatalogProducts.create`
+- `PaypalAPI::CatalogProducts.list`
+- `PaypalAPI::CatalogProducts.show`
+- `PaypalAPI::CatalogProducts.update`
+
+### Disputes
+
+- `PaypalAPI::Disputes.appeal`
+- `PaypalAPI::Disputes.make_offer`
+- `PaypalAPI::Disputes.show`
+- `PaypalAPI::Disputes.update`
+- `PaypalAPI::Disputes.send_message`
+- `PaypalAPI::Disputes.provide_supporting_info`
+- `PaypalAPI::Disputes.update_status`
+- `PaypalAPI::Disputes.deny_offer`
+- `PaypalAPI::Disputes.provide_evidence`
+- `PaypalAPI::Disputes.settle`
+- `PaypalAPI::Disputes.acknowledge_return_item`
+- `PaypalAPI::Disputes.accept_claim`
+- `PaypalAPI::Disputes.list`
+- `PaypalAPI::Disputes.escalate`
+- `PaypalAPI::Disputes.accept_offer`
+
+### UserInfo
+
+- `PaypalAPI::UserInfo.show`
+
+### Users
+
+- `PaypalAPI::Users.create`
+- `PaypalAPI::Users.list`
+- `PaypalAPI::Users.show`
+- `PaypalAPI::Users.update`
+- `PaypalAPI::Users.delete`
+
+### Invoices
+
+- `PaypalAPI::Invoices.create`
+- `PaypalAPI::Invoices.list`
+- `PaypalAPI::Invoices.show`
+- `PaypalAPI::Invoices.update`
+- `PaypalAPI::Invoices.delete`
+- `PaypalAPI::Invoices.search`
+- `PaypalAPI::Invoices.remind`
+- `PaypalAPI::Invoices.delete_refund`
+- `PaypalAPI::Invoices.delete_payment`
+- `PaypalAPI::Invoices.record_refund`
+- `PaypalAPI::Invoices.record_payment`
+- `PaypalAPI::Invoices.send_invoice`
+- `PaypalAPI::Invoices.cancel`
+- `PaypalAPI::Invoices.generate_qr_code`
+- `PaypalAPI::Invoices.generate_invoice_number`
+
+### InvoiceTemplates
+
+- `PaypalAPI::InvoiceTemplates.create`
+- `PaypalAPI::InvoiceTemplates.list`
+- `PaypalAPI::InvoiceTemplates.show`
+- `PaypalAPI::InvoiceTemplates.update`
+- `PaypalAPI::InvoiceTemplates.delete`
+
+### Payouts
+
+- `PaypalAPI::Payouts.create`
+- `PaypalAPI::Payouts.show`
+- `PaypalAPI::PayoutItems.show`
+- `PaypalAPI::PayoutItems.cancel`
+
+### ReferencedPayouts
+
+- `PaypalAPI::ReferencedPayouts.create`
+- `PaypalAPI::ReferencedPayouts.show`
+- `PaypalAPI::ReferencedPayoutItems.create`
+- `PaypalAPI::ReferencedPayoutItems.show`
+
 ## Development
 
 ```bash
-  bundle install
   rubocop
   rspec
+  mdl README.md CHANGELOG.md RELEASE.md
 ```
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at <https://github.com/aglushkov/paypal-api>.
+Bug reports and pull requests are welcome on GitHub at <https://github.com/aglushkov/paypal-rest-api>.
 
 ## License
 

data/VERSION

@@ -1 +1 @@
-0.0.3
+0.0.4

data/lib/paypal-api/access_token.rb

@@ -4,8 +4,20 @@ module PaypalAPI
   #
   # AccessToken object stores authorization string and its expire time.
   #
+  # @api private
+  #
   class AccessToken
-    attr_reader :requested_at, :expires_at, :authorization_string
+    # Time when access token request was sent
+    # @return [Time] Time
+    attr_reader :requested_at
+
+    # Time when access token request expires
+    # @return [Time] Time
+    attr_reader :expires_at
+
+    # Authorization string
+    # @return [String] Authorization string
+    attr_reader :authorization_string
 
     #
     # Initializes AccessToken object
@@ -32,7 +44,9 @@ module PaypalAPI
     end
 
     #
-    # Instance representation string. Default was overwritten to hide original access_token
+    # Instance representation string
+    #
+    # @return [String] Inspect value
     #
     def inspect
       "#<#{self.class.name} methods: (requested_at, expires_at, expired?, authorization_string)>"

data/lib/paypal-api/api_collection.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "uri"
+
 module PaypalAPI
   #
   # Base class for all PayPal API collections classes
@@ -22,5 +24,32 @@ module PaypalAPI
     def self.client
       PaypalAPI.client
     end
+
+    # Encodes URI component
+    # @param id [String] Unencoded URI component
+    # @return [String] Encoded URI component
+    def encode(id)
+      self.class.encode(id)
+    end
+
+    # :nocov:
+    if URI.respond_to?(:encode_uri_component)
+      # Encodes URI component
+      # @param id [String] Unencoded URI component
+      # @return [String] Encoded URI component
+      def self.encode(id)
+        URI.encode_uri_component(id)
+      end
+    else
+      # Encodes URI component
+      # @param id [String] Unencoded URI component
+      # @return [String] Encoded URI component
+      def self.encode(id)
+        encoded_id = URI.encode_www_form_component(id)
+        encoded_id.gsub!("+", "%20")
+        encoded_id
+      end
+    end
+    # :nocov:
   end
 end

data/lib/paypal-api/api_collections/authorized_payments.rb

@@ -26,7 +26,7 @@ module PaypalAPI
       # @macro request
       #
       def show(authorization_id, query: nil, body: nil, headers: nil)
-        client.get("/v2/payments/authorizations/#{authorization_id}", query: query, body: body, headers: headers)
+        client.get("/v2/payments/authorizations/#{encode(authorization_id)}", query: query, body: body, headers: headers)
       end
 
       #
@@ -38,7 +38,7 @@ module PaypalAPI
       # @macro request
       #
       def capture(authorization_id, query: nil, body: nil, headers: nil)
-        client.post("/v2/payments/authorizations/#{authorization_id}/capture", query: query, body: body, headers: headers)
+        client.post("/v2/payments/authorizations/#{encode(authorization_id)}/capture", query: query, body: body, headers: headers)
       end
 
       # Reauthorize authorized payment
@@ -49,7 +49,7 @@ module PaypalAPI
       # @macro request
       #
       def reauthorize(authorization_id, query: nil, body: nil, headers: nil)
-        client.post("/v2/payments/authorizations/#{authorization_id}/reauthorize", query: query, body: body, headers: headers)
+        client.post("/v2/payments/authorizations/#{encode(authorization_id)}/reauthorize", query: query, body: body, headers: headers)
       end
 
       # Void authorized payment
@@ -60,7 +60,7 @@ module PaypalAPI
       # @macro request
       #
       def void(authorization_id, query: nil, body: nil, headers: nil)
-        client.post("/v2/payments/authorizations/#{authorization_id}/void", query: query, body: body, headers: headers)
+        client.post("/v2/payments/authorizations/#{encode(authorization_id)}/void", query: query, body: body, headers: headers)
       end
     end
 

data/lib/paypal-api/api_collections/captured_payments.rb

@@ -26,7 +26,7 @@ module PaypalAPI
       # @macro request
       #
       def show(capture_id, query: nil, body: nil, headers: nil)
-        client.get("/v2/payments/captures/#{capture_id}", query: query, body: body, headers: headers)
+        client.get("/v2/payments/captures/#{encode(capture_id)}", query: query, body: body, headers: headers)
       end
 
       #
@@ -38,7 +38,7 @@ module PaypalAPI
       # @macro request
       #
       def refund(capture_id, query: nil, body: nil, headers: nil)
-        client.post("/v2/payments/captures/#{capture_id}/refund", query: query, body: body, headers: headers)
+        client.post("/v2/payments/captures/#{encode(capture_id)}/refund", query: query, body: body, headers: headers)
       end
     end
 

data/lib/paypal-api/api_collections/catalog_products.rb

@@ -48,7 +48,7 @@ module PaypalAPI
       # @macro request
       #
       def show(product_id, query: nil, body: nil, headers: nil)
-        client.get("/v1/catalogs/products/#{product_id}", query: query, body: body, headers: headers)
+        client.get("/v1/catalogs/products/#{encode(product_id)}", query: query, body: body, headers: headers)
       end
 
       #
@@ -60,7 +60,7 @@ module PaypalAPI
       # @macro request
       #
       def update(product_id, query: nil, body: nil, headers: nil)
-        client.patch("/v1/catalogs/products/#{product_id}", query: query, body: body, headers: headers)
+        client.patch("/v1/catalogs/products/#{encode(product_id)}", query: query, body: body, headers: headers)
       end
     end
 

data/lib/paypal-api/api_collections/disputes.rb

@@ -0,0 +1,188 @@
+# frozen_string_literal: true
+
+module PaypalAPI
+  #
+  # Manages customer disputes
+  #
+  # @see https://developer.paypal.com/docs/api/customer-disputes/v1/
+  #
+  class Disputes < APICollection
+    #
+    # Common class and instance methods
+    #
+    module APIs
+      # @!macro [new] request
+      #   @param query [Hash, nil] Request query parameters
+      #   @param body [Hash, nil] Request body parameters
+      #   @param headers [Hash, nil] Request headers
+      #   @return [Response] Response object
+
+      #
+      # Appeal dispute
+      #
+      # @see https://developer.paypal.com/docs/api/customer-disputes/v1/#disputes_appeal
+      # @param dispute_id [String] Dispute ID
+      # @macro request
+      #
+      def appeal(dispute_id, query: nil, body: nil, headers: nil)
+        client.post("/v1/customer/disputes/#{encode(dispute_id)}/appeal", query: query, body: body, headers: headers)
+      end
+
+      #
+      # Make offer to resolve dispute
+      #
+      # @see https://developer.paypal.com/docs/api/customer-disputes/v1/#disputes_make-offer
+      # @param dispute_id [String] Dispute ID
+      # @macro request
+      #
+      def make_offer(dispute_id, query: nil, body: nil, headers: nil)
+        client.post("/v1/customer/disputes/#{encode(dispute_id)}/make-offer", query: query, body: body, headers: headers)
+      end
+
+      #
+      # Show dispute details
+      #
+      # @see https://developer.paypal.com/docs/api/customer-disputes/v1/#disputes_get
+      # @param dispute_id [String] Dispute ID
+      # @macro request
+      #
+      def show(dispute_id, query: nil, body: nil, headers: nil)
+        client.get("/v1/customer/disputes/#{encode(dispute_id)}", query: query, body: body, headers: headers)
+      end
+
+      #
+      # Update dispute
+      #
+      # @see https://developer.paypal.com/docs/api/customer-disputes/v1/#disputes_patch
+      # @param dispute_id [String] Dispute ID
+      # @macro request
+      #
+      def update(dispute_id, query: nil, body: nil, headers: nil)
+        client.patch("/v1/customer/disputes/#{encode(dispute_id)}", query: query, body: body, headers: headers)
+      end
+
+      #
+      # Send message about dispute to other party
+      #
+      # @see https://developer.paypal.com/docs/api/customer-disputes/v1/#disputes_send-message
+      # @param dispute_id [String] Dispute ID
+      # @macro request
+      #
+      def send_message(dispute_id, query: nil, body: nil, headers: nil)
+        client.post("/v1/customer/disputes/#{encode(dispute_id)}/send-message", query: query, body: body, headers: headers)
+      end
+
+      #
+      # Provide supporting information for dispute
+      #
+      # @see https://developer.paypal.com/docs/api/customer-disputes/v1/#disputes_provide-supporting-info
+      # @param dispute_id [String] Dispute ID
+      # @macro request
+      #
+      def provide_supporting_info(dispute_id, query: nil, body: nil, headers: nil)
+        client.post("/v1/customer/disputes/#{encode(dispute_id)}/provide-supporting-info", query: query, body: body, headers: headers)
+      end
+
+      #
+      # Update dispute status
+      #
+      # @see https://developer.paypal.com/docs/api/customer-disputes/v1/#disputes_require-evidence
+      # @param dispute_id [String] Dispute ID
+      # @macro request
+      #
+      def update_status(dispute_id, query: nil, body: nil, headers: nil)
+        client.post("/v1/customer/disputes/#{encode(dispute_id)}/require-evidence", query: query, body: body, headers: headers)
+      end
+
+      #
+      # Deny offer to resolve dispute
+      #
+      # @see https://developer.paypal.com/docs/api/customer-disputes/v1/#disputes_deny-offer
+      # @param dispute_id [String] Dispute ID
+      # @macro request
+      #
+      def deny_offer(dispute_id, query: nil, body: nil, headers: nil)
+        client.post("/v1/customer/disputes/#{encode(dispute_id)}/deny-offer", query: query, body: body, headers: headers)
+      end
+
+      #
+      # Provide evidence
+      #
+      # @see https://developer.paypal.com/docs/api/customer-disputes/v1/#disputes_provide-evidence
+      # @param dispute_id [String] Dispute ID
+      # @macro request
+      #
+      def provide_evidence(dispute_id, query: nil, body: nil, headers: nil)
+        client.post("/v1/customer/disputes/#{encode(dispute_id)}/provide-evidence", query: query, body: body, headers: headers)
+      end
+
+      #
+      # Settle dispute
+      #
+      # @see https://developer.paypal.com/docs/api/customer-disputes/v1/#disputes_adjudicate
+      # @param dispute_id [String] Dispute ID
+      # @macro request
+      #
+      def settle(dispute_id, query: nil, body: nil, headers: nil)
+        client.post("/v1/customer/disputes/#{encode(dispute_id)}/adjudicate", query: query, body: body, headers: headers)
+      end
+
+      #
+      # Acknowledge returned item
+      #
+      # @see https://developer.paypal.com/docs/api/customer-disputes/v1/#disputes_acknowledge-return-item
+      # @param dispute_id [String] Dispute ID
+      # @macro request
+      #
+      def acknowledge_return_item(dispute_id, query: nil, body: nil, headers: nil)
+        client.post("/v1/customer/disputes/#{encode(dispute_id)}/acknowledge-return-item", query: query, body: body, headers: headers)
+      end
+
+      #
+      # Accept claim
+      #
+      # @see https://developer.paypal.com/docs/api/customer-disputes/v1/#disputes_accept-claim
+      # @param dispute_id [String] Dispute ID
+      # @macro request
+      #
+      def accept_claim(dispute_id, query: nil, body: nil, headers: nil)
+        client.post("/v1/customer/disputes/#{encode(dispute_id)}/accept-claim", query: query, body: body, headers: headers)
+      end
+
+      #
+      # List disputes
+      #
+      # @see https://developer.paypal.com/docs/api/customer-disputes/v1/#disputes_list
+      # @macro request
+      #
+      def list(query: nil, body: nil, headers: nil)
+        client.get("/v1/customer/disputes", query: query, body: body, headers: headers)
+      end
+
+      #
+      # Escalate dispute to claim
+      #
+      # @see https://developer.paypal.com/docs/api/customer-disputes/v1/#disputes_escalate
+      # @param dispute_id [String] Dispute ID
+      # @macro request
+      #
+      def escalate(dispute_id, query: nil, body: nil, headers: nil)
+        client.post("/v1/customer/disputes/#{encode(dispute_id)}/escalate", query: query, body: body, headers: headers)
+      end
+
+      #
+      # Accept offer to resolve dispute
+      #
+      # @see https://developer.paypal.com/docs/api/customer-disputes/v1/#disputes_accept-offer
+      # @param dispute_id [String] Dispute ID
+      # @macro request
+      #
+      def accept_offer(dispute_id, query: nil, body: nil, headers: nil)
+        client.post("/v1/customer/disputes/#{encode(dispute_id)}/accept-offer", query: query, body: body, headers: headers)
+      end
+    end
+
+    include APIs
+    extend APIs
+  end
+end