airwallex 0.8.0 → 0.10.0

data/lib/airwallex/resources/rfi.rb

@@ -0,0 +1,135 @@
+# 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).
+  #
+  # Supports retrieving and listing real RFIs, plus the sandbox Simulation
+  # endpoints for raising, closing and following up on them (there is no
+  # live create — real RFIs originate from Airwallex's own compliance
+  # review, same as Dispute). See
+  # https://www.airwallex.com/docs/api/risk/request_for_information_rfi and
+  # https://www.airwallex.com/docs/api/simulation/request-for-information
+  #
+  # Statuses: ACTION_REQUIRED, ANSWERED, CLOSED. Types: KYC, KYC_ONGOING,
+  # CARDHOLDER, TRANSACTION, PAYMENT_ENABLEMENT, MERCHANT_RISK.
+  #
+  # Reading RFIs requires the API key's "Risk → Request for Information
+  # (RFI): Read" permission — without it Airwallex returns 401
+  # (AuthenticationError).
+  #
+  # @example Retrieve an RFI for a connected account
+  #   rfi = Airwallex::RFI.retrieve("rfi_123", headers: { "x-on-behalf-of" => "acct_123" })
+  #   rfi.status                           # => "ACTION_REQUIRED"
+  #   rfi.active_request[:questions].first # => { id: ..., title: { en: ... }, ... }
+  #
+  # @example List open RFIs, following every page
+  #   Airwallex::RFI.list(
+  #     { statuses: "ACTION_REQUIRED" },
+  #     headers: { "x-on-behalf-of" => "acct_123" }
+  #   ).auto_paging_each { |rfi| puts rfi.id }
+  #
+  # @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
+    extend APIOperations::Retrieve
+    extend APIOperations::List
+
+    # Sandbox-only — see https://www.airwallex.com/docs/api/simulation/request-for-information
+    SIMULATION_PATH = "/api/v1/simulation/rfis"
+
+    # @return [String] API resource path for RFIs
+    def self.resource_path
+      "/api/v1/rfis"
+    end
+
+    # List RFIs. Unlike most resources, RFIs use bookmark pagination: the
+    # response carries page_after/page_before instead of has_more/next_cursor,
+    # and the next page is requested with page: <page_after>.
+    #
+    # @param params [Hash] page: (bookmark), page_size: (1-2000, default
+    #   100), statuses: / types: (comma-separated strings, e.g.
+    #   "ACTION_REQUIRED,ANSWERED"), from_created_at: / end_created_at:
+    #   (ISO8601)
+    # @param opts [Hash] headers: (e.g. { "x-on-behalf-of" => account_id }),
+    #   kept on every subsequent page
+    # @return [ListObject<RFI>]
+    def self.list(params = {}, opts = {})
+      response = Airwallex.client.get(resource_path, params, opts[:headers] || {})
+      items = extract_data(response)
+      page_after = response.is_a?(Hash) ? response[:page_after] || response["page_after"] : nil
+
+      ListObject.new(
+        data: items,
+        has_more: !page_after.nil? && !items.empty?,
+        next_cursor: page_after,
+        cursor_param: :page,
+        resource_class: self,
+        params: params,
+        opts: opts
+      )
+    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: [] })
+    # @param opts [Hash] headers: (e.g. { "x-on-behalf-of" => account_id })
+    # @return [RFI]
+    def self.simulate_create(params = {}, opts = {})
+      response = Airwallex.client.post("#{SIMULATION_PATH}/create", params, opts[:headers] || {})
+      new(response)
+    end
+
+    # Simulate closing an RFI
+    #
+    # @param rfi_id [String]
+    # @param opts [Hash] headers: (e.g. { "x-on-behalf-of" => account_id })
+    # @return [RFI]
+    def self.simulate_close(rfi_id, opts = {})
+      response = Airwallex.client.post("#{SIMULATION_PATH}/#{rfi_id}/close", {}, opts[:headers] || {})
+      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: [] })
+    # @param opts [Hash] headers: (e.g. { "x-on-behalf-of" => account_id })
+    # @return [RFI]
+    def self.simulate_follow_up(rfi_id, params = {}, opts = {})
+      response = Airwallex.client.post("#{SIMULATION_PATH}/#{rfi_id}/follow_up", params, opts[:headers] || {})
+      new(response)
+    end
+
+    # Simulate closing this RFI
+    #
+    # @param opts [Hash] headers: (e.g. { "x-on-behalf-of" => account_id })
+    # @return [RFI] self
+    def simulate_close(opts = {})
+      response = Airwallex.client.post("#{SIMULATION_PATH}/#{id}/close", {}, opts[:headers] || {})
+      refresh_from(response)
+      self
+    end
+
+    # Simulate a follow-up on this RFI
+    #
+    # @param params [Hash] questions: (required)
+    # @param opts [Hash] headers: (e.g. { "x-on-behalf-of" => account_id })
+    # @return [RFI] self
+    def simulate_follow_up(params = {}, opts = {})
+      response = Airwallex.client.post("#{SIMULATION_PATH}/#{id}/follow_up", params, opts[:headers] || {})
+      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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Airwallex
-  VERSION = "0.8.0"
+  VERSION = "0.10.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.8.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Chayut Orapinpatipat
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-02 00:00:00.000000000 Z
+date: 2026-09-29 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.22
+rubygems_version: 3.5.16
 signing_key:
 specification_version: 4
 summary: Production-grade Ruby client for the Airwallex API