当前位置：首页 > news >正文

如何快速集成Active Merchant到Rails应用：完整配置指南

news 2026/7/8 23:51:36

如何快速集成Active Merchant到Rails应用：完整配置指南

【免费下载链接】active_merchantActive Merchant is a simple payment abstraction library extracted from Shopify. The aim of the project is to feel natural to Ruby users and to abstract as many parts as possible away from the user to offer a consistent interface across all supported gateways.项目地址: https://gitcode.com/gh_mirrors/ac/active_merchant

Active Merchant是一款源自Shopify的支付抽象库，专为Ruby开发者设计，提供一致的接口来对接多种支付网关。本文将展示如何将Active Merchant与Rails应用无缝集成，实现安全高效的支付处理功能。

1. 快速安装Active Merchant

首先在Rails项目的Gemfile中添加Active Merchant依赖：

gem 'activemerchant'

然后执行bundle安装命令：

bundle install

Active Merchant支持多种Rails版本，项目中提供了针对不同Rails版本的Gemfile配置，如gemfiles/Gemfile.rails60，可根据实际项目需求选择合适的版本兼容方案。

2. 配置支付网关

创建支付配置文件config/initializers/active_merchant.rb，以PayPal为例：

ActiveMerchant::Billing::Base.mode = :test paypal_options = { login: ENV['PAYPAL_LOGIN'], password: ENV['PAYPAL_PASSWORD'], signature: ENV['PAYPAL_SIGNATURE'] } $gateway = ActiveMerchant::Billing::PaypalGateway.new(paypal_options)

建议使用环境变量存储敏感信息，避免硬编码。项目中lib/active_merchant/billing/gateways/paypal.rb文件包含了PayPal网关的完整实现。

3. 实现信用卡处理功能

Active Merchant提供了强大的信用卡验证和处理功能。在控制器中使用：

def process_payment credit_card = ActiveMerchant::Billing::CreditCard.new( number: params[:card_number], month: params[:expiry_month], year: params[:expiry_year], cvv: params[:cvv], first_name: params[:first_name], last_name: params[:last_name] ) if credit_card.valid? # 处理支付 amount = 1000 # 金额以分为单位 response = $gateway.purchase(amount, credit_card) if response.success? flash[:notice] = "支付成功: #{response.authorization}" else flash[:error] = "支付失败: #{response.message}" end else flash[:error] = "无效的信用卡: #{credit_card.errors.full_messages.join(', ')}" end end

信用卡验证逻辑在lib/active_merchant/billing/credit_card.rb中实现，包括卡号格式、有效期和CVV验证等功能。

4. 支持多种支付网关

Active Merchant支持超过100种支付网关，只需更改初始化配置即可切换。例如切换到Authorize.net：

authorize_net_options = { login: ENV['AUTHORIZE_NET_LOGIN'], password: ENV['AUTHORIZE_NET_PASSWORD'] } $gateway = ActiveMerchant::Billing::AuthorizeNetGateway.new(authorize_net_options)

项目的lib/active_merchant/billing/gateways/目录下包含了所有支持的网关实现，如authorize_net.rb、stripe.rb等。

5. 编写测试用例

Active Merchant提供了完善的测试支持，可在Rails项目的test目录下创建支付相关测试：

require 'test_helper' class PaymentTest < ActiveSupport::TestCase def setup @gateway = ActiveMerchant::Billing::BogusGateway.new @credit_card = ActiveMerchant::Billing::CreditCard.new( number: '4111111111111111', month: '12', year: Time.now.year + 1, cvv: '123' ) end test "successful purchase" do response = @gateway.purchase(1000, @credit_card) assert response.success? assert_not_nil response.authorization end end

项目中test/unit/gateways/目录包含了大量测试示例，如paypal_test.rb可作为参考。

6. 处理支付响应

支付响应处理是关键环节，Active Merchant提供统一的响应接口：

response = $gateway.purchase(amount, credit_card) if response.success? # 处理成功逻辑 order.update(status: 'paid', transaction_id: response.authorization) elsif response.decline? # 处理拒绝逻辑 order.update(status: 'declined', error_message: response.message) else # 处理错误逻辑 order.update(status: 'error', error_message: response.message) end

响应处理的核心逻辑在lib/active_merchant/billing/response.rb中实现。