airwallex 0.7.0 → 0.9.0

data/lib/airwallex/resources/payment_intent.rb

@@ -7,6 +7,9 @@ module Airwallex
     extend APIOperations::List
     include APIOperations::Update
 
+    # Sandbox-only — see https://www.airwallex.com/docs/api/simulation/shopper-actions
+    SIMULATION_SHOPPER_ACTION_PATH = "/api/v1/simulation/pa/shopper_actions"
+
     def self.resource_path
       "/api/v1/pa/payment_intents"
     end
@@ -40,5 +43,28 @@ module Airwallex
       refresh_from(response)
       self
     end
+
+    # Simulate the shopper completing a redirect/3DS challenge raised during
+    # #confirm, using the `url` from the confirm response's next_action
+    #
+    # @param url [String] the redirect URL from #confirm's next_action
+    # @return [PaymentIntent] self
+    def simulate_shopper_pay(url:)
+      response = Airwallex.client.post("#{SIMULATION_SHOPPER_ACTION_PATH}/pay", url: url)
+      refresh_from(response)
+      self
+    end
+
+    # Simulate the shopper abandoning/rejecting a redirect/3DS challenge
+    # raised during #confirm, using the `url` from the confirm response's
+    # next_action
+    #
+    # @param url [String] the redirect URL from #confirm's next_action
+    # @return [PaymentIntent] self
+    def simulate_shopper_reject(url:)
+      response = Airwallex.client.post("#{SIMULATION_SHOPPER_ACTION_PATH}/reject", url: url)
+      refresh_from(response)
+      self
+    end
   end
 end

data/lib/airwallex/resources/pos_terminal.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Airwallex
+  # Represents an in-person (POS) Terminal used for card-present payments.
+  #
+  # This gem currently only implements the sandbox Simulation endpoints for
+  # driving a terminal through a test payment; it does not yet implement the
+  # live terminal create/retrieve/list endpoints.
+  # See https://www.airwallex.com/docs/api/simulation/pos-terminals
+  #
+  # @example Simulate a terminal completing a PaymentIntent
+  #   Airwallex::POSTerminal.simulate_turn_on(terminal_id: "term_123")
+  #   Airwallex::POSTerminal.simulate_confirm_payment_intent(
+  #     terminal_id: "term_123",
+  #     payment_scenario_name: "approve"
+  #   )
+  class POSTerminal < APIResource
+    # @return [String] API resource path for simulated POS terminal actions
+    def self.resource_path
+      "/api/v1/simulation/pa/pos/terminals"
+    end
+
+    # Simulate turning a terminal on
+    #
+    # @param terminal_id [String]
+    # @return [POSTerminal]
+    def self.simulate_turn_on(terminal_id:)
+      response = Airwallex.client.post("#{resource_path}/turn_on", terminal_id: terminal_id)
+      new(response)
+    end
+
+    # Simulate turning a terminal off
+    #
+    # @param terminal_id [String]
+    # @return [POSTerminal]
+    def self.simulate_turn_off(terminal_id:)
+      response = Airwallex.client.post("#{resource_path}/turn_off", terminal_id: terminal_id)
+      new(response)
+    end
+
+    # Simulate generating a terminal activation code
+    #
+    # @param request_id [String]
+    # @return [Hash] raw response (contains the generated activation code)
+    def self.simulate_generate_activation_code(request_id:)
+      Airwallex.client.post("#{resource_path}/generate_activation_code", request_id: request_id)
+    end
+
+    # Simulate a terminal confirming a PaymentIntent under a named test
+    # scenario (see .simulate_payment_scenarios for valid names)
+    #
+    # @param terminal_id [String]
+    # @param payment_scenario_name [String]
+    # @return [POSTerminal]
+    def self.simulate_confirm_payment_intent(terminal_id:, payment_scenario_name:)
+      response = Airwallex.client.post(
+        "#{resource_path}/confirm_payment_intent",
+        terminal_id: terminal_id,
+        payment_scenario_name: payment_scenario_name
+      )
+      new(response)
+    end
+
+    # List the test scenario names available to .simulate_confirm_payment_intent
+    #
+    # @return [Array, Hash] raw response
+    def self.simulate_payment_scenarios
+      Airwallex.client.get("#{resource_path}/payment_scenarios")
+    end
+  end
+end

data/lib/airwallex/resources/rfi.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Airwallex
+  # Represents a Request for Information (RFI) — a compliance question
+  # Airwallex raises against your account (KYC, an ongoing KYC review, a
+  # cardholder, a transaction, payment enablement, or merchant risk).
+  #
+  # This gem currently only implements the sandbox Simulation endpoints
+  # (there is no live create — real RFIs originate from Airwallex's own
+  # compliance review, same as Dispute). See
+  # https://www.airwallex.com/docs/api/simulation/request-for-information
+  #
+  # @example Raise a KYC RFI, then close it
+  #   rfi = Airwallex::RFI.simulate_create(
+  #     type: "KYC",
+  #     questions: [{ answer: { type: "TEXT" } }]
+  #   )
+  #   rfi.simulate_close
+  class RFI < APIResource
+    # @return [String] API resource path for simulated RFI actions
+    def self.resource_path
+      "/api/v1/simulation/rfis"
+    end
+
+    # Simulate Airwallex raising an RFI
+    #
+    # @param params [Hash] type: (required, one of "KYC", "KYC_ONGOING",
+    #   "CARDHOLDER", "TRANSACTION", "PAYMENT_ENABLEMENT",
+    #   "MERCHANT_RISK"); questions: (required, array of
+    #   { answer: { type: }, sources: [] })
+    # @return [RFI]
+    def self.simulate_create(params = {})
+      response = Airwallex.client.post("#{resource_path}/create", params)
+      new(response)
+    end
+
+    # Simulate closing an RFI
+    #
+    # @param rfi_id [String]
+    # @return [RFI]
+    def self.simulate_close(rfi_id)
+      response = Airwallex.client.post("#{resource_path}/#{rfi_id}/close", {})
+      new(response)
+    end
+
+    # Simulate a follow-up on an RFI — reopen an existing answered question
+    # (by id) or append a new one
+    #
+    # @param rfi_id [String]
+    # @param params [Hash] questions: (required, array of
+    #   { id: } or { answer: { type: }, sources: [] })
+    # @return [RFI]
+    def self.simulate_follow_up(rfi_id, params = {})
+      response = Airwallex.client.post("#{resource_path}/#{rfi_id}/follow_up", params)
+      new(response)
+    end
+
+    # Simulate closing this RFI
+    #
+    # @return [RFI] self
+    def simulate_close
+      response = Airwallex.client.post("#{self.class.resource_path}/#{id}/close", {})
+      refresh_from(response)
+      self
+    end
+
+    # Simulate a follow-up on this RFI
+    #
+    # @param params [Hash] questions: (required)
+    # @return [RFI] self
+    def simulate_follow_up(params = {})
+      response = Airwallex.client.post("#{self.class.resource_path}/#{id}/follow_up", params)
+      refresh_from(response)
+      self
+    end
+  end
+end

data/lib/airwallex/resources/transfer.rb

@@ -6,6 +6,9 @@ module Airwallex
     extend APIOperations::Retrieve
     extend APIOperations::List
 
+    # Sandbox-only — see https://www.airwallex.com/docs/api/simulation/transfers
+    SIMULATION_PATH = "/api/v1/simulation/transfers"
+
     def self.resource_path
       "/api/v1/transfers"
     end
@@ -19,5 +22,38 @@ module Airwallex
       refresh_from(response)
       self
     end
+
+    # Simulate this transfer's status advancing one step. The standard
+    # lifecycle is SCHEDULED -> PROCESSING -> SENT -> PAID, progressed one
+    # step at a time; OVERDUE, FAILED, and CANCELLED can be jumped to
+    # directly.
+    #
+    # @param next_status [String] one of "OVERDUE", "PROCESSING", "SENT",
+    #   "PAID", "FAILED", "CANCELLED"
+    # @param failure_type [String, nil] failure reason code, only
+    #   meaningful when next_status is "FAILED"
+    # @return [Transfer] self
+    def simulate_transition(next_status:, failure_type: nil)
+      params = { next_status: next_status }
+      params[:failure_type] = failure_type if failure_type
+      response = Airwallex.client.post("#{SIMULATION_PATH}/#{id}/transition", params)
+      refresh_from(response)
+      self
+    end
+
+    # Simulate a transfer's status advancing one step
+    #
+    # @param transfer_id [String]
+    # @param next_status [String] one of "OVERDUE", "PROCESSING", "SENT",
+    #   "PAID", "FAILED", "CANCELLED"
+    # @param failure_type [String, nil] failure reason code, only
+    #   meaningful when next_status is "FAILED"
+    # @return [Transfer]
+    def self.simulate_transition(transfer_id, next_status:, failure_type: nil)
+      params = { next_status: next_status }
+      params[:failure_type] = failure_type if failure_type
+      response = Airwallex.client.post("#{SIMULATION_PATH}/#{transfer_id}/transition", params)
+      new(response)
+    end
   end
 end

data/lib/airwallex/util.rb

@@ -40,11 +40,14 @@ module Airwallex
       hash.transform_keys(&:to_sym)
     end
 
-    def deep_symbolize_keys(hash)
-      return hash unless hash.is_a?(Hash)
-
-      hash.each_with_object({}) do |(key, value), result|
-        result[key.to_sym] = value.is_a?(Hash) ? deep_symbolize_keys(value) : value
+    def deep_symbolize_keys(value)
+      case value
+      when Hash
+        value.each_with_object({}) { |(k, v), result| result[k.to_sym] = deep_symbolize_keys(v) }
+      when Array
+        value.map { |v| deep_symbolize_keys(v) }
+      else
+        value
       end
     end
 

data/lib/airwallex/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Airwallex
-  VERSION = "0.7.0"
+  VERSION = "0.9.0"
 end

data/lib/airwallex.rb

@@ -48,6 +48,13 @@ require_relative "airwallex/resources/connected_account"
 require_relative "airwallex/resources/account_amendment"
 require_relative "airwallex/resources/funds_split"
 require_relative "airwallex/resources/charge"
+require_relative "airwallex/resources/deposit"
+require_relative "airwallex/resources/issuing_transaction"
+require_relative "airwallex/resources/cardholder"
+require_relative "airwallex/resources/linked_account"
+require_relative "airwallex/resources/account_offboarding"
+require_relative "airwallex/resources/rfi"
+require_relative "airwallex/resources/pos_terminal"
 
 module Airwallex
   class << self

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: airwallex
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Chayut Orapinpatipat
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-28 00:00:00.000000000 Z
+date: 2026-09-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -81,6 +81,7 @@ files:
 - lib/airwallex/middleware/auth_refresh.rb
 - lib/airwallex/middleware/idempotency.rb
 - lib/airwallex/resources/account_amendment.rb
+- lib/airwallex/resources/account_offboarding.rb
 - lib/airwallex/resources/balance.rb
 - lib/airwallex/resources/batch_transfer.rb
 - lib/airwallex/resources/beneficiary.rb
@@ -89,23 +90,29 @@ files:
 - lib/airwallex/resources/billing_product.rb
 - lib/airwallex/resources/billing_subscription.rb
 - lib/airwallex/resources/billing_subscription_item.rb
+- lib/airwallex/resources/cardholder.rb
 - lib/airwallex/resources/charge.rb
 - lib/airwallex/resources/connected_account.rb
 - lib/airwallex/resources/conversion.rb
 - lib/airwallex/resources/customer.rb
+- lib/airwallex/resources/deposit.rb
 - lib/airwallex/resources/dispute.rb
 - lib/airwallex/resources/funds_split.rb
 - lib/airwallex/resources/global_account.rb
 - lib/airwallex/resources/global_account_alias.rb
 - lib/airwallex/resources/global_account_mandate.rb
 - lib/airwallex/resources/global_account_transaction.rb
+- lib/airwallex/resources/issuing_transaction.rb
+- lib/airwallex/resources/linked_account.rb
 - lib/airwallex/resources/payment_consent.rb
 - lib/airwallex/resources/payment_intent.rb
 - lib/airwallex/resources/payment_method.rb
 - lib/airwallex/resources/payment_source.rb
+- lib/airwallex/resources/pos_terminal.rb
 - lib/airwallex/resources/quote.rb
 - lib/airwallex/resources/rate.rb
 - lib/airwallex/resources/refund.rb
+- lib/airwallex/resources/rfi.rb
 - lib/airwallex/resources/transfer.rb
 - lib/airwallex/util.rb
 - lib/airwallex/version.rb
@@ -137,7 +144,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.16
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: Production-grade Ruby client for the Airwallex API