jamm 1.7.0 → 2.0.0

data/lib/jamm/api/models/v1_withdraw_async_response.rb

@@ -20,6 +20,8 @@ module Api
 
     attr_accessor :status
 
+    attr_accessor :charge_id
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -46,7 +48,8 @@ module Api
     def self.attribute_map
       {
         :'request_id' => :'requestId',
-        :'status' => :'status'
+        :'status' => :'status',
+        :'charge_id' => :'chargeId'
       }
     end
 
@@ -59,7 +62,8 @@ module Api
     def self.openapi_types
       {
         :'request_id' => :'String',
-        :'status' => :'AsyncStatus'
+        :'status' => :'AsyncStatus',
+        :'charge_id' => :'String'
       }
     end
 
@@ -93,6 +97,10 @@ module Api
       else
         self.status = 'ASYNC_STATUS_UNSPECIFIED'
       end
+
+      if attributes.key?(:'charge_id')
+        self.charge_id = attributes[:'charge_id']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -116,7 +124,8 @@ module Api
       return true if self.equal?(o)
       self.class == o.class &&
           request_id == o.request_id &&
-          status == o.status
+          status == o.status &&
+          charge_id == o.charge_id
     end
 
     # @see the `==` method
@@ -128,7 +137,7 @@ module Api
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [request_id, status].hash
+      [request_id, status, charge_id].hash
     end
 
     # Builds the object from hash

data/lib/jamm/api.rb

@@ -36,6 +36,7 @@ require 'jamm/api/models/v1_charge'
 require 'jamm/api/models/v1_charge_message'
 require 'jamm/api/models/v1_charge_message_status'
 require 'jamm/api/models/v1_charge_result'
+require 'jamm/api/models/v1_charge_status'
 require 'jamm/api/models/v1_contract'
 require 'jamm/api/models/v1_contract_message'
 require 'jamm/api/models/v1_contract_status'
@@ -65,6 +66,8 @@ require 'jamm/api/models/v1_merchant'
 require 'jamm/api/models/v1_merchant_customer'
 require 'jamm/api/models/v1_merchant_webhook_message'
 require 'jamm/api/models/v1_message_response'
+require 'jamm/api/models/v1_off_session_payment_async_request'
+require 'jamm/api/models/v1_off_session_payment_async_response'
 require 'jamm/api/models/v1_off_session_payment_request'
 require 'jamm/api/models/v1_off_session_payment_response'
 require 'jamm/api/models/v1_on_session_payment_data'
@@ -76,6 +79,8 @@ require 'jamm/api/models/v1_pagination'
 require 'jamm/api/models/v1_payment_authorization_status'
 require 'jamm/api/models/v1_payment_link'
 require 'jamm/api/models/v1_ping_response'
+require 'jamm/api/models/v1_refund_request'
+require 'jamm/api/models/v1_refund_response'
 require 'jamm/api/models/v1_search_banks_response'
 require 'jamm/api/models/v1_search_branches_response'
 require 'jamm/api/models/v1_url'

data/lib/jamm/api_patches.rb

@@ -5,7 +5,7 @@ module Api
     # Allow to drill down to list charges.
     # e.g. cus.charges --> []
     def charges(pagination: nil)
-      Jamm::Charge.list(
+      Jamm::Payment.list(
         customer: id,
         pagination: pagination
       )

data/lib/jamm/client.rb

@@ -2,7 +2,7 @@
 
 module Jamm
   module Client
-    def self.handler
+    def self.handler(merchant: nil)
       base = Jamm::OpenAPI::ApiClient.new
 
       # Configure
@@ -10,6 +10,20 @@ module Jamm
       base.config.scheme = Jamm.openapi.config.scheme
       base.default_headers['Authorization'] = "Bearer #{Jamm::OAuth.token}"
 
+      # Platform feature, optionally set merchant id to call Jamm API
+      # on behalf of the merchant.
+      if merchant
+        unless defined?(Jamm::Mode) && Jamm.respond_to?(:mode) && Jamm.mode == Jamm::Mode::PLATFORM
+          raise ArgumentError, 'merchant can only be set when Jamm.mode is Jamm::Mode::PLATFORM'
+        end
+
+        # Merchant ID format validation to match backend expectations (e.g. "mer-*").
+        unless merchant.is_a?(String) && merchant.match?(/\Amer-[0-9A-Za-z_-]+\z/)
+          raise ArgumentError, 'invalid merchant id format (expected something like "mer-*")'
+        end
+
+        base.default_headers['Jamm-Merchant'] = merchant
+      end
       base
     end
   end

data/lib/jamm/customer.rb

@@ -16,8 +16,10 @@ module Jamm
     KycStatus = Jamm::OpenAPI::KycStatus
     PaymentAuthorizationStatus = Jamm::OpenAPI::PaymentAuthorizationStatus
 
-    def self.create(buyer:)
-      r = Jamm::OpenAPI::CustomerApi.new(Jamm::Client.handler).create(
+    def self.create(buyer:, merchant: nil)
+      handler = Jamm::Client.handler(merchant: merchant)
+
+      r = Jamm::OpenAPI::CustomerApi.new(handler).create(
         buyer: buyer
       )
 
@@ -26,8 +28,10 @@ module Jamm
       raise Jamm::ApiError.from_error(e)
     end
 
-    def self.get(id_or_email)
-      r = Jamm::OpenAPI::CustomerApi.new(Jamm::Client.handler).get(id_or_email)
+    def self.get(id_or_email, merchant: nil)
+      handler = Jamm::Client.handler(merchant: merchant)
+
+      r = Jamm::OpenAPI::CustomerApi.new(handler).get(id_or_email)
 
       if r.customer.activated.nil?
         # Activated flag requires explicit binding on false, since RPC/OpenAPI does
@@ -40,24 +44,27 @@ module Jamm
       raise Jamm::ApiError.from_error(e)
     end
 
-    def self.get_contract(id)
-      Jamm::OpenAPI::CustomerApi.new(Jamm::Client.handler).get_contract(id)
+    def self.get_contract(id, merchant: nil)
+      handler = Jamm::Client.handler(merchant: merchant)
+      Jamm::OpenAPI::CustomerApi.new(handler).get_contract(id)
     rescue Jamm::OpenAPI::ApiError => e
       return nil if [404].include?(e.code)
 
       raise Jamm::ApiError.from_error(e)
     end
 
-    def self.update(id, params)
-      r = Jamm::OpenAPI::CustomerApi.new(Jamm::Client.handler).update(id, params)
+    def self.update(id, params, merchant: nil)
+      handler = Jamm::Client.handler(merchant: merchant)
+      r = Jamm::OpenAPI::CustomerApi.new(handler).update(id, params)
 
       r.customer
     rescue Jamm::OpenAPI::ApiError => e
       raise Jamm::ApiError.from_error(e)
     end
 
-    def self.delete(id)
-      Jamm::OpenAPI::CustomerApi.new(Jamm::Client.handler).delete(id)
+    def self.delete(id, merchant: nil)
+      handler = Jamm::Client.handler(merchant: merchant)
+      Jamm::OpenAPI::CustomerApi.new(handler).delete(id)
     rescue Jamm::OpenAPI::ApiError => e
       raise Jamm::ApiError.from_error(e)
     end

data/lib/jamm/healthcheck.rb

@@ -7,8 +7,9 @@ require 'jamm/errors'
 
 module Jamm
   module Healthcheck
-    def self.ping
-      Jamm::OpenAPI::HealthcheckApi.new(Jamm::Client.handler).ping
+    def self.ping(merchant: nil)
+      handler = Jamm::Client.handler(merchant: merchant)
+      Jamm::OpenAPI::HealthcheckApi.new(handler).ping
     rescue Jamm::OpenAPI::ApiError => e
       raise Jamm::ApiError.from_error(e)
     end

data/lib/jamm/payment.rb

@@ -7,7 +7,15 @@ require 'jamm/errors'
 
 module Jamm
   module Payment
-    def self.on_session(charge: nil, redirect: nil, customer: nil, buyer: nil, one_time: false)
+    def self.on_session(
+      charge: nil,
+      redirect: nil,
+      customer: nil,
+      buyer: nil,
+      one_time: false,
+      # Platform can set merchant id to call on behalf of the merchant.
+      merchant: nil
+    )
       request = if customer.nil?
                   Jamm::OpenAPI::OnSessionPaymentRequest.new(
                     buyer: buyer,
@@ -24,32 +32,44 @@ module Jamm
                   )
                 end
 
-      Jamm::OpenAPI::PaymentApi.new(Jamm::Client.handler).on_session_payment(request)
+      handler = Jamm::Client.handler(merchant: merchant)
+      Jamm::OpenAPI::PaymentApi.new(handler).on_session_payment(request)
     rescue Jamm::OpenAPI::ApiError => e
       raise Jamm::ApiError.from_error(e)
     end
 
-    def self.off_session(customer:, charge:)
+    def self.off_session(customer:, charge:, merchant: nil)
       request = Jamm::OpenAPI::OffSessionPaymentRequest.new(
         customer: customer,
         charge: charge
       )
 
-      Jamm::OpenAPI::PaymentApi.new(Jamm::Client.handler).off_session_payment(request)
+      handler = Jamm::Client.handler(merchant: merchant)
+      Jamm::OpenAPI::PaymentApi.new(handler).off_session_payment(request)
     rescue Jamm::OpenAPI::ApiError => e
       raise Jamm::ApiError.from_error(e)
     end
 
-    def self.get(charge_id)
-      Jamm::OpenAPI::PaymentApi.new(Jamm::Client.handler).get_charge(charge_id)
+    def self.get(charge_id, merchant: nil)
+      handler = Jamm::Client.handler(merchant: merchant)
+
+      Jamm::OpenAPI::PaymentApi.new(handler).get_charge(charge_id)
     rescue Jamm::OpenAPI::ApiError => e
       return nil if e.code == 404
 
       raise Jamm::ApiError.from_error(e)
     end
 
-    def self.list(customer:, pagination: nil)
-      Jamm::OpenAPI::PaymentApi.new(Jamm::Client.handler).get_charges(customer, pagination.nil? ? {} : pagination)
+    def self.refund(request, merchant: nil)
+      handler = Jamm::Client.handler(merchant: merchant)
+      Jamm::OpenAPI::PaymentApi.new(handler).refund(request)
+    rescue Jamm::OpenAPI::ApiError => e
+      raise Jamm::ApiError.from_error(e)
+    end
+
+    def self.list(customer:, pagination: nil, merchant: nil)
+      handler = Jamm::Client.handler(merchant: merchant)
+      Jamm::OpenAPI::PaymentApi.new(handler).get_charges(customer, pagination.nil? ? {} : pagination)
     rescue Jamm::OpenAPI::ApiError => e
       if [404].include?(e.code)
         nil

data/lib/jamm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Jamm
-  VERSION = '1.7.0'
+  VERSION = '2.0.0'
 end

data/lib/jamm/webhook.rb

@@ -22,7 +22,7 @@ module Jamm
         out.content = Jamm::OpenAPI::ChargeMessage.new(json[:content])
         return out
 
-      when Jamm::OpenAPI::EventType::CHARGE_CANCEL
+      when Jamm::OpenAPI::EventType::CHARGE_REFUND
         out.content = Jamm::OpenAPI::ChargeMessage.new(json[:content])
         return out
 
@@ -42,7 +42,8 @@ module Jamm
       raise 'Unknown event type'
     end
 
-    # Verify message
+    # Verify message.
+    # This method will use client secret to verify the message.
     def self.verify(data:, signature:)
       raise ArgumentError, 'data cannot be nil' if data.nil?
       raise ArgumentError, 'signature cannot be nil' if signature.nil?

data/lib/jamm.rb

@@ -11,9 +11,7 @@ require 'jamm/openapi'
 require 'jamm/version'
 
 # OpenAPI wrappers
-require 'jamm/charge'
 require 'jamm/customer'
-require 'jamm/contract'
 require 'jamm/deprecation'
 require 'jamm/healthcheck'
 require 'jamm/payment'
@@ -24,8 +22,15 @@ require 'jamm/api_patches'
 
 # Jamm Ruby SDK
 module Jamm
+  # SDK mode, either platform or merchant.
+  module Mode
+    PLATFORM = 'platform'
+    MERCHANT = 'merchant'
+  end
+
   # Configurable attributes.
   @environment = nil
+  @mode = nil
   @oauth_base = nil
   @openapi = nil
   @open_timeout = 30
@@ -33,24 +38,28 @@ module Jamm
   @max_retry = 0
 
   class << self
-    attr_accessor :api, :client_id, :client_secret, :api_base, :environment, :oauth_base, :api_version, :connect_base,
+    attr_accessor :api, :client_id, :client_secret, :api_base, :environment, :mode, :oauth_base, :api_version, :connect_base,
                   :openapi, :open_timeout, :read_timeout, :max_retry, :retry_initial_delay, :retry_max_delay
   end
 
-  def self.configure(client_id:, client_secret:, env:)
+  # Configure SDK with Client ID and Secret.
+  # Optionally enable `platform` for platformers to call Jamm API on behalf of their merchant.
+  def self.configure(client_id:, client_secret:, env:, platform: false)
     Jamm.client_id = client_id
     Jamm.client_secret = client_secret
 
+    Jamm.mode = platform ? Jamm::Mode::PLATFORM : Jamm::Mode::MERCHANT
+
     case env
     when 'prd', 'prod', 'production'
-      self.oauth_base = 'https://merchant-identity.jamm-pay.jp'
+      self.oauth_base = Jamm.mode == Jamm::Mode::PLATFORM ? 'https://platform-identity.jamm-pay.jp' : 'https://merchant-identity.jamm-pay.jp'
 
       self.environment = 'production'
       self.openapi = Jamm::OpenAPI::ApiClient.new
       openapi.config.host = 'api.jamm-pay.jp'
 
     when 'local'
-      self.oauth_base = 'https://merchant-identity.develop.jamm-pay.jp'
+      self.oauth_base = Jamm.mode == Jamm::Mode::PLATFORM ? 'https://platform-identity.develop.jamm-pay.jp' : 'https://merchant-identity.develop.jamm-pay.jp'
 
       self.environment = 'local'
       self.openapi = Jamm::OpenAPI::ApiClient.new
@@ -58,7 +67,7 @@ module Jamm
       openapi.config.verify_ssl = false
       openapi.config.verify_ssl_host = false
     else
-      self.oauth_base = "https://merchant-identity.#{env}.jamm-pay.jp"
+      self.oauth_base = Jamm.mode == Jamm::Mode::PLATFORM ? "https://platform-identity.#{env}.jamm-pay.jp" : "https://merchant-identity.#{env}.jamm-pay.jp"
 
       self.environment = env
       self.openapi = Jamm::OpenAPI::ApiClient.new

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jamm
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Jamm
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-16 00:00:00.000000000 Z
+date: 2026-03-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -86,6 +86,7 @@ files:
 - lib/jamm/api/models/v1_charge_message.rb
 - lib/jamm/api/models/v1_charge_message_status.rb
 - lib/jamm/api/models/v1_charge_result.rb
+- lib/jamm/api/models/v1_charge_status.rb
 - lib/jamm/api/models/v1_contract.rb
 - lib/jamm/api/models/v1_contract_message.rb
 - lib/jamm/api/models/v1_contract_status.rb
@@ -115,6 +116,8 @@ files:
 - lib/jamm/api/models/v1_merchant_customer.rb
 - lib/jamm/api/models/v1_merchant_webhook_message.rb
 - lib/jamm/api/models/v1_message_response.rb
+- lib/jamm/api/models/v1_off_session_payment_async_request.rb
+- lib/jamm/api/models/v1_off_session_payment_async_response.rb
 - lib/jamm/api/models/v1_off_session_payment_request.rb
 - lib/jamm/api/models/v1_off_session_payment_response.rb
 - lib/jamm/api/models/v1_on_session_payment_data.rb
@@ -126,6 +129,8 @@ files:
 - lib/jamm/api/models/v1_payment_authorization_status.rb
 - lib/jamm/api/models/v1_payment_link.rb
 - lib/jamm/api/models/v1_ping_response.rb
+- lib/jamm/api/models/v1_refund_request.rb
+- lib/jamm/api/models/v1_refund_response.rb
 - lib/jamm/api/models/v1_search_banks_response.rb
 - lib/jamm/api/models/v1_search_branches_response.rb
 - lib/jamm/api/models/v1_update_customer_response.rb
@@ -139,9 +144,7 @@ files:
 - lib/jamm/api/models/v1_withdraw_response.rb
 - lib/jamm/api/version.rb
 - lib/jamm/api_patches.rb
-- lib/jamm/charge.rb
 - lib/jamm/client.rb
-- lib/jamm/contract.rb
 - lib/jamm/customer.rb
 - lib/jamm/deprecation.rb
 - lib/jamm/errors.rb

data/lib/jamm/charge.rb

@@ -1,65 +0,0 @@
-# frozen_string_literal: true
-
-require 'rest-client'
-require 'json'
-require 'base64'
-require 'jamm/errors'
-
-module Jamm
-  module Charge
-    # DEPRECATED, use Jamm::Payment.on_session
-    def self.create_with_redirect(customer:, charge:, redirect: nil)
-      Jamm::Deprecation.warn('Jamm::Charge.create_with_redirect')
-
-      request = Jamm::OpenAPI::AddChargeRequest.new(
-        customer: customer,
-        charge: charge,
-        redirect: redirect
-      )
-
-      Jamm::OpenAPI::PaymentApi.new(Jamm::Client.handler).add_charge(request)
-    rescue Jamm::OpenAPI::ApiError => e
-      raise Jamm::ApiError.from_error(e)
-    end
-
-    # DEPRECATED, use Jamm::Payment.off_session
-    def self.create_without_redirect(customer:, charge:)
-      Jamm::Deprecation.warn('Jamm::Charge.create_without_redirect')
-
-      request = Jamm::OpenAPI::WithdrawRequest.new(
-        customer: customer,
-        charge: charge
-      )
-
-      Jamm::OpenAPI::PaymentApi.new(Jamm::Client.handler).withdraw(request)
-    rescue Jamm::OpenAPI::ApiError => e
-      raise Jamm::ApiError.from_error(e)
-    end
-
-    # DEPRECATED, use Jamm::Payment.get
-    def self.get(charge_id)
-      Jamm::Deprecation.warn('Jamm::Charge.get')
-
-      Jamm::OpenAPI::PaymentApi.new(Jamm::Client.handler).get_charge(charge_id)
-    rescue Jamm::OpenAPI::ApiError => e
-      return nil if e.code == 404
-
-      raise Jamm::ApiError.from_error(e)
-    end
-
-    # DEPRECATED, use Jamm::Payment.list
-    def self.list(customer:, pagination: nil)
-      Jamm::Deprecation.warn('Jamm::Charge.list')
-
-      Jamm::OpenAPI::PaymentApi.new(Jamm::Client.handler).get_charges(customer, pagination.nil? ? {} : pagination)
-    rescue Jamm::OpenAPI::ApiError => e
-      if [404].include?(e.code)
-        nil
-      else
-        {
-          charges: []
-        }
-      end
-    end
-  end
-end

data/lib/jamm/contract.rb

@@ -1,39 +0,0 @@
-# frozen_string_literal: true
-
-require 'rest-client'
-require 'json'
-require 'base64'
-require 'jamm/errors'
-
-module Jamm
-  module Contract
-    def self.create_with_charge(buyer:, charge:, redirect: nil)
-      request = Jamm::OpenAPI::CreateContractWithChargeRequest.new(
-        buyer: buyer,
-        charge: charge,
-        redirect: redirect
-      )
-
-      Jamm::OpenAPI::PaymentApi.new(Jamm::Client.handler).create_contract_with_charge(request)
-    rescue Jamm::OpenAPI::ApiError => e
-      raise Jamm::ApiError.from_error(e)
-    end
-
-    def self.create_without_charge(buyer:, redirect: nil)
-      request = Jamm::OpenAPI::CreateContractWithoutChargeRequest.new(
-        buyer: buyer,
-        redirect: redirect
-      )
-
-      Jamm::OpenAPI::PaymentApi.new(Jamm::Client.handler).create_contract_without_charge(request)
-    rescue Jamm::OpenAPI::ApiError => e
-      raise Jamm::ApiError.from_error(e)
-    end
-
-    def self.get(customer_id)
-      Jamm::OpenAPI::CustomerApi.new(Jamm::Client.handler).get_contract(customer_id)
-    rescue Jamm::OpenAPI::ApiError => e
-      [404].include?(e.code) ? nil : Jamm::ApiError.from_error(e)
-    end
-  end
-end