workarea-gift_cards 3.4.10 → 4.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: e5ce7f4c60c63f9f96b8683527e9fbbbf375af62
-  data.tar.gz: b93a65061af79af2a91e2fd0449a687a3b8f5250
+SHA256:
+  metadata.gz: 4640c0b94ade3085580304d3a0220f85cb73a570d93e3a7c945081a1bda0a72f
+  data.tar.gz: bcab8a176b67c59e809a89d0b459d3f01dd123d91e05b6aab8f51f3ea13766cd
 SHA512:
-  metadata.gz: 2eddb8f458fb6ffe22ccb1e476557639de20a89d83d959e9956b420063e58bf32d9293308bf03eb176bd28e4d05df37ef0e3e8e4393ea8e971ccd4c48e3392b9
-  data.tar.gz: 2cc8d19326e64c599e56e2e0ee172803b46887d17ce673fe3d29995a24fc33d3a3210a5036ecf41c1236d35e570085c5376da16e7a3bb04c57a67689ccd3b5b5
+  metadata.gz: 4f8f96a3442cabeb3cc94aef6fd542b6a77d0c792947cf795edade12f36f6e67ca1ef743632415a2d4d689990e2f70eeefa8a4b28024699f44658851eeb2e18f
+  data.tar.gz: 800f842ad499e8adac230b8fabc356ad890d82c38f8269f449baf2e0f5082740e092df674c14c43c3c2b4a038bad49a9b4e7d13897aab24415668232285c5743

data/{.eslintrc → .eslintrc.json}

@@ -1,7 +1,8 @@
 {
     "extends": "eslint:recommended",
     "rules": {
-      "semi": [1, "always"]
+      "semi": ["error", "always"],
+      "eqeqeq": ["error", "always"]
     },
     "globals": {
       "window": true,
@@ -20,5 +21,15 @@
       "Waypoint": true,
       "wysihtml": true,
       "LocalTime": true,
+      "describe": true,
+      "after": true,
+      "afterEach": true,
+      "before": true,
+      "beforeEach": true,
+      "it": true,
+      "expect": true,
+      "sinon": true,
+      "fixture": true,
+      "chai": true
     }
 }

data/.github/workflows/ci.yml

@@ -1,14 +1,16 @@
 name: CI
 on: [push]
-env:
-  BUNDLE_GEMS__WEBLINC__COM: ${{ secrets.BUNDLE_GEMS__WEBLINC__COM }}
+
 jobs:
   static_analysis:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v1
-    - uses: workarea-commerce/ci/bundler-audit@ruby-2.4
-    - uses: workarea-commerce/ci/rubocop@ruby-2.4
+    - uses: workarea-commerce/ci/bundler-audit@v1
+    - uses: workarea-commerce/ci/rubocop@v1
+    - uses: workarea-commerce/ci/eslint@v1
+      with:
+        args: '**/*.js'
 
   admin_tests:
     runs-on: ubuntu-latest
@@ -16,7 +18,7 @@ jobs:
     - uses: actions/checkout@v1
     - uses: actions/setup-ruby@v1
       with:
-        ruby-version: 2.4.x
+        ruby-version: 2.6.x
     - uses: workarea-commerce/ci/test@v1
       with:
         command: bin/rails app:workarea:test:admin
@@ -27,7 +29,7 @@ jobs:
     - uses: actions/checkout@v1
     - uses: actions/setup-ruby@v1
       with:
-        ruby-version: 2.4.x
+        ruby-version: 2.6.x
     - uses: workarea-commerce/ci/test@v1
       with:
         command: bin/rails app:workarea:test:core
@@ -38,7 +40,7 @@ jobs:
     - uses: actions/checkout@v1
     - uses: actions/setup-ruby@v1
       with:
-        ruby-version: 2.4.x
+        ruby-version: 2.6.x
     - uses: workarea-commerce/ci/test@v1
       with:
         command: bin/rails app:workarea:test:storefront
@@ -49,7 +51,7 @@ jobs:
     - uses: actions/checkout@v1
     - uses: actions/setup-ruby@v1
       with:
-        ruby-version: 2.4.x
+        ruby-version: 2.6.x
     - uses: workarea-commerce/ci/test@v1
       with:
         command: bin/rails app:workarea:test:plugins

data/.rubocop.yml

@@ -1,197 +1,2 @@
-AllCops:
-  TargetRubyVersion: 2.4
-  # RuboCop has a bunch of cops enabled by default. This setting tells RuboCop
-  # to ignore them, so only the ones explicitly set in this file are enabled.
-  DisabledByDefault: true
-
-# Prefer &&/|| over and/or.
-Style/AndOr:
-  Enabled: true
-  Exclude:
-    - 'testing/lib/workarea/performance_test.rb'
-    - 'admin/app/controllers/workarea/admin/help_authorization.rb'
-    - 'admin/app/controllers/workarea/admin/users_controller.rb'
-    - 'core/app/controllers/workarea/authorization.rb'
-    - 'core/app/models/workarea/analytics/time_series.rb'
-    - 'core/app/models/workarea/payment/operation.rb'
-    - 'core/lib/workarea/validators/ip_address_validator.rb'
-    - 'script/rename'
-    - 'storefront/app/controllers/workarea/storefront/checkout/place_order_controller.rb'
-    - 'storefront/app/controllers/workarea/storefront/current_checkout.rb'
-    - 'storefront/app/controllers/workarea/storefront/searches_controller.rb'
-    - 'storefront/app/controllers/workarea/storefront/users/orders_controller.rb'
-    - 'storefront/app/controllers/workarea/storefront/users/passwords_controller.rb'
-
-# Align `when` with `case`.
-Layout/CaseIndentation:
-  Enabled: true
-  Exclude:
-    - 'admin/app/helpers/workarea/admin/dashboard_helper.rb'
-
-# Align comments with method definitions.
-Layout/CommentIndentation:
-  Enabled: true
-
-Layout/EmptyLineAfterMagicComment:
-  Enabled: true
-
-# In a regular class definition, no empty lines around the body.
-Layout/EmptyLinesAroundClassBody:
-  Enabled: true
-  Exclude:
-    - 'admin/app/controllers/workarea/admin/release_sessions_controller.rb'
-    - 'admin/app/view_models/workarea/admin/release_calendar_view_model.rb'
-    - 'admin/lib/workarea/mailer_previews/admin/comment_mailer_preview.rb'
-    - 'admin/test/integration/workarea/admin/content_blocks_integration_test.rb'
-    - 'admin/test/view_models/workarea/admin/content_view_model_test.rb'
-    - 'core/app/models/workarea/checkout/steps/addresses.rb'
-    - 'core/app/models/workarea/pricing/discount/buy_some_get_some/product_application.rb'
-    - 'core/app/queries/workarea/metadata/catalog_category.rb'
-    - 'core/app/queries/workarea/metadata/content_page.rb'
-    - 'core/app/queries/workarea/search/facet.rb'
-    - 'core/app/queries/workarea/search/range_filter.rb'
-    - 'core/config/initializers/13_rack_attack.rb'
-    - 'core/lib/generators/workarea/override/override_generator.rb'
-    - 'core/lib/workarea/elasticsearch/query_cache.rb'
-    - 'core/lib/workarea/monitoring/elasticsearch_check.rb'
-    - 'core/lib/workarea/monitoring/mongoid_check.rb'
-    - 'core/lib/workarea/monitoring/sidekiq_queue_size_check.rb'
-    - 'core/lib/workarea/validators/email_validator.rb'
-    - 'core/test/lib/workarea/mail_interceptor_test.rb'
-    - 'core/test/models/workarea/commentable_test.rb'
-    - 'core/test/models/workarea/search/settings_test.rb'
-    - 'core/test/models/workarea/shipping/rate_lookup_test.rb'
-    - 'core/test/queries/workarea/find_pipeline_asset_test.rb'
-    - 'core/test/queries/workarea/product_primary_image_url_test.rb'
-    - 'core/test/queries/workarea/search/filter_test.rb'
-    - 'core/test/workers/workarea/bulk_index_admin_test.rb'
-    - 'core/test/workers/workarea/bulk_index_products_test.rb'
-    - 'core/vendor/active_shipping/lib/active_shipping/carriers/australia_post.rb'
-    - 'core/vendor/active_shipping/lib/active_shipping/carriers/canada_post_pws.rb'
-    - 'core/vendor/active_shipping/lib/active_shipping/carriers/usps_returns.rb'
-    - 'core/vendor/active_shipping/lib/active_shipping/delivery_date_estimates_response.rb'
-    - 'core/vendor/active_shipping/lib/active_shipping/rate_response.rb'
-    - 'core/vendor/active_shipping/test/remote/australia_post_test.rb'
-    - 'core/vendor/active_shipping/test/remote/usps_returns_test.rb'
-    - 'core/vendor/active_shipping/test/unit/carriers/australia_post_test.rb'
-    - 'core/vendor/active_shipping/test/unit/carriers/canada_post_pws_test.rb'
-    - 'core/vendor/active_shipping/test/unit/carriers/usps_returns_test.rb'
-    - 'storefront/app/view_models/workarea/storefront/content_blocks/product_list_view_model.rb'
-    - 'storefront/app/view_models/workarea/storefront/product_view_model.rb'
-    - 'storefront/lib/workarea/mailer_previews/storefront/order_mailer_preview.rb'
-    - 'storefront/test/performance/workarea/storefront/categories_performance_test.rb'
-    - 'storefront/test/performance/workarea/storefront/search_performance_test.rb'
-    - 'storefront/test/view_models/workarea/storefront/user_activity_view_model_test.rb'
-
-# In a regular method definition, no empty lines around the body.
-Layout/EmptyLinesAroundMethodBody:
-  Enabled: true
-
-# In a regular module definition, no empty lines around the body.
-Layout/EmptyLinesAroundModuleBody:
-  Enabled: true
-  Exclude:
-    - 'core/lib/workarea/ext/mongoid/timestamps_timeless.rb'
-    - 'storefront/app/view_models/workarea/storefront/search_customization_content.rb'
-    - 'testing/lib/workarea/testing/warning_suppressor.rb'
-
-# Use Ruby >= 1.9 syntax for hashes. Prefer { a: :b } over { :a => :b }.
-Style/HashSyntax:
-  Enabled: true
-
-Layout/SpaceAfterColon:
-  Enabled: true
-  Exclude:
-    - 'testing/lib/workarea/testing/factories/content.rb'
-    - 'testing/lib/workarea/testing/factories/pricing.rb'
-
-Layout/SpaceAfterComma:
-  Enabled: true
-  Exclude:
-    - 'admin/app/controllers/workarea/admin/shipping_services_controller.rb'
-    - 'admin/test/helpers/workarea/admin/application_helper_test.rb'
-    - 'core/app/models/workarea/payment/credit_card.rb'
-    - 'core/app/models/workarea/pricing/request.rb'
-    - 'core/spec/lib/workarea/swappable_list_spec.rb'
-    - 'core/test/models/workarea/inventory_test.rb'
-    - 'core/test/queries/workarea/search/range_facet_test.rb'
-    - 'storefront/test/view_models/workarea/storefront/package_view_model_test.rb'
-
-Layout/SpaceAroundEqualsInParameterDefault:
-  Enabled: true
-  Exclude:
-    - 'admin/app/helpers/workarea/admin/content_block_icon_helper.rb'
-    - 'core/app/helpers/workarea/content_assets_helper.rb'
-    - 'core/lib/workarea/elasticsearch/query_cache.rb'
-    - 'testing/lib/workarea/system_test.rb'
-    - 'testing/lib/workarea/testing/locale_routing_fixes.rb'
-
-
-Layout/SpaceAroundKeyword:
-  Enabled: true
-
-Layout/SpaceAroundOperators:
-  Enabled: true
-  Exclude:
-    - 'admin/app/controllers/workarea/admin/content_emails_controller.rb'
-    - 'admin/app/controllers/workarea/admin/users_controller.rb'
-    - 'core/app/helpers/workarea/content_assets_helper.rb'
-    - 'core/vendor/active_shipping/lib/active_shipping/carriers/canada_post_pws.rb'
-    - 'core/vendor/active_shipping/lib/active_shipping/carriers/fedex.rb'
-    - 'core/vendor/active_shipping/lib/active_shipping/carriers/stamps.rb'
-
-Layout/SpaceBeforeFirstArg:
-    Enabled: true
-
-# Defining a method with parameters needs parentheses.
-Style/MethodDefParentheses:
-  Enabled: true
-
-# Use `foo {}` not `foo{}`.
-Layout/SpaceBeforeBlockBraces:
-  Enabled: true
-  Exclude:
-    - 'admin/app/view_models/workarea/admin/release_calendar_view_model.rb'
-
-# Use `foo { bar }` not `foo {bar}`.
-Layout/SpaceInsideBlockBraces:
-  Enabled: true
-
-# Use `{ a: 1 }` not `{a:1}`.
-Layout/SpaceInsideHashLiteralBraces:
-  Enabled: true
-  Exclude:
-    - 'admin/test/integration/workarea/admin/pricing_sku_prices_integration_test.rb'
-    - 'admin/test/integration/workarea/admin/shipping_service_integration_test.rb'
-    - 'admin/test/integration/workarea/admin/tax_categories_integration_test.rb'
-    - 'admin/test/view_models/workarea/admin/changeset_view_model_test.rb'
-    - 'core/app/models/workarea/release/changeset.rb'
-    - 'core/app/queries/workarea/search/product_rules.rb'
-    - 'core/app/queries/workarea/search/term_filter.rb'
-    - 'core/lib/workarea/configuration.rb'
-    - 'core/spec/models/workarea/order_spec.rb'
-    - 'core/test/models/workarea/application_document_test.rb'
-    - 'core/test/models/workarea/fulfillment_test.rb'
-    - 'core/test/queries/workarea/search/product_rules_test.rb'
-    - 'core/test/workers/workarea/generate_content_metadata_test.rb'
-
-Layout/SpaceInsideParens:
-  Enabled: true
-  Exclude:
-    - 'core/app/models/workarea/inventory/collection.rb'
-    - 'core/app/models/workarea/pricing/calculators/item_calculator.rb'
-    - 'core/spec/models/workarea/order/queries_spec.rb'
-
-# Detect hard tabs, no hard tabs.
-Layout/Tab:
-  Enabled: true
-  Exclude:
-    - 'core/vendor/active_shipping/lib/active_shipping/carriers/canada_post.rb'
-
-# No trailing whitespace.
-Layout/TrailingWhitespace:
-  Enabled: true
-
-# Use my_method(my_arg) not my_method( my_arg ) or my_method my_arg.
-Lint/RequireParentheses:
-  Enabled: true
+inherit_from:
+  - https://raw.githubusercontent.com/workarea-commerce/workarea/master/.rubocop.yml

data/.stylelintrc.json

@@ -0,0 +1,8 @@
+{
+  "extends": "stylelint-config-recommended-scss",
+  "rules": {
+    "block-no-empty": null,
+    "no-descending-specificity": null,
+    "property-no-unknown": [true, { "ignoreProperties": ["mso-hide"] }]
+  }
+}

data/CHANGELOG.md

@@ -1,41 +1,44 @@
-Workarea Gift Cards 3.4.10 (2020-02-04)
+Workarea Gift Cards 4.0.3 (2020-08-19)
 --------------------------------------------------------------------------------
 
-*   Fix the Gemfile
+*   Fix Update Step Result
 
-    Tom Scott
-
-*   Remove ESLint from Gift Cards build
+    Prevent returning `false` early when no Gift Card params are set. This
+    ensures the step won't block checkout.
 
     Tom Scott
 
-*   Fix rubocop config for 2.4
+*   Improve Test Experience For Custom Gift Card Gateways
 
-    Tom Scott
+    If you're creating a new custom gift card gateway for your project, and
+    you want to use the tests from base as a starting point for that
+    integration, you currently must duplicate the tests from the plugin in
+    your own plugin, which makes things a bit harder but also removes the
+    ability to take on updates to the test in case of bug fixes. To improve
+    this experience, the `Workarea::GiftCards::GatewayTest` has been
+    modified to more easily allow decorating it in a host application. All
+    tests are now wrapped in a VCR cassette whose name is defined by the
+    parameterized gateway class name and the name of the method being
+    tested. This will activate and create cassettes in the real world when a
+    gateway makes an outbound HTTP call, similar to
+    `CreditCardIntegrationTest`.
 
-*   Use the same ruby version on static analysis as we use in tests
+    GIFTCARDS-9
 
     Tom Scott
 
-*   Use the same env var everywhere
 
-    Tom Scott
 
-*   Backport Missing `:via` Param
+Workarea Gift Cards 4.0.2 (2020-03-03)
+--------------------------------------------------------------------------------
 
-    The `:via` param was not included on the gift card template, causing a
-    test in base to fail and subsequently block other plugin development
-    that depends on this gem. This change is from a later version of
-    Workarea, but was not backported to earlier versions. Additionally, this
-    commit adds the test workflow and ensures the correct version of
-    Workarea is being loaded to ensure accurate testing.
+*   Fix misaligned test class name
 
-    GIFTCARDS-7
-    Tom Scott
+    Ben Crouse
 
 
 
-Workarea Gift Cards 3.4.9 (2020-01-21)
+Workarea Gift Cards 4.0.1 (2020-01-21)
 --------------------------------------------------------------------------------
 
 *   Fix Tests for 2020
@@ -46,6 +49,23 @@ Workarea Gift Cards 3.4.9 (2020-01-21)
     GIFTCARDS-6
     Tom Scott
 
+*   Fix Tests for 2020
+
+    Update all tests so that they no longer depend on the year 2020 as an
+    expiration year. Instead, use the  method provided by Workarea.
+
+    GIFTCARDS-6
+    Tom Scott
+
+
+
+Workarea Gift Cards 4.0.0 (2019-11-26)
+--------------------------------------------------------------------------------
+
+*   Use custom fulfillment policy for digital gift card generation
+
+    Curt Howard
+
 
 
 Workarea Gift Cards 3.4.7 (2019-09-04)

data/Gemfile

@@ -1,9 +1,7 @@
 source 'https://rubygems.org'
-git_source(:github) { |repo| "git@github.com:#{repo}.git" }
+git_source(:github) { |repo| "https://github.com/#{repo}.git" }
 
 gemspec
 
-source 'https://gems.weblinc.com' do
-  gem 'workarea', '~> 3.3.0'
-  gem 'workarea-api', '~> 4.3.0'
-end
+gem 'workarea-api', github: 'workarea-commerce/workarea-api'
+gem 'workarea', github: 'workarea-commerce/workarea', branch: 'v3.5-stable'

data/README.md

@@ -107,11 +107,35 @@ end
 
 Note that it is set to a string of the class constant, and not an instance of the class. The system constantizes and initializes a new instance whenever it uses the gateway to ensure autoloading works correctly and so a gateway that cares about the current state of the application is applied correctly. This is most relevant in multi-site environments where each site might want to use their own gift card gateway.
 
+### Testing Your Custom Gateway
+
+Workarea comes with unit tests for the main Gateway class, and you can
+decorate this test to provide your own setup code. A minimal
+implementation would look as follows:
+
+```ruby
+module Workarea
+  module GiftCards
+    decorate GatewayTest do
+      # Provide your own Gateway instance here to use it in each test.
+      def gateway
+        CustomGiftCardGateway.new
+      end
+
+      # Provide a custom object representing a Gift Card on your
+      # 3rd-party service.
+      def gift_card
+        CustomGiftCard.new(balance: 10.to_m)
+      end
+    end
+  end
+end
+```
 
 Workarea Commerce Documentation
 --------------------------------------------------------------------------------
 
-See [https://developer.workarea.com](https://developer.workarea.com) for Workarea Commerce documentation.
+See [https://developer.workarea.com](https://developer.workarea.com) for Workarea Commerce documentation
 
 License
 --------------------------------------------------------------------------------

data/app/controllers/workarea/api/admin/gift_cards_controller.rb

@@ -0,0 +1,309 @@
+module Workarea
+  if Plugin.installed?(:api)
+    module Api
+      module Admin
+        class GiftCardsController < Admin::ApplicationController
+          before_action :find_gift_card, except: [:index, :create, :bulk]
+
+          swagger_path '/gift_cards' do
+            operation :get do
+              key :summary, 'All Gift cards'
+              key :description, 'Returns all gift cards from the system'
+              key :operationId, 'listGiftCards'
+              key :produces, ['application/json']
+
+              parameter do
+                key :name, :page
+                key :in, :query
+                key :description, 'Current page'
+                key :required, false
+                key :type, :integer
+                key :default, 1
+              end
+              parameter do
+                key :name, :sort_by
+                key :in, :query
+                key :description, 'Field on which to sort (see responses for possible values)'
+                key :required, false
+                key :type, :string
+                key :default, 'created_at'
+              end
+              parameter do
+                key :name, :sort_direction
+                key :in, :query
+                key :description, 'Direction for sort by'
+                key :type, :string
+                key :enum, %w(asc desc)
+                key :default, 'desc'
+              end
+
+              response 200 do
+                key :description, 'Gift cards'
+                schema do
+                  key :type, :object
+                  property :gift_cards do
+                    key :type, :array
+                    items do
+                      key :'$ref', 'Workarea::Payment::GiftCard'
+                    end
+                  end
+                end
+              end
+            end
+
+            operation :post do
+              key :summary, 'Create GiftCard'
+              key :description, 'Creates a new gift_card.'
+              key :operationId, 'addGiftCard'
+              key :produces, ['application/json']
+
+              parameter do
+                key :name, :body
+                key :in, :body
+                key :description, 'GiftCard to add'
+                key :required, true
+                schema do
+                  key :type, :object
+                  property :gift_card do
+                    key :'$ref', 'Workarea::Payment::GiftCard'
+                  end
+                end
+              end
+
+              response 201 do
+                key :description, 'Gift card created'
+                schema do
+                  key :type, :object
+                  property :gift_card do
+                    key :'$ref', 'Workarea::Payment::GiftCard'
+                  end
+                end
+              end
+
+              response 422 do
+                key :description, 'Validation failure'
+                schema do
+                  key :type, :object
+                  property :problem do
+                    key :type, :string
+                  end
+                  property :document do
+                    key :'$ref', 'Workarea::Payment::GiftCard'
+                  end
+                end
+              end
+            end
+          end
+
+          def index
+            @gift_cards = Payment::GiftCard
+                          .all
+                          .order_by(sort_field => sort_direction)
+                          .page(params[:page])
+
+            respond_with gift_cards: @gift_cards
+          end
+
+          def create
+            @gift_card = Payment::GiftCard.create!(params[:gift_card])
+            respond_with(
+              { gift_card: @gift_card },
+              {
+                status: :created,
+                location: gift_card_path(@gift_card)
+              }
+            )
+          end
+
+          swagger_path '/gift_cards/{id}' do
+            operation :get do
+              key :summary, 'Find Gift card by ID'
+              key :description, 'Returns a single gift card'
+              key :operationId, 'showGiftCard'
+
+              parameter do
+                key :name, :id
+                key :in, :path
+                key :description, 'ID of gift card to fetch'
+                key :required, true
+                key :type, :string
+              end
+
+              response 200 do
+                key :description, 'Gift card details'
+                schema do
+                  key :type, :object
+                  property :gift_card do
+                    key :'$ref', 'Workarea::Payment::GiftCard'
+                  end
+                end
+              end
+
+              response 404 do
+                key :description, 'Gift card not found'
+                schema do
+                  key :type, :object
+                  property :problem do
+                    key :type, :string
+                  end
+                  property :params do
+                    key :type, :object
+                    key :additionalProperties, true
+                  end
+                end
+              end
+            end
+
+            operation :patch do
+              key :summary, 'Update a GiftCard'
+              key :description, 'Updates attributes on a gift card'
+              key :operationId, 'updateGiftCard'
+
+              parameter do
+                key :name, :id
+                key :in, :path
+                key :description, 'ID of gift card to update'
+                key :required, true
+                key :type, :string
+              end
+
+              parameter do
+                key :name, :body
+                key :in, :body
+                key :required, true
+                schema do
+                  key :type, :object
+                  property :gift_card do
+                    key :description, 'New attributes'
+                    key :'$ref', 'Workarea::Payment::GiftCard'
+                  end
+                end
+              end
+
+              response 204 do
+                key :description, 'Gift card updated successfully'
+              end
+
+              response 422 do
+                key :description, 'Validation failure'
+                schema do
+                  key :type, :object
+                  property :problem do
+                    key :type, :string
+                  end
+                  property :document do
+                    key :'$ref', 'Workarea::Payment::GiftCard'
+                  end
+                end
+              end
+
+              response 404 do
+                key :description, 'Gift card not found'
+                schema do
+                  key :type, :object
+                  property :problem do
+                    key :type, :string
+                  end
+                  property :params do
+                    key :type, :object
+                    key :additionalProperties, true
+                  end
+                end
+              end
+            end
+
+            operation :delete do
+              key :summary, 'Remove a Gift card'
+              key :description, 'Remove a gift card'
+              key :operationId, 'removeGiftCard'
+
+              parameter do
+                key :name, :id
+                key :in, :path
+                key :description, 'ID of gift card to remove'
+                key :required, true
+                key :type, :string
+              end
+
+              response 204 do
+                key :description, 'Gift card removed successfully'
+              end
+
+              response 404 do
+                key :description, 'Gift card not found'
+                schema do
+                  key :type, :object
+                  property :problem do
+                    key :type, :string
+                  end
+                  property :params do
+                    key :type, :object
+                    key :additionalProperties, true
+                  end
+                end
+              end
+            end
+          end
+
+          def show
+            respond_with gift_card: @gift_card
+          end
+
+          def update
+            @gift_card.update_attributes!(params[:gift_card])
+            respond_with gift_card: @gift_card
+          end
+
+          def destroy
+            @gift_card.destroy
+            head :no_content
+          end
+
+          swagger_path '/gift_cards/bulk' do
+            operation :patch do
+              key :summary, 'Bulk Upsert Gift cards'
+              key :description, 'Creates new gift cards or updates existing ones in bulk.'
+              key :operationId, 'upsertGiftCards'
+              key :produces, ['application/json']
+
+              parameter do
+                key :name, :body
+                key :in, :body
+                key :description, 'Array of gift cards to upsert'
+                key :required, true
+                schema do
+                  key :type, :object
+                  property :gift_cards do
+                    key :type, :array
+                    items do
+                      key :'$ref', 'Workarea::Payment::GiftCard'
+                    end
+                  end
+                end
+              end
+
+              response 204 do
+                key :description, 'Upsert received'
+              end
+            end
+          end
+
+          def bulk
+            @bulk = Api::Admin::BulkUpsert.create!(
+              klass: Payment::GiftCard,
+              data: params[:gift_cards].map(&:to_h)
+            )
+
+            head :no_content
+          end
+
+          private
+
+          def find_gift_card
+            @gift_card = Payment::GiftCard.find(params[:id])
+          end
+        end
+      end
+    end
+  end
+end