active_merchant_gmo_pg 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c1c7bb63e545450d808cb77df7a1f700a3589eb70c9527109ae2313e386d6596
+  data.tar.gz: 1abcb6c7d8dbac3c07b63f9c4951ccd26f481fa988f249152ff2d4b48d5f3436
+SHA512:
+  metadata.gz: c03b434331ff343c7379ac19d3e04dec3f81844b5dc3f5983919cf80f8de47954b2e8adab28d450f76ed3552714d0b9787f99bdb9bb9a2ed68f91d0bfad1b4c7
+  data.tar.gz: e80d7d6ce3ab4320d325632cb61a1e20b7b30ea86048c5063d014579e9a8640f81b9ed055ec449b60dd2d95a053f18cdf081eafcd0ab877b9acd652350517fcc

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Be Agile
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,174 @@
+# ActiveMerchant GMO-PG
+
+An ActiveMerchant gateway that wraps the GMO Payment Gateway (GMO-PG) payment API.
+
+## Features
+
+- Register / delete stored credit cards (member management)
+- Authorize, immediate capture, capture, void, refund
+- 3DS2.0 authentication
+- Token-based payments
+- Multiple cards per member
+
+## Installation
+
+Add this line to your Gemfile:
+
+```ruby
+gem 'active_merchant_gmo_pg'
+```
+
+Then run:
+
+```bash
+bundle install
+```
+
+## Usage
+
+### Initializing the gateway
+
+```ruby
+gateway = ActiveMerchant::Billing::GmoPgGateway.new(
+  shop_id: 'your_shop_id',
+  shop_pass: 'your_shop_pass',
+  site_id: 'your_site_id',
+  site_pass: 'your_site_pass',
+  test: true  # set to false in production
+)
+```
+
+### Registering a card
+
+```ruby
+credit_card = ActiveMerchant::Billing::CreditCard.new(
+  number: '4111111111111111',
+  month: 12,
+  year: 2025,
+  verification_value: '123',
+  first_name: 'Taro',
+  last_name: 'Yamada'
+)
+
+response = gateway.store(credit_card, member_id: 'user123')
+
+if response.success?
+  # response.authorization contains an identifier in "member_id|card_seq" form
+  puts "Card registered: #{response.authorization}"
+else
+  puts "Error: #{response.message}"
+end
+```
+
+### Authorize
+
+```ruby
+response = gateway.authorize(1000, credit_card, order_id: 'order123')
+
+if response.success?
+  puts "Authorized: #{response.authorization}"
+else
+  puts "Error: #{response.message}"
+end
+```
+
+### Immediate capture (purchase)
+
+```ruby
+response = gateway.purchase(1000, credit_card, order_id: 'order124')
+
+if response.success?
+  puts "Charged: #{response.authorization}"
+else
+  puts "Error: #{response.message}"
+end
+```
+
+### Capture
+
+```ruby
+response = gateway.capture(1000, authorization)
+
+if response.success?
+  puts "Captured"
+else
+  puts "Error: #{response.message}"
+end
+```
+
+### Void
+
+```ruby
+response = gateway.void(authorization)
+
+if response.success?
+  puts "Voided"
+else
+  puts "Error: #{response.message}"
+end
+```
+
+### Refund
+
+```ruby
+response = gateway.credit(1000, authorization)
+
+if response.success?
+  puts "Refunded"
+else
+  puts "Error: #{response.message}"
+end
+```
+
+### Deleting a stored card
+
+```ruby
+response = gateway.unstore(authorization)
+
+if response.success?
+  puts "Card deleted"
+else
+  puts "Error: #{response.message}"
+end
+```
+
+## 3DS2.0 authentication
+
+To use 3DS2.0, pass the `ret_url` option to `authorize` or `purchase`:
+
+```ruby
+response = gateway.authorize(1000, credit_card,
+  order_id: 'order125',
+  ret_url: 'https://example.com/callback'
+)
+
+if response.success?
+  redirect_url = response.params['RedirectUrl']
+  # Redirect the user to redirect_url to complete 3DS authentication
+end
+```
+
+## Configuration
+
+### Switching environments
+
+For production, pass `test: false`:
+
+```ruby
+gateway = ActiveMerchant::Billing::GmoPgGateway.new(
+  shop_id: 'your_shop_id',
+  shop_pass: 'your_shop_pass',
+  site_id: 'your_site_id',
+  site_pass: 'your_site_pass',
+  test: false
+)
+```
+
+## Licence
+
+MIT License.
+
+## References
+
+- [GMO-PG official site](https://www.gmo-pg.com/)
+- [GMO-PG API documentation](https://docs.mul-pay.jp/)

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec