spree_gmo_pg 1.0.0

data/spec/models/spree/payment_method/gmo_pg_spec.rb

@@ -0,0 +1,860 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Spree::PaymentMethod::GmoPg, type: :model do
+  let(:payment_method) { described_class.new }
+
+  describe "#provider_class" do
+    subject { payment_method.provider_class }
+
+    it { is_expected.to eq ActiveMerchant::Billing::GmoPgGateway }
+  end
+
+  describe "#payment_source_class" do
+    subject { payment_method.payment_source_class }
+
+    it { is_expected.to eq Spree::CreditCard }
+  end
+
+  describe "#method_type" do
+    subject { payment_method.method_type }
+
+    it { is_expected.to eq 'gmo_pg' }
+  end
+
+  describe "#payment_profiles_supported?" do
+    subject { payment_method.payment_profiles_supported? }
+
+    it { is_expected.to be true }
+  end
+
+  describe "#supports?" do
+    subject { payment_method.supports?(source) }
+
+    context "source is Spree::CreditCard" do
+      let(:source) { Spree::CreditCard.new }
+
+      it { is_expected.to be true }
+    end
+
+    context "source is not Spree::CreditCard" do
+      let(:source) { Object.new }
+
+      it { is_expected.to be false }
+    end
+  end
+
+  describe "#auto_capture?" do
+    subject { payment_method.auto_capture? }
+
+    context "auto_capture == true" do
+      before { payment_method.auto_capture = true }
+
+      it { is_expected.to be true }
+    end
+
+    context "auto_capture == false" do
+      before { payment_method.auto_capture = false }
+
+      it { is_expected.to be false }
+    end
+  end
+
+  describe "#custom_form_fields_partial_name" do
+    subject { payment_method.custom_form_fields_partial_name }
+
+    it { is_expected.to eq 'gmo_pg_form_fields' }
+  end
+
+  describe "#options" do
+    subject { payment_method.options }
+
+    before do
+      payment_method.preferred_shop_id = 'test_shop'
+      payment_method.preferred_shop_pass = 'test_pass'
+      payment_method.preferred_site_id = 'test_site'
+      payment_method.preferred_site_pass = 'test_site_pass'
+      payment_method.preferred_test_mode = true
+    end
+
+    it {
+      expect(subject).to eq(
+        shop_id: 'test_shop',
+        shop_pass: 'test_pass',
+        site_id: 'test_site',
+        site_pass: 'test_site_pass',
+        test: true
+      )
+    }
+  end
+
+  describe "preferences" do
+    describe "default values" do
+      it { expect(payment_method.preferred_test_mode).to be true }
+    end
+
+    describe "setting values" do
+      before do
+        payment_method.preferred_shop_id = 'shop123'
+        payment_method.preferred_shop_pass = 'shoppass'
+        payment_method.preferred_site_id = 'site123'
+        payment_method.preferred_site_pass = 'sitepass'
+        payment_method.preferred_test_mode = false
+        payment_method.auto_capture = true
+      end
+
+      it { expect(payment_method.preferred_shop_id).to eq 'shop123' }
+      it { expect(payment_method.preferred_shop_pass).to eq 'shoppass' }
+      it { expect(payment_method.preferred_site_id).to eq 'site123' }
+      it { expect(payment_method.preferred_site_pass).to eq 'sitepass' }
+      it { expect(payment_method.preferred_test_mode).to be false }
+      it { expect(payment_method.auto_capture).to be true }
+    end
+  end
+
+  describe "#create_profile" do
+    let(:payment_method) { create(:payment_method_gmo_pg) }
+    let(:order) { create(:order, user: user) }
+    let(:payment) { build(:payment, order: order, payment_method: payment_method, source: credit_card) }
+    let(:credit_card) { create(:credit_card, user: user, gateway_payment_profile_id: token) }
+    let(:token) { 'tk_test_token_12345' }
+    let(:gateway) { instance_double(ActiveMerchant::Billing::GmoPgGateway) }
+
+    before do
+      allow(payment_method).to receive(:provider).and_return(gateway)
+    end
+
+    context "ゲスト購入の場合" do
+      let(:user) { nil }
+
+      it "トークンをそのまま保持し、SaveMember/SaveCard APIを呼ばない" do
+        expect(gateway).not_to receive(:store)
+        # Spree 5.3 の order 生成は instrumentation で logger.info を発火させるため、
+        # 期待メッセージ以外の info も通す。これが無いと strict mock が無関係なログを弾いて落ちる。
+        allow(Rails.logger).to receive(:info)
+        expect(Rails.logger).to receive(:info).with(/Guest checkout: Token saved without card registration/).at_least(:once)
+
+        payment_method.create_profile(payment)
+
+        credit_card.reload
+        expect(credit_card.gateway_payment_profile_id).to eq token
+        expect(credit_card.gateway_customer_profile_id).to be_nil
+        expect(credit_card.user_id).to be_nil
+        expect(credit_card.last_digits).to be_present
+        expect(credit_card.cc_type).to be_present
+        expect(credit_card.name).to be_present
+      end
+    end
+
+    context "ログイン済みユーザーの場合" do
+      let(:user) { create(:user) }
+      let(:response) { double(success?: success, message: message, authorization: authorization) }
+      let(:member_id) { user.id.to_s }
+      let(:card_seq) { '1' }
+      let(:authorization) { "#{member_id}|#{card_seq}" }
+
+      context "登録済みカードを使う場合" do
+        let(:credit_card) { create(:credit_card, user: user, gateway_payment_profile_id: card_seq, gateway_customer_profile_id: member_id) }
+
+        it "SaveMember/SaveCard APIを呼ばず、何もしない" do
+          expect(gateway).not_to receive(:store)
+          # Spree 5.3 の order 生成 instrumentation の logger.info を通す(下記strict mock対策)。
+          allow(Rails.logger).to receive(:info)
+          expect(Rails.logger).to receive(:info).with(/Using existing registered card/).at_least(:once)
+
+          payment_method.create_profile(payment)
+
+          credit_card.reload
+          expect(credit_card.gateway_payment_profile_id).to eq card_seq
+          expect(credit_card.gateway_customer_profile_id).to eq member_id
+        end
+      end
+
+      context "SaveMember/SaveCard APIが成功した場合" do
+        let(:credit_card) { create(:credit_card, user: user, gateway_payment_profile_id: token, gateway_customer_profile_id: nil) }
+        let(:success) { true }
+        let(:message) { 'OK' }
+
+        before do
+          allow(gateway).to receive(:store).and_return(response)
+          allow(payment_method.gateway_customers).to receive(:find_or_create_by).and_return(double(profile_id: member_id))
+        end
+
+        it "トークンからCardSeqに置き換え、GatewayCustomerを作成する" do
+          expect(gateway).to receive(:store).with(
+            token,
+            {
+              member_id: member_id,
+              order_id: order.number
+            }
+          )
+          expect(Rails.logger).to receive(:info).with(/Logged-in user checkout: Registering card with GMO-PG/).at_least(:once)
+          expect(Rails.logger).to receive(:info).with(/Card registered successfully/).at_least(:once)
+
+          payment_method.create_profile(payment)
+
+          credit_card.reload
+          expect(credit_card.gateway_payment_profile_id).to eq card_seq
+          expect(credit_card.gateway_customer_profile_id).to eq member_id
+          expect(credit_card.user_id).to eq user.id
+          expect(credit_card.last_digits).to be_present
+          expect(credit_card.cc_type).to be_present
+          expect(credit_card.name).to be_present
+        end
+
+        context "同じカード番号で異なる有効期限を2回登録した場合" do
+          let!(:first_card) { create(:credit_card, user: user, payment_method: payment_method, month: 3, year: 2026, name: 'TARO YAMADA', gateway_customer_profile_id: member_id, gateway_payment_profile_id: card_seq) }
+
+          it "新規レコードを作成せず、既存レコードを更新し、paymentのsourceを付け替える" do
+            # 2回目のカード登録をシミュレート
+            second_token = 'tk_test_token_67890'
+            second_credit_card = create(:credit_card, user: user, payment_method: payment_method, month: 4, year: 2026, name: 'TARO YAMADA', gateway_payment_profile_id: second_token, gateway_customer_profile_id: nil)
+
+            second_order = create(:order, user: user)
+            second_response = double(success?: true, message: 'OK', authorization: "#{member_id}|#{card_seq}")
+
+            # モックとexpectを先に設定してから payment を作成
+            allow(gateway).to receive(:store).with(
+              second_token,
+              {
+                member_id: member_id,
+                order_id: second_order.number
+              }
+            ).and_return(second_response)
+
+            # Spree 5.3 の order 生成 instrumentation の logger.info を通す(下記strict mock対策)。
+            allow(Rails.logger).to receive(:info)
+            expect(Rails.logger).to receive(:info).with(/Logged-in user checkout: Registering card with GMO-PG/).at_least(:once)
+            expect(Rails.logger).to receive(:info).with(/GMO updated existing card/).at_least(:once)
+            expect(Rails.logger).to receive(:info).with(/Updated existing card record/).at_least(:once)
+
+            expect(user.credit_cards.count).to eq 2
+
+            # 削除されるカードのIDを保存
+            second_credit_card_id = second_credit_card.id
+
+            # payment作成時にafter_saveコールバックでcreate_profileが自動的に呼ばれる
+            second_payment = create(:payment, order: second_order, payment_method: payment_method, source: second_credit_card)
+
+            expect(user.credit_cards.count).to eq 1
+            first_card.reload
+            expect(first_card.month).to eq 4
+            expect(first_card.year).to eq 2026
+            expect(first_card.name).to eq 'TARO YAMADA'
+            expect(first_card.gateway_payment_profile_id).to eq card_seq
+            expect(first_card.gateway_customer_profile_id).to eq member_id
+
+            second_payment.reload
+            expect(second_payment.source).to eq first_card
+
+            expect { Spree::CreditCard.find(second_credit_card_id) }.to raise_error(ActiveRecord::RecordNotFound)
+          end
+
+          it "defaultフラグは維持される" do
+            first_card.update!(default: true)
+
+            second_token = 'tk_test_token_67890'
+            second_credit_card = create(:credit_card, user: user, payment_method: payment_method, month: 4, year: 2026, name: 'TARO YAMADA', gateway_payment_profile_id: second_token, gateway_customer_profile_id: nil)
+
+            second_order = create(:order, user: user)
+            second_response = double(success?: true, message: 'OK', authorization: "#{member_id}|#{card_seq}")
+
+            # モックを先に設定してから payment を作成
+            allow(gateway).to receive(:store).with(
+              second_token,
+              {
+                member_id: member_id,
+                order_id: second_order.number
+              }
+            ).and_return(second_response)
+
+            # payment作成時にafter_saveコールバックでcreate_profileが自動的に呼ばれる
+            second_payment = create(:payment, order: second_order, payment_method: payment_method, source: second_credit_card)
+
+            first_card.reload
+            expect(first_card.default).to be true
+          end
+        end
+      end
+
+      context "SaveMember/SaveCard APIが失敗した場合" do
+        let(:credit_card) { create(:credit_card, user: user, gateway_payment_profile_id: token, gateway_customer_profile_id: nil) }
+        let(:success) { false }
+        let(:message) { 'API Error' }
+
+        before do
+          allow(gateway).to receive(:store).and_return(response)
+        end
+
+        it "Spree::Core::GatewayErrorを発生させる" do
+          expect {
+            payment_method.create_profile(payment)
+          }.to raise_error(Spree::Core::GatewayError, 'API Error')
+        end
+      end
+    end
+
+    context "gateway_payment_profile_idが空の場合" do
+      let(:user) { nil }
+      let(:credit_card) { create(:credit_card, user: user, gateway_payment_profile_id: nil) }
+
+      it "何もしない" do
+        expect(gateway).not_to receive(:store)
+        payment_method.create_profile(payment)
+      end
+    end
+  end
+
+  describe "#disable_customer_profile" do
+    let(:payment_method) { create(:payment_method_gmo_pg) }
+    let(:credit_card) { create(:credit_card, gateway_payment_profile_id: 'card_seq_123', gateway_customer_profile_id: 'member_123') }
+    let(:gateway) { instance_double(ActiveMerchant::Billing::GmoPgGateway) }
+    let(:response) { double(success?: success, message: message) }
+
+    before do
+      allow(payment_method).to receive(:provider).and_return(gateway)
+    end
+
+    context "削除成功時" do
+      let(:success) { true }
+      let(:message) { 'OK' }
+
+      before do
+        allow(gateway).to receive(:unstore).with('member_123|card_seq_123').and_return(response)
+      end
+
+      it "GMO-PG側から削除し、DB側も論理削除する" do
+        expect(gateway).to receive(:unstore).with('member_123|card_seq_123')
+        expect(credit_card).to receive(:destroy)
+        payment_method.disable_customer_profile(credit_card)
+      end
+    end
+
+    context "GMO-PG側で既に削除済み(404エラー)の場合" do
+      let(:success) { false }
+      let(:message) { 'Card not found (E01390007)' }
+
+      before do
+        allow(gateway).to receive(:unstore).with('member_123|card_seq_123').and_return(response)
+      end
+
+      it "エラーを無視してDB側を論理削除する" do
+        expect(gateway).to receive(:unstore).with('member_123|card_seq_123')
+        expect(credit_card).to receive(:destroy)
+        payment_method.disable_customer_profile(credit_card)
+      end
+    end
+
+    context "GMO-PG側で削除失敗時" do
+      let(:success) { false }
+      let(:message) { 'Internal Server Error' }
+
+      before do
+        allow(gateway).to receive(:unstore).with('member_123|card_seq_123').and_return(response)
+      end
+
+      it "GatewayErrorを投げる" do
+        expect {
+          payment_method.disable_customer_profile(credit_card)
+        }.to raise_error(Spree::Core::GatewayError, 'Internal Server Error')
+      end
+    end
+
+    context "gateway_payment_profile_idがない場合" do
+      let(:credit_card_without_profile) { create(:credit_card, gateway_payment_profile_id: nil) }
+
+      it "GMO-PGへの削除はスキップし、DB側のみ論理削除する" do
+        expect(gateway).not_to receive(:unstore)
+        expect(credit_card_without_profile).to receive(:destroy)
+        payment_method.disable_customer_profile(credit_card_without_profile)
+      end
+    end
+
+    context "sourceがCreditCardでない場合" do
+      let(:invalid_source) { Object.new }
+
+      it "何もしない" do
+        expect(gateway).not_to receive(:unstore)
+        payment_method.disable_customer_profile(invalid_source)
+      end
+    end
+  end
+
+  # 3DS決済フローの共有例
+  RSpec.shared_examples "3DS payment flow" do |action|
+    let(:payment_method) { create(:payment_method_gmo_pg) }
+    let(:gateway) { instance_double(ActiveMerchant::Billing::GmoPgGateway) }
+    let(:order) { create(:order, number: 'R123456', user: nil) }
+    let(:credit_card) { create(:credit_card, gateway_payment_profile_id: 'tk_test_token_123', user: nil) }
+    let(:payment) { create(:payment, order: order, payment_method: payment_method, source: credit_card, state: 'processing') }
+    let(:money) { 1000 }
+    let(:gateway_options) { { order_id: "#{order.number}-PA1" } }
+
+    before do
+      allow(gateway).to receive(:store).and_return(
+        double(success?: true, authorization: "#{order.user_id}|0")
+      )
+      allow(payment_method).to receive_messages(provider: gateway, generate_3ds_callback_url: 'http://example.com/callback', find_order_and_payment: [ order, payment ])
+    end
+
+    context "3DS認証が不要な場合" do
+      let(:response) { double(success?: true, params: {}, authorization: 'auth_123') }
+
+      it "通常のgateway.#{action}を呼び出してレスポンスを返す" do
+        allow(gateway).to receive(action).with(
+          money,
+          'tk_test_token_123',
+          hash_including(order_id: gateway_options[:order_id])
+        ).and_return(response)
+
+        result = payment_method.public_send(action, money, credit_card, gateway_options)
+        expect(result).to eq response
+      end
+    end
+
+    context "3DS認証が必要な場合（1回目の#{action}）" do
+      let(:redirect_url) { 'https://gmo-pg.example.com/3ds' }
+      let(:response) do
+        double(
+          success?: true,
+          params: { 'ACS' => '2', 'RedirectUrl' => redirect_url, 'AccessID' => 'test_access_id', 'AccessPass' => 'test_access_pass' },
+          authorization: 'auth_123'
+        )
+      end
+
+      # 保存は with_lock トランザクション内ではロールバックされるため、ここでは行わず
+      # 再処理に必要な情報を例外に積んで返す（保存はコントローラ側で行う）
+      it "PaymentRedirectRequiredをraiseし、例外に再処理用データを積む" do
+        allow(gateway).to receive(action).with(
+          money,
+          'tk_test_token_123',
+          hash_including(
+            order_id: gateway_options[:order_id],
+            ret_url: 'http://example.com/callback'
+          )
+        ).and_return(response)
+
+        expect {
+          payment_method.public_send(action, money, credit_card, gateway_options)
+        }.to raise_error(Spree::PaymentRedirectRequired) do |error|
+          expect(error.redirect_url).to eq redirect_url
+          expect(error.payment).to eq payment
+          expect(error.gmo_pg_data).to include(
+            redirect_url: redirect_url,
+            access_id: 'test_access_id',
+            access_pass: 'test_access_pass'
+          )
+          expect(error.gmo_pg_data[:redirect_at]).to be_present
+        end
+      end
+    end
+
+    context "3DS認証完了後（2回目の#{action}）" do
+      let(:access_id) { 'access_id_123' }
+      let(:access_pass) { 'access_pass_123' }
+      let(:response) { double(success?: true, params: {}, authorization: 'auth_123') }
+
+      before do
+        payment.private_metadata[:gmo_pg] = {
+          redirect_url: 'https://gmo-pg.example.com/3ds',
+          access_id: access_id,
+          access_pass: access_pass
+        }
+        payment.save!
+      end
+
+      context "SecureTran2が成功した場合" do
+        it "SecureTran2を呼び出してmetadataを削除する" do
+          allow(gateway).to receive(:secure_tran2).with(access_id, access_pass).and_return(response)
+
+          result = payment_method.public_send(action, money, credit_card, gateway_options)
+
+          expect(result).to eq response
+          expect(payment.reload.private_metadata[:gmo_pg]).to be_nil
+        end
+      end
+
+      context "SecureTran2が失敗した場合" do
+        let(:error_response) { double(success?: false, message: '認証に失敗しました') }
+
+        it "metadataを削除してGatewayErrorをraiseする" do
+          allow(gateway).to receive(:secure_tran2).with(access_id, access_pass).and_return(error_response)
+
+          expect {
+            payment_method.public_send(action, money, credit_card, gateway_options)
+          }.to raise_error(Spree::Core::GatewayError, '認証に失敗しました')
+
+          expect(payment.reload.private_metadata[:gmo_pg]).to be_nil
+        end
+      end
+    end
+
+    context "ブラウザバックシナリオ（redirect_urlのみでaccess_id/access_passなし）" do
+      let(:redirect_url) { 'https://gmo-pg.example.com/3ds' }
+      let(:response) do
+        double(
+          success?: true,
+          params: { 'ACS' => '2', 'RedirectUrl' => redirect_url },
+          authorization: 'auth_123'
+        )
+      end
+
+      before do
+        payment.private_metadata[:gmo_pg] = {
+          redirect_url: 'https://gmo-pg.example.com/3ds'
+        }
+        payment.save!
+      end
+
+      it "1回目のフローに入り、再度3DSリダイレクトする" do
+        allow(gateway).to receive(action).with(
+          money,
+          'tk_test_token_123',
+          hash_including(
+            order_id: gateway_options[:order_id],
+            ret_url: 'http://example.com/callback'
+          )
+        ).and_return(response)
+
+        expect {
+          payment_method.public_send(action, money, credit_card, gateway_options)
+        }.to raise_error(Spree::PaymentRedirectRequired) do |error|
+          expect(error.redirect_url).to eq redirect_url
+        end
+      end
+    end
+
+    context "登録済みカード（member_id + CardSeq）の場合" do
+      let(:credit_card_saved) { create(:credit_card, gateway_customer_profile_id: 'member_001', gateway_payment_profile_id: '0', user: nil) }
+      let(:payment_saved) { create(:payment, order: order, payment_method: payment_method, source: credit_card_saved, amount: money) }
+      let(:response) { double(success?: true, params: {}, authorization: 'auth_123') }
+
+      before do
+        order.update_columns(total: money, payment_total: 0, item_total: money)
+        allow(payment_method).to receive(:find_order_and_payment).and_return([ order, payment_saved ])
+      end
+
+      it "member_id|card_seq形式でgateway.#{action}を呼び出す" do
+        allow(gateway).to receive(action).with(
+          money,
+          'member_001|0',
+          hash_including(order_id: gateway_options[:order_id])
+        ).and_return(response)
+
+        result = payment_method.public_send(action, money, credit_card_saved, gateway_options)
+        expect(result).to eq response
+      end
+    end
+  end
+
+  describe "#authorize" do
+    include_examples "3DS payment flow", :authorize
+  end
+
+  describe "#purchase" do
+    include_examples "3DS payment flow", :purchase
+  end
+
+  describe ".persist_3ds_redirect_data" do
+    let(:payment_method) { create(:payment_method_gmo_pg) }
+    let(:order) { create(:order, number: 'R123456', user: nil) }
+    let(:credit_card) { create(:credit_card, user: nil) }
+    let(:payment) { create(:payment, order: order, payment_method: payment_method, source: credit_card, state: 'processing') }
+    let(:gmo_pg_data) do
+      {
+        redirect_url: 'https://gmo-pg.example.com/3ds',
+        redirect_at: 1_700_000_000,
+        access_id: 'access_id_123',
+        access_pass: 'access_pass_123'
+      }
+    end
+
+    subject { described_class.persist_3ds_redirect_data(payment, gmo_pg_data) }
+
+    context "payment と gmo_pg_data がある場合" do
+      it "metadataを保存し checkout 状態に戻す" do
+        subject
+
+        payment.reload
+        expect(payment.private_metadata[:gmo_pg]).to include(
+          redirect_url: 'https://gmo-pg.example.com/3ds',
+          access_id: 'access_id_123',
+          access_pass: 'access_pass_123'
+        )
+        expect(payment.state).to eq 'checkout'
+      end
+    end
+
+    context "payment が nil の場合" do
+      let(:payment) { nil }
+
+      it { expect { subject }.not_to raise_error }
+    end
+
+    context "gmo_pg_data が空の場合" do
+      let(:gmo_pg_data) { {} }
+
+      it "metadataを変更しない" do
+        subject
+
+        expect(payment.reload.private_metadata[:gmo_pg]).to be_nil
+      end
+    end
+  end
+
+  describe "#cancel" do
+    let(:payment_method) { create(:payment_method_gmo_pg) }
+    let(:gateway) { instance_double(ActiveMerchant::Billing::GmoPgGateway) }
+    let(:order) { create(:order, number: 'R123456', user: nil) }
+    let(:credit_card) { create(:credit_card, user: nil) }
+    let(:payment) { create(:payment, order: order, payment_method: payment_method, source: credit_card, response_code: 'access_id_123|access_pass_123|R123456-PA1') }
+    let(:response_code) { 'access_id_123|access_pass_123|R123456-PA1' }
+
+    before do
+      allow(payment_method).to receive(:provider).and_return(gateway)
+    end
+
+    context "void成功時" do
+      let(:response) { double(success?: true, message: 'Void成功', authorization: 'void_auth_123') }
+
+      it "provider.voidを呼び出して成功レスポンスを返す" do
+        allow(gateway).to receive(:void).with(response_code, anything).and_return(response)
+
+        result = payment_method.cancel(response_code, payment)
+        expect(result).to eq response
+        expect(result.success?).to be true
+      end
+    end
+
+    context "void失敗時" do
+      let(:error_response) { double(success?: false, message: 'Void失敗') }
+
+      it "provider.voidを呼び出して失敗レスポンスを返す" do
+        allow(gateway).to receive(:void).with(response_code, anything).and_return(error_response)
+
+        result = payment_method.cancel(response_code, payment)
+        expect(result).to eq error_response
+        expect(result.success?).to be false
+      end
+    end
+
+    context "paymentがnilの場合" do
+      let(:response) { double(success?: true, message: 'Void成功') }
+
+      it "空のoptionsでprovider.voidを呼び出す" do
+        allow(gateway).to receive(:void).with(response_code, {}).and_return(response)
+
+        result = payment_method.cancel(response_code, nil)
+        expect(result).to eq response
+      end
+    end
+  end
+
+  describe "#void" do
+    let(:payment_method) { create(:payment_method_gmo_pg) }
+    let(:gateway) { instance_double(ActiveMerchant::Billing::GmoPgGateway) }
+    let(:order) { create(:order, number: 'R123456', user: nil) }
+    let(:credit_card) { create(:credit_card, user: nil) }
+    let(:payment) { create(:payment, order: order, payment_method: payment_method, source: credit_card, response_code: 'access_id_123|access_pass_123|R123456-PA1') }
+    let(:response_code) { 'access_id_123|access_pass_123|R123456-PA1' }
+    let(:response) { double(success?: true, message: 'Void成功') }
+
+    before do
+      allow(payment_method).to receive(:provider).and_return(gateway)
+    end
+
+    context "3つの引数で呼び出された場合（Spreeの標準動作）" do
+      let(:gateway_options) { { order_id: 'R123456' } }
+
+      it "provider.voidを2つの引数で呼び出す" do
+        allow(gateway).to receive(:void).and_return(response)
+        expect(gateway).to receive(:void).with(response_code, gateway_options)
+
+        result = payment_method.void(response_code, credit_card, gateway_options)
+        expect(result).to eq response
+      end
+    end
+
+    context "2つの引数で呼び出された場合（互換性）" do
+      let(:options) { { order_id: 'R123456' } }
+
+      it "provider.voidを正しく呼び出す" do
+        allow(gateway).to receive(:void).and_return(response)
+        expect(gateway).to receive(:void).with(response_code, options)
+
+        result = payment_method.void(response_code, options)
+        expect(result).to eq response
+      end
+    end
+
+    context "1つの引数で呼び出された場合" do
+      it "provider.voidを空のoptionsで呼び出す" do
+        allow(gateway).to receive(:void).and_return(response)
+        expect(gateway).to receive(:void).with(response_code, {})
+
+        result = payment_method.void(response_code)
+        expect(result).to eq response
+      end
+    end
+  end
+
+  describe "#credit" do
+    let(:payment_method) { create(:payment_method_gmo_pg) }
+    let(:gateway) { instance_double(ActiveMerchant::Billing::GmoPgGateway) }
+    let(:order) { create(:order, number: 'R123456', user: nil) }
+    let(:credit_card) { create(:credit_card, user: nil) }
+    let(:payment) { create(:payment, order: order, payment_method: payment_method, source: credit_card, response_code: authorization, state: payment_state) }
+    let(:authorization) { 'access_id_123|access_pass_123|R123456-PA1' }
+    let(:captured_amount) { 10000.0 }
+    let(:payment_state) { 'completed' }
+
+    before do
+      allow(payment_method).to receive(:provider).and_return(gateway)
+      payment.update_column(:amount, captured_amount)
+      allow(payment).to receive(:captured_amount).and_return(captured_amount)
+    end
+
+    context "originatorが無い場合" do
+      let(:options) { {} }
+
+      it "GatewayErrorを発生させる" do
+        expect {
+          payment_method.credit(100000, credit_card, authorization, options)
+        }.to raise_error(Spree::Core::GatewayError, 'Refund originator is required')
+      end
+    end
+
+    context "全額返金の場合" do
+      let(:refund) { double('Refund', payment: payment) }
+      let(:options) { { originator: refund } }
+      let(:money) { captured_amount.to_i }
+      let(:response) { double(success?: true, message: 'Void成功') }
+      let(:refunds_relation) { double('RefundsRelation') }
+
+      before do
+        allow(payment).to receive(:refunds).and_return(refunds_relation)
+        allow(refunds_relation).to receive_messages(where: refunds_relation, not: refunds_relation)
+        allow(refunds_relation).to receive(:sum).with(:amount).and_return(0.0)
+      end
+
+      it "provider.voidを呼び出して全額キャンセルする" do
+        expect(gateway).to receive(:void).with(authorization, options)
+        allow(gateway).to receive(:void).and_return(response)
+
+        result = payment_method.credit(money, credit_card, authorization, options)
+        expect(result).to eq response
+      end
+    end
+
+    context "部分返金の場合（売上計上済み）" do
+      let(:refund) { double('Refund', payment: payment) }
+      let(:options) { { originator: refund } }
+      let(:refund_amount) { 3000.0 }
+      let(:money) { refund_amount.to_i }
+      let(:new_amount_cents) { (captured_amount - refund_amount).to_i }
+      let(:response) { double(success?: true, message: '金額変更成功') }
+      let(:refunds_relation) { double('RefundsRelation') }
+
+      before do
+        allow(payment).to receive(:refunds).and_return(refunds_relation)
+        allow(refunds_relation).to receive_messages(where: refunds_relation, not: refunds_relation)
+        allow(refunds_relation).to receive(:sum).with(:amount).and_return(0.0)
+      end
+
+      it "provider.update_amountを呼び出して減額する（job_cd: CAPTURE）" do
+        expect(gateway).to receive(:update_amount).with(
+          new_amount_cents,
+          authorization,
+          hash_including(job_cd: 'CAPTURE')
+        )
+        allow(gateway).to receive(:update_amount).and_return(response)
+
+        result = payment_method.credit(money, credit_card, authorization, options)
+        expect(result).to eq response
+      end
+    end
+
+    context "部分返金の場合（オーソリのみ）" do
+      let(:payment_state) { 'pending' }
+      let(:refund) { double('Refund', payment: payment) }
+      let(:options) { { originator: refund } }
+      let(:refund_amount) { 3000.0 }
+      let(:money) { refund_amount.to_i }
+      let(:new_amount_cents) { (captured_amount - refund_amount).to_i }
+      let(:response) { double(success?: true, message: '金額変更成功') }
+      let(:refunds_relation) { double('RefundsRelation') }
+
+      before do
+        allow(refunds_relation).to receive_messages(where: refunds_relation, not: refunds_relation)
+        allow(refunds_relation).to receive(:sum).with(:amount).and_return(0.0)
+        allow(payment).to receive_messages(refunds: refunds_relation, completed?: false)
+      end
+
+      it "provider.update_amountを呼び出して減額する（job_cd: AUTH）" do
+        expect(gateway).to receive(:update_amount).with(
+          new_amount_cents,
+          authorization,
+          hash_including(job_cd: 'AUTH')
+        )
+        allow(gateway).to receive(:update_amount).and_return(response)
+
+        result = payment_method.credit(money, credit_card, authorization, options)
+        expect(result).to eq response
+      end
+    end
+
+    context "複数回の部分返金の場合" do
+      let(:refund) { double('Refund', payment: payment) }
+      let(:options) { { originator: refund } }
+      let(:first_refund_amount) { 3000.0 }
+      let(:second_refund_amount) { 2000.0 }
+      let(:money) { second_refund_amount.to_i }
+      let(:new_amount_cents) { (captured_amount - first_refund_amount - second_refund_amount).to_i }
+      let(:response) { double(success?: true, message: '金額変更成功') }
+      let(:refunds_relation) { double('RefundsRelation') }
+
+      before do
+        allow(payment).to receive(:refunds).and_return(refunds_relation)
+        allow(refunds_relation).to receive_messages(where: refunds_relation, not: refunds_relation)
+        allow(refunds_relation).to receive(:sum).with(:amount).and_return(first_refund_amount)
+      end
+
+      it "既存の返金額を考慮して新しい金額を計算する" do
+        expect(gateway).to receive(:update_amount).with(
+          new_amount_cents,
+          authorization,
+          hash_including(job_cd: 'CAPTURE')
+        )
+        allow(gateway).to receive(:update_amount).and_return(response)
+
+        result = payment_method.credit(money, credit_card, authorization, options)
+        expect(result).to eq response
+      end
+    end
+
+    context "複数回の部分返金で最後が全額返金となる場合" do
+      let(:refund) { double('Refund', payment: payment) }
+      let(:options) { { originator: refund } }
+      let(:first_refund_amount) { 3000.0 }
+      let(:second_refund_amount) { 7000.0 }
+      let(:money) { second_refund_amount.to_i }
+      let(:response) { double(success?: true, message: 'Void成功') }
+      let(:refunds_relation) { double('RefundsRelation') }
+
+      before do
+        allow(payment).to receive(:refunds).and_return(refunds_relation)
+        allow(refunds_relation).to receive_messages(where: refunds_relation, not: refunds_relation)
+        allow(refunds_relation).to receive(:sum).with(:amount).and_return(first_refund_amount)
+      end
+
+      it "provider.voidを呼び出して全額キャンセルする" do
+        expect(gateway).to receive(:void).with(authorization, options)
+        allow(gateway).to receive(:void).and_return(response)
+
+        result = payment_method.credit(money, credit_card, authorization, options)
+        expect(result).to eq response
+      end
+    end
+  end
+end