Open-source live-chat, email support, omni-channel desk. An alternative to Intercom, Zendesk, Salesforce Service Cloud etc. 🔥💬
Ruby actioncablechat-widgetconversationcustomer-supportdashboarddesigndockerdocker-imageherokuintercomjavascriptlivechatopensourcerailsrubysassvuejswhatsappzendesk
require 'rails_helper'
RSpec.describe Webhooks::ShopifyController, type: :request do
let(:account) { create(:account) }
let(:hook) { create(:integrations_hook, :shopify, account: account, reference_id: shop_domain) }
let(:shop_domain) { 'feature-gated-shop.myshopify.com' }
let(:client_secret) { 'shopify-client-secret' }
let(:payload) { { shop_domain: shop_domain } }
let(:topic) { 'shop/redact' }
let(:triggered_at) { '2026-07-29T10:01:00.123456789Z' }
let(:body) { payload.to_json }
let(:headers) do
{
'CONTENT_TYPE' => 'application/json',
'X-Shopify-Topic' => topic,
'X-Shopify-Triggered-At' => triggered_at,
'X-Shopify-Hmac-SHA256' => Base64.strict_encode64(OpenSSL::HMAC.digest('SHA256', client_secret, body))
}
end
before do
account.enable_features!('shopify_integration')
allow(GlobalConfigService).to receive(:load).and_call_original
InstallationConfig.where(name: 'ENABLE_SHOPIFY_INTEGRATION').first_or_initialize.update!(value: true)
allow(GlobalConfigService).to receive(:load)
.with('SHOPIFY_CLIENT_SECRET', nil)
.and_return(client_secret)
end
it 'processes the webhook when both feature gates are enabled' do
hook
expect do
post '/webhooks/shopify', params: body, headers: headers
end.to change(Integrations::Hook, :count).by(-1)
expect(response).to have_http_status(:ok)
end
it 'processes redaction when the installation switch is disabled' do
hook
InstallationConfig.where(name: 'ENABLE_SHOPIFY_INTEGRATION').first_or_initialize.update!(value: false)
expect do
post '/webhooks/shopify', params: body, headers: headers
end.to change(Integrations::Hook, :count).by(-1)
expect(response).to have_http_status(:ok)
end
it 'invalidates pending installations during shop redaction even when no hook exists' do
expect(Shopify::PendingInstallation).to receive(:invalidate_shop!).with(shop: shop_domain)
post '/webhooks/shopify', params: body, headers: headers
expect(response).to have_http_status(:ok)
end
it 'authenticates and acknowledges every compliance topic when the installation switch is disabled' do
InstallationConfig.where(name: 'ENABLE_SHOPIFY_INTEGRATION').first_or_initialize.update!(value: false)
Webhooks::ShopifyController::COMPLIANCE_TOPICS.each do |topic|
headers['X-Shopify-Topic'] = topic
post '/webhooks/shopify', params: body, headers: headers
expect(response).to have_http_status(:ok)
end
end
it 'processes redaction when the account feature is disabled' do
hook
account.disable_features!('shopify_integration')
expect do
post '/webhooks/shopify', params: body, headers: headers
end.to change(Integrations::Hook, :count).by(-1)
expect(response).to have_http_status(:ok)
end
it 'raises a retryable failure when a matching hook appears during cleanup' do
hook
inserted_hook = nil
app_hooks = Integrations::Hook.where(app_id: 'shopify')
hooks = app_hooks.where('LOWER(reference_id) = ?', shop_domain)
allow(Integrations::Hook).to receive(:where)
.with(app_id: 'shopify')
.and_return(app_hooks)
allow(app_hooks).to receive(:where)
.with('LOWER(reference_id) = ?', shop_domain)
.and_return(hooks)
allow(hooks).to receive(:find_each) do |&block|
block.call(hook)
inserted_hook ||= create(:integrations_hook, :shopify, account: create(:account), reference_id: shop_domain)
end
post '/webhooks/shopify', params: body, headers: headers
expect(response).to have_http_status(:internal_server_error)
expect(inserted_hook).not_to be_persisted
expect(hook.reload).to be_persisted
end
it 'ignores a delayed redaction from before the current installation' do
hook.update!(
settings: hook.settings.merge(
'connected_at' => (Time.iso8601(triggered_at) + 1.minute).iso8601(6)
)
)
expect do
post '/webhooks/shopify', params: body, headers: headers
end.not_to change(Integrations::Hook, :count)
expect(hook.reload).to be_enabled
expect(response).to have_http_status(:ok)
end
it 'delegates redaction deletion to the locked lifecycle' do
hook
uninstallation_service = instance_double(Shopify::UninstallationService)
allow(uninstallation_service).to receive(:perform) do
hook.destroy!
:uninstalled
end
allow(Shopify::UninstallationService).to receive(:new)
.with(hook: hook, occurred_at: Time.iso8601(triggered_at), delete_hook: true)
.and_return(uninstallation_service)
expect do
post '/webhooks/shopify', params: body, headers: headers
end.to change(Integrations::Hook, :count).by(-1)
expect(uninstallation_service).to have_received(:perform)
expect(response).to have_http_status(:ok)
end
it 'does not process normal events when the installation switch is disabled' do
headers['X-Shopify-Topic'] = 'orders/create'
InstallationConfig.where(name: 'ENABLE_SHOPIFY_INTEGRATION').first_or_initialize.update!(value: false)
post '/webhooks/shopify', params: body, headers: headers
expect(response).to have_http_status(:not_found)
end
it 'rejects an invalid HMAC without changing account data' do
hook
headers['X-Shopify-Hmac-SHA256'] = 'invalid'
expect do
post '/webhooks/shopify', params: body, headers: headers
end.not_to change(Integrations::Hook, :count)
expect(response).to have_http_status(:unauthorized)
end
context 'with an app/uninstalled webhook' do
let(:topic) { 'app/uninstalled' }
let(:payload) { { myshopify_domain: shop_domain.upcase } }
let(:uninstallation_service) { instance_double(Shopify::UninstallationService, perform: nil) }
it 'delegates the matching hook to the uninstallation lifecycle' do
hook
allow(Shopify::UninstallationService).to receive(:new)
.with(hook: hook, occurred_at: Time.iso8601(triggered_at))
.and_return(uninstallation_service)
post '/webhooks/shopify', params: body, headers: headers
expect(uninstallation_service).to have_received(:perform)
expect(response).to have_http_status(:ok)
end
it 'invalidates pending installations even when no hook exists' do
expect(Shopify::PendingInstallation).to receive(:invalidate_shop!).with(shop: shop_domain.upcase)
post '/webhooks/shopify', params: body, headers: headers
expect(response).to have_http_status(:ok)
end
it 'delegates uninstall cleanup when the installation switch is disabled' do
hook
InstallationConfig.where(name: 'ENABLE_SHOPIFY_INTEGRATION').first_or_initialize.update!(value: false)
allow(Shopify::UninstallationService).to receive(:new)
.with(hook: hook, occurred_at: Time.iso8601(triggered_at))
.and_return(uninstallation_service)
post '/webhooks/shopify', params: body, headers: headers
expect(uninstallation_service).to have_received(:perform)
expect(response).to have_http_status(:ok)
end
it 'ignores an invalid shop domain' do
allow(Shopify::UninstallationService).to receive(:new)
invalid_payload = { myshopify_domain: 'not-a-shop.example.com' }.to_json
invalid_headers = headers.merge(
'X-Shopify-Hmac-SHA256' => Base64.strict_encode64(
OpenSSL::HMAC.digest('SHA256', client_secret, invalid_payload)
)
)
post '/webhooks/shopify', params: invalid_payload, headers: invalid_headers
expect(Shopify::UninstallationService).not_to have_received(:new)
expect(response).to have_http_status(:ok)
end
end
end