airwallex 0.9.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0fc42ac04f0af0416fc2fe200f747a17ec326ea5b071a40d5965043da1ebfd7c
-  data.tar.gz: bfc8c907e1ce9d0e702e124bdf0c85f1fb8827f7c90b0b4382665b5a4f1ade00
+  metadata.gz: f1288d75bff8a6f00a8c0dfffc318b6df1821cb26c945e062930de6035e83822
+  data.tar.gz: 5452a4a8aed172764129f05043646e9f074c1c9e62df84246ffe6ff575ba0140
 SHA512:
-  metadata.gz: 952b7120270923df264d701e631570a673584fd08f73502dc3ec36ff19bdd47577d6d799928cdae40781813cbd5f881de7ce4dcca3488e10ee5ff4d46f67da76
-  data.tar.gz: 440bfe68c53e17f2a5b30856f6de51257fffdc32c38e459ebe82d8604c9b018d58ee6369249bc2e2907701f0c79f43bdd9005c08eaaf19aa9ceb81486a2e9999
+  metadata.gz: 02e3eea25661113f96af469d3154ede00aae144c671c42fcdf48d2e08d900c74ff2291b9b901ebc2b2072688b840d07d58f6b7eb21bd14aaf2c75d2e4625e6f2
+  data.tar.gz: 31bb06a6c4a99f4d433c63b5eb9e209e31deeec63dd3d98a516d259801530e874b66b70d4680d386eba0e569589a55e51c59640af3907fbade0e1da9171b6698

data/CHANGELOG.md

@@ -1,5 +1,51 @@
 ## [Unreleased]
 
+## [0.11.0] - 2026-10-01
+
+### Added
+
+- `FundsSplitReversal` resource (`.create`, `.retrieve`, `.list`) for
+  `/api/v1/pa/funds_split_reversals`, which moves split funds back from a
+  connected account to the platform. `.list` takes the required `funds_split_id:`.
+  Partial reversals are allowed until the full split is reversed
+- `ConnectedAccountTransfer` resource (`.create`, `.retrieve`, `.list`) for
+  `/api/v1/connected_account_transfers`, which moves funds between the platform
+  and a connected account. Pass `headers: { "x-on-behalf-of" => ... }` to
+  debit a connected account instead of the platform
+- `Transfer.simulate_transition`, `Transfer#simulate_transition` and
+  `Transfer#cancel` accept `headers:`. A transfer created `x-on-behalf-of` a
+  connected account can only be found with that same header
+
+### Fixed
+
+- `FundsSplit` docs (README and class comment) now show the real create body:
+  `request_id`, `source_id`, `source_type: "PAYMENT_INTENT"`, `amount` (string),
+  `destination`, `auto_release`, `metadata`, with one split per destination.
+  The docs previously showed `payment_intent_id:` and `splits: [...]`
+- Documented that `funds_split.*` webhook payloads use `split_id` (not `id`)
+  and carry no `request_id`, and that the sandbox rejects a PROCESSING -> PAID
+  transfer transition (go through SENT)
+
+## [0.10.0] - 2026-09-29
+
+### Added
+
+- `RFI.retrieve` (`GET /api/v1/rfis/{id}`) and `RFI.list` (`GET /api/v1/rfis`, filterable by
+  `statuses`, `types`, `from_created_at`, `end_created_at`, `page_size`). Both take
+  `headers:` for `x-on-behalf-of`
+- `RFI.list` supports bookmark pagination: `has_more`/`next_cursor` come from `page_after`, and
+  `next_page`/`auto_paging_each` request `page: <page_after>`
+- `ListObject` accepts `cursor_param:` (defaults to `:next_cursor`) and `opts:`, and forwards
+  the original `opts` (e.g. `headers:`) to subsequent pages. Resources that don't pass these
+  behave exactly as before
+- `RFI.simulate_create`/`.simulate_close`/`.simulate_follow_up` and the instance
+  `#simulate_close`/`#simulate_follow_up` accept an optional trailing `opts` hash with `headers:`
+
+### Changed
+
+- `RFI.resource_path` is now `/api/v1/rfis`; the simulation path moved to `RFI::SIMULATION_PATH`
+  (`/api/v1/simulation/rfis`). Simulation methods hit the same URLs as before
+
 ## [0.9.0] - 2026-09-09
 
 ### Added

data/README.md

@@ -16,6 +16,7 @@ This gem provides a Ruby interface to Airwallex's payment infrastructure, design
 - **Billing**: Products, prices, billing customers, and subscriptions for recurring/instalment billing
 - **Recurring Payments**: Payment consents and payment sources for merchant-initiated (off-session) charges
 - **Scale**: Connected accounts, funds splits, and charges for platforms onboarding sub-merchants
+- **Compliance**: Retrieve and list Requests for Information (RFIs), including for connected accounts
 - **Sandbox Simulations**: Deposits, issuing transactions, disputes, transfer status, Direct Debit mandates, connected account/offboarding review outcomes, RFIs, and POS terminals — see [Sandbox Simulations](#sandbox-simulations)
 - **Idempotency**: Automatic request deduplication for safe retries
 - **Pagination**: Unified interface over cursor-based and offset-based pagination
@@ -374,7 +375,7 @@ payment_source = Airwallex::PaymentSource.create(
 )
 ```
 
-### Scale (Connected Accounts, Funds Splits, Charges)
+### Scale (Connected Accounts, Funds Splits, Reversals, Connected Account Transfers, Charges)
 
 For platforms onboarding sub-merchants:
 
@@ -406,17 +407,76 @@ connected_account.submit
 Airwallex::ConnectedAccount.current
 Airwallex::ConnectedAccount.wallet_info
 
-# Split a charge's funds between the platform and a connected account
+# Split part of a PaymentIntent's funds to a connected account. One split per
+# destination: create several splits to pay several connected accounts.
+# A reused request_id raises BadRequestError (duplicate_request); splitting
+# more than the PaymentIntent amount raises amount_above_limit.
 split = Airwallex::FundsSplit.create(
-  payment_intent_id: payment_intent.id,
-  splits: [{ account_id: connected_account.id, amount: 10.00 }]
+  request_id: 'split-order-123',  # required, max 64
+  source_id: payment_intent.id,   # required
+  source_type: 'PAYMENT_INTENT',  # required
+  amount: '10.00',                # required, string
+  destination: connected_account.id,
+  auto_release: false,            # optional, default true
+  metadata: { order_id: '123' }   # optional
+)
+split.release # only needed when auto_release: false
+
+# Reverse split funds back to the platform. Partial reversals are allowed
+# until the full split is reversed. Statuses: CREATED, RELEASED, SETTLED
+reversal = Airwallex::FundsSplitReversal.create(
+  request_id: 'rev-order-123',    # required, max 64
+  funds_split_id: split.id,       # required
+  amount: '5.00',                 # required, string
+  metadata: { reason: 'refund' }  # optional
 )
-split.release
+Airwallex::FundsSplitReversal.retrieve(reversal.id)
+Airwallex::FundsSplitReversal.list(funds_split_id: split.id) # funds_split_id is required
+
+# Move funds between the platform and a connected account's wallet. Pass
+# x-on-behalf-of to debit a connected account instead of the platform.
+# Statuses: NEW, PENDING, SETTLED, SUSPENDED, FAILED
+cat = Airwallex::ConnectedAccountTransfer.create(
+  request_id: 'top-up-123',       # required, 1-50
+  amount: '100.00',
+  currency: 'AUD',
+  destination: connected_account.id,
+  reason: 'transfer_to_own_account',
+  reference: 'Ledger top-up'      # required, 1-140
+)
+Airwallex::ConnectedAccountTransfer.retrieve(cat.id)
+Airwallex::ConnectedAccountTransfer.list(destination: connected_account.id, status: 'SETTLED')
+
+# Pay out from a connected account: create the Transfer on its behalf
+Airwallex::Transfer.create(transfer_params, headers: { 'x-on-behalf-of' => connected_account.id })
 
 # Charges (create, retrieve, list)
 charge = Airwallex::Charge.retrieve('charge_id')
 ```
 
+`funds_split.*` webhook payloads name the split `split_id`, not `id`, and carry
+no `request_id`: `{ split_id, status, amount, currency, source_id, source_type, destination, ... }`.
+
+### Requests for Information (RFIs)
+
+RFIs are compliance questions Airwallex raises against an account. They use
+bookmark pagination (`page_after`/`page`), which `ListObject` handles for you,
+and connected accounts are addressed with `x-on-behalf-of`, which is kept
+across pages. The API key needs the **Risk → Request for Information (RFI):
+Read** permission, or Airwallex responds with 401 (`Airwallex::AuthenticationError`).
+
+```ruby
+headers = { 'x-on-behalf-of' => 'acct_123' }
+
+rfi = Airwallex::RFI.retrieve('rfi_123', headers: headers)
+rfi.status                           # => "ACTION_REQUIRED"
+rfi.active_request[:questions].first # => { id: ..., title: { en: ... }, answer: { type: "ATTACHMENT" }, ... }
+
+# statuses/types are comma-separated strings; page_size is 1-2000 (default 100)
+Airwallex::RFI.list({ statuses: 'ACTION_REQUIRED', types: 'KYC,KYC_ONGOING' }, headers: headers)
+              .auto_paging_each { |r| puts r.id }
+```
+
 ### Sandbox Simulations
 
 Sandbox-only endpoints (`/api/v1/simulation/...`) that stand in for the bank,
@@ -534,8 +594,18 @@ transfer.simulate_transition(next_status: 'FAILED', failure_type: 'INSUFFICIENT_
 
 # Class-level equivalent takes a transfer_id directly instead of an instance
 Airwallex::Transfer.simulate_transition('tfr_123', next_status: 'CANCELLED')
+
+# A transfer created x-on-behalf-of a connected account can only be found
+# with the same header (cancel takes it too)
+headers = { 'x-on-behalf-of' => 'acct_123' }
+transfer.simulate_transition(next_status: 'SENT', headers: headers)
+Airwallex::Transfer.simulate_transition('tfr_123', next_status: 'PAID', headers: headers)
+transfer.cancel(headers: headers)
 ```
 
+The sandbox rejects PROCESSING -> PAID with a 500 `operation_failed`. Move the
+transfer to SENT first.
+
 #### Connected Accounts & Offboarding
 
 ```ruby
@@ -621,6 +691,14 @@ rfi.simulate_follow_up(questions: [{ answer: { type: 'TEXT' } }])
 # Class-level equivalents take an rfi_id directly instead of an instance
 Airwallex::RFI.simulate_close('rfi_123')
 Airwallex::RFI.simulate_follow_up('rfi_123', questions: [{ answer: { type: 'TEXT' } }])
+
+# Raise an RFI against a connected account — params need braces when
+# followed by opts. Fails with BadRequestError ("ongoing RFI case exists")
+# if the account already has an open RFI.
+Airwallex::RFI.simulate_create(
+  { type: 'KYC', questions: [{ answer: { type: 'TEXT' } }] },
+  headers: { 'x-on-behalf-of' => 'acct_123' }
+)
 ```
 
 #### POS Terminals
@@ -679,7 +757,8 @@ transfer = Airwallex::Transfer.create(
 
 ### Pagination
 
-Unified interface across both cursor-based and offset-based endpoints:
+Unified interface across cursor-based, offset-based, and bookmark-based (RFI) endpoints.
+Any `headers:` passed to `.list` (e.g. `x-on-behalf-of`) are kept on every page:
 
 ```ruby
 # Auto-pagination with enumerable
@@ -716,6 +795,10 @@ begin
     handle_successful_payment(event.data)
   when 'payout.transfer.failed'
     handle_failed_payout(event.data)
+  when 'funds_split.settled'
+    # funds_split.* payloads identify the split by split_id (not id) and
+    # carry no request_id — see the Scale section
+    handle_settled_split(event.data)
   end
 rescue Airwallex::SignatureVerificationError => e
   # Invalid signature
@@ -819,7 +902,7 @@ end
   - Customer (create, retrieve, list, update, delete)
   - Dispute (retrieve, list, accept, challenge, related_payment_intents, simulate_create, simulate_escalate, simulate_resolve)
 - **Payouts**:
-  - Transfer (create, retrieve, list, cancel, simulate_transition)
+  - Transfer (create, retrieve, list, cancel, simulate_transition; cancel/simulate_transition take headers: for x-on-behalf-of)
   - Beneficiary (create, retrieve, list, update, delete, validate, verify_account, api_schema, form_schema, supported_financial_institutions)
   - BatchTransfer (create, retrieve, list)
 - **Foreign Exchange & Multi-Currency**:
@@ -846,14 +929,16 @@ end
   - AccountAmendment (create, retrieve, simulate_approve, simulate_reject) - requires Admin-level API key permissions
   - AccountOffboarding — sandbox Simulation only, scoped to a parent ConnectedAccount (simulate_complete, simulate_cancel)
   - FundsSplit (create, retrieve, list, release)
+  - FundsSplitReversal (create, retrieve, list)
+  - ConnectedAccountTransfer (create, retrieve, list)
   - Charge (create, retrieve, list)
 - **Issuing** (sandbox Simulation only — no live Card/Cardholder resources yet):
   - IssuingTransaction (simulate_create with single_phase, simulate_capture, simulate_reverse, simulate_refund, simulate_notify_three_ds)
   - Cardholder (simulate_pass_review)
 - **In-Person Payments** (sandbox Simulation only):
   - POSTerminal (simulate_turn_on, simulate_turn_off, simulate_generate_activation_code, simulate_confirm_payment_intent, simulate_payment_scenarios)
-- **Compliance** (sandbox Simulation only):
-  - RFI (simulate_create, simulate_close, simulate_follow_up)
+- **Compliance**:
+  - RFI (retrieve, list, plus sandbox simulate_create, simulate_close, simulate_follow_up)
 - **Webhooks**: Event handling, HMAC-SHA256 signature verification
 
 ### Coming in Future Versions

data/lib/airwallex/list_object.rb

@@ -6,12 +6,19 @@ module Airwallex
 
     attr_reader :data, :has_more, :next_cursor
 
-    def initialize(data:, has_more:, resource_class:, next_cursor: nil, params: {})
+    # @param cursor_param [Symbol] query param the next cursor is sent as
+    #   (e.g. :page for bookmark-paginated endpoints like RFI)
+    # @param opts [Hash] the original request opts (e.g. headers:), forwarded
+    #   to every subsequent page so x-on-behalf-of etc. are kept
+    def initialize(data:, has_more:, resource_class:, next_cursor: nil, params: {}, # rubocop:disable Metrics/ParameterLists
+                   cursor_param: :next_cursor, opts: {})
       @data = data.map { |item| resource_class.new(item) }
       @has_more = has_more
       @next_cursor = next_cursor
       @resource_class = resource_class
       @params = params
+      @cursor_param = cursor_param
+      @opts = opts
     end
 
     def each(&)
@@ -49,7 +56,7 @@ module Airwallex
 
       if @next_cursor
         # Cursor-based pagination
-        next_params[:next_cursor] = @next_cursor
+        next_params[@cursor_param] = @next_cursor
       else
         # Offset-based pagination
         page_size = @params[:page_size] || @params[:limit] || 20
@@ -57,7 +64,7 @@ module Airwallex
         next_params[:offset] = current_offset + page_size
       end
 
-      @resource_class.list(next_params)
+      @opts.empty? ? @resource_class.list(next_params) : @resource_class.list(next_params, @opts)
     end
 
     # Automatically iterate through all pages

data/lib/airwallex/resources/connected_account_transfer.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Airwallex
+  # Represents a Connected Account Transfer — moves funds between the platform
+  # account and a connected account's wallet. Send x-on-behalf-of to debit a
+  # connected account instead of the platform.
+  #
+  # Statuses: NEW, PENDING, SETTLED, SUSPENDED, FAILED. Create errors include
+  # insufficient_fund and request_id_duplicate.
+  #
+  # @example Fund a connected account from the platform
+  #   transfer = Airwallex::ConnectedAccountTransfer.create(
+  #     request_id: "cat-req-123",  # required, 1-50
+  #     amount: "100.00",
+  #     currency: "AUD",
+  #     destination: "acct_123",    # connected account id
+  #     reason: "transfer_to_own_account",
+  #     reference: "Ledger top-up"  # required, 1-140
+  #   )
+  #
+  # @example List settled transfers to an account
+  #   Airwallex::ConnectedAccountTransfer.list(destination: "acct_123", status: "SETTLED")
+  class ConnectedAccountTransfer < APIResource
+    extend APIOperations::Create
+    extend APIOperations::Retrieve
+    extend APIOperations::List
+
+    # @return [String] API resource path for connected account transfers
+    def self.resource_path
+      "/api/v1/connected_account_transfers"
+    end
+  end
+end

data/lib/airwallex/resources/funds_split.rb

@@ -1,18 +1,32 @@
 # frozen_string_literal: true
 
 module Airwallex
-  # Represents a Funds Split — how a single PaymentIntent/inbound transaction
-  # is divided between the platform and a Connected Account at collection
-  # time (the Scale-product mechanism for splitting deposits).
+  # Represents a Funds Split — moves part of a PaymentIntent's funds from the
+  # platform account to a Connected Account. Each split has exactly one
+  # destination; create one split per connected account.
+  #
+  # Create errors include duplicate_request (reused request_id) and
+  # amount_above_limit (splits exceed the PaymentIntent amount).
+  #
+  # funds_split.* webhook payloads name the split split_id, not id, and carry
+  # no request_id: { split_id:, status:, amount:, currency:, source_id:,
+  # source_type:, destination:, ... }.
   #
   # @example Create a split
   #   split = Airwallex::FundsSplit.create(
-  #     payment_intent_id: intent.id,
-  #     splits: [{ account_id: connected_account.id, amount: 50.00 }]
+  #     request_id: "split-req-123",   # required, max 64
+  #     source_id: intent.id,          # required, PaymentIntent id
+  #     source_type: "PAYMENT_INTENT", # required
+  #     amount: "50.00",               # required, string
+  #     destination: connected_account.id,
+  #     auto_release: true,            # optional, default true
+  #     metadata: { order_id: "123" }  # optional
   #   )
   #
-  # @example Release the split funds
+  # @example Release the split funds (when created with auto_release: false)
   #   split.release
+  #
+  # @see FundsSplitReversal to move split funds back to the platform
   class FundsSplit < APIResource
     extend APIOperations::Create
     extend APIOperations::Retrieve

data/lib/airwallex/resources/funds_split_reversal.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Airwallex
+  # Represents a Funds Split Reversal — moves previously split funds back from
+  # the connected account (the split's destination) to the platform account.
+  # Partial reversals are allowed until the full split amount is reversed.
+  #
+  # Statuses: CREATED, RELEASED, SETTLED.
+  #
+  # @example Reverse part of a split
+  #   reversal = Airwallex::FundsSplitReversal.create(
+  #     request_id: "rev-req-123",  # required, max 64
+  #     funds_split_id: split.id,   # required
+  #     amount: "5.00",             # required, string
+  #     metadata: { reason: "refund" }
+  #   )
+  #   reversal.status # => "CREATED"
+  #
+  # @example List the reversals of a split
+  #   Airwallex::FundsSplitReversal.list(funds_split_id: split.id)
+  class FundsSplitReversal < APIResource
+    extend APIOperations::Create
+    extend APIOperations::Retrieve
+    extend APIOperations::List
+
+    # @return [String] API resource path for funds split reversals
+    def self.resource_path
+      "/api/v1/pa/funds_split_reversals"
+    end
+  end
+end

data/lib/airwallex/resources/rfi.rb

@@ -5,11 +5,31 @@ module Airwallex
   # 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
+  # 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",
@@ -17,9 +37,42 @@ module Airwallex
   #   )
   #   rfi.simulate_close
   class RFI < APIResource
-    # @return [String] API resource path for simulated RFI actions
+    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/simulation/rfis"
+      "/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
@@ -28,18 +81,20 @@ module Airwallex
     #   "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 = {})
-      response = Airwallex.client.post("#{resource_path}/create", params)
+    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)
-      response = Airwallex.client.post("#{resource_path}/#{rfi_id}/close", {})
+    def self.simulate_close(rfi_id, opts = {})
+      response = Airwallex.client.post("#{SIMULATION_PATH}/#{rfi_id}/close", {}, opts[:headers] || {})
       new(response)
     end
 
@@ -49,17 +104,19 @@ module Airwallex
     # @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 = {})
-      response = Airwallex.client.post("#{resource_path}/#{rfi_id}/follow_up", params)
+    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
-      response = Airwallex.client.post("#{self.class.resource_path}/#{id}/close", {})
+    def simulate_close(opts = {})
+      response = Airwallex.client.post("#{SIMULATION_PATH}/#{id}/close", {}, opts[:headers] || {})
       refresh_from(response)
       self
     end
@@ -67,9 +124,10 @@ module Airwallex
     # 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 = {})
-      response = Airwallex.client.post("#{self.class.resource_path}/#{id}/follow_up", params)
+    def simulate_follow_up(params = {}, opts = {})
+      response = Airwallex.client.post("#{SIMULATION_PATH}/#{id}/follow_up", params, opts[:headers] || {})
       refresh_from(response)
       self
     end

data/lib/airwallex/resources/transfer.rb

@@ -14,10 +14,14 @@ module Airwallex
     end
 
     # Cancel a pending transfer
-    def cancel
+    #
+    # @param opts [Hash] headers: (e.g. { "x-on-behalf-of" => account_id })
+    # @return [Transfer] self
+    def cancel(opts = {})
       response = Airwallex.client.post(
         "#{self.class.resource_path}/#{id}/cancel",
-        {}
+        {},
+        opts[:headers] || {}
       )
       refresh_from(response)
       self
@@ -25,18 +29,21 @@ module Airwallex
 
     # 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.
+    # step at a time (the sandbox rejects PROCESSING -> PAID with a 500
+    # operation_failed; go through SENT); 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"
+    # @param headers [Hash] e.g. { "x-on-behalf-of" => account_id } — required
+    #   for a transfer created on behalf of a connected account
     # @return [Transfer] self
-    def simulate_transition(next_status:, failure_type: nil)
+    def simulate_transition(next_status:, failure_type: nil, headers: {})
       params = { next_status: next_status }
       params[:failure_type] = failure_type if failure_type
-      response = Airwallex.client.post("#{SIMULATION_PATH}/#{id}/transition", params)
+      response = Airwallex.client.post("#{SIMULATION_PATH}/#{id}/transition", params, headers)
       refresh_from(response)
       self
     end
@@ -48,11 +55,13 @@ module Airwallex
     #   "PAID", "FAILED", "CANCELLED"
     # @param failure_type [String, nil] failure reason code, only
     #   meaningful when next_status is "FAILED"
+    # @param headers [Hash] e.g. { "x-on-behalf-of" => account_id } — required
+    #   for a transfer created on behalf of a connected account
     # @return [Transfer]
-    def self.simulate_transition(transfer_id, next_status:, failure_type: nil)
+    def self.simulate_transition(transfer_id, next_status:, failure_type: nil, headers: {})
       params = { next_status: next_status }
       params[:failure_type] = failure_type if failure_type
-      response = Airwallex.client.post("#{SIMULATION_PATH}/#{transfer_id}/transition", params)
+      response = Airwallex.client.post("#{SIMULATION_PATH}/#{transfer_id}/transition", params, headers)
       new(response)
     end
   end

data/lib/airwallex/version.rb

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

data/lib/airwallex.rb

@@ -47,6 +47,8 @@ require_relative "airwallex/resources/payment_source"
 require_relative "airwallex/resources/connected_account"
 require_relative "airwallex/resources/account_amendment"
 require_relative "airwallex/resources/funds_split"
+require_relative "airwallex/resources/funds_split_reversal"
+require_relative "airwallex/resources/connected_account_transfer"
 require_relative "airwallex/resources/charge"
 require_relative "airwallex/resources/deposit"
 require_relative "airwallex/resources/issuing_transaction"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: airwallex
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.11.0
 platform: ruby
 authors:
 - Chayut Orapinpatipat
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-09 00:00:00.000000000 Z
+date: 2026-10-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -93,11 +93,13 @@ files:
 - lib/airwallex/resources/cardholder.rb
 - lib/airwallex/resources/charge.rb
 - lib/airwallex/resources/connected_account.rb
+- lib/airwallex/resources/connected_account_transfer.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/funds_split_reversal.rb
 - lib/airwallex/resources/global_account.rb
 - lib/airwallex/resources/global_account_alias.rb
 - lib/airwallex/resources/global_account_mandate.rb
@@ -144,7 +146,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Production-grade Ruby client for the Airwallex API