airwallex 0.3.0 → 0.7.0

data/lib/airwallex/resources/payment_method.rb

@@ -6,6 +6,11 @@ module Airwallex
   # Payment methods allow you to store customer payment credentials securely
   # and reuse them for future payments without collecting details again.
   #
+  # Note: raw card tokenization via .create requires PCI-scoped "Native API"
+  # account access, which isn't enabled by default — if your account isn't
+  # provisioned for it, collect cards via Airwallex's hosted checkout or
+  # Embedded Elements instead.
+  #
   # @example Create a card payment method
   #   pm = Airwallex::PaymentMethod.create(
   #     type: "card",
@@ -26,24 +31,27 @@ module Airwallex
   #
   # @example Update billing details
   #   pm.update(billing: { address: { postal_code: "10001" } })
+  #
+  # @example Disable a payment method
+  #   pm.disable
   class PaymentMethod < APIResource
     extend APIOperations::Create
     extend APIOperations::Retrieve
     extend APIOperations::List
-    extend APIOperations::Update
     include APIOperations::Update
-    extend APIOperations::Delete
 
     # @return [String] API resource path for payment methods
     def self.resource_path
       "/api/v1/pa/payment_methods"
     end
 
-    # Detach this payment method from its customer
+    # Disable this payment method (Airwallex has no delete/detach endpoint;
+    # disabling is the real lifecycle operation and preserves history)
     #
+    # @param params [Hash] additional params
     # @return [PaymentMethod] self
-    def detach
-      response = Airwallex.client.post("#{self.class.resource_path}/#{id}/detach", {})
+    def disable(params = {})
+      response = Airwallex.client.post("#{self.class.resource_path}/#{id}/disable", params)
       refresh_from(response)
       self
     end

data/lib/airwallex/resources/payment_source.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Airwallex
+  # Represents a Billing Payment Source — the object a BillingSubscription's
+  # payment_source_id actually references. NOT the same object as
+  # PaymentConsent (/pa/payment_consents).
+  #
+  # external_id is the id of a PaymentMethod (/pa/payment_methods), not a
+  # PaymentConsent's own id. The PaymentConsent is still part of the flow —
+  # it's what authorizes that PaymentMethod for merchant-initiated
+  # (unscheduled) charges — but the id PaymentSource wants is the underlying
+  # PaymentMethod's.
+  #
+  # @example Full flow: PaymentMethod -> PaymentConsent -> PaymentSource -> BillingSubscription
+  #   payment_method = Airwallex::PaymentMethod.create(
+  #     customer_id: customer.id,
+  #     type: "card",
+  #     card: { ... } # a real test card in sandbox
+  #   )
+  #
+  #   consent = Airwallex::PaymentConsent.create(
+  #     customer_id: customer.id,
+  #     payment_method: { id: payment_method.id },
+  #     next_triggered_by: "merchant",
+  #     merchant_trigger_reason: "unscheduled"
+  #   )
+  #   consent.verify(...)
+  #
+  #   source = Airwallex::PaymentSource.create(
+  #     billing_customer_id: billing_customer.id,
+  #     external_id: payment_method.id,
+  #     linked_payment_account_id: connected_account.id
+  #   )
+  #
+  #   Airwallex::BillingSubscription.create(
+  #     billing_customer_id: billing_customer.id,
+  #     legal_entity_id: connected_account.legal_entity_id,
+  #     collection_method: "AUTO_CHARGE",
+  #     payment_source_id: source.id,
+  #     items: [{ price_id: price.id, quantity: 1 }]
+  #   )
+  class PaymentSource < APIResource
+    extend APIOperations::Create
+    extend APIOperations::Retrieve
+    extend APIOperations::List
+
+    # @return [String] API resource path for billing payment sources
+    def self.resource_path
+      "/api/v1/billing/payment_sources"
+    end
+  end
+end

data/lib/airwallex/resources/quote.rb

@@ -3,14 +3,16 @@
 module Airwallex
   # Quote resource for locked exchange rates
   #
-  # Create quotes to lock exchange rates for a short period (typically 30-60 seconds).
-  # Use quotes to guarantee the rate when executing conversions.
+  # Create quotes to lock exchange rates for a period you choose (validity:
+  # MIN_1 through HR_24 — see .create). Use quotes to guarantee the rate when
+  # executing conversions.
   #
   # @example Create a quote
   #   quote = Airwallex::Quote.create(
   #     buy_currency: 'EUR',
   #     sell_currency: 'USD',
-  #     sell_amount: 1000.00
+  #     sell_amount: 1000.00,
+  #     validity: "MIN_1"
   #   )
   #   puts "Locked rate: #{quote.client_rate}, expires: #{quote.expires_at}"
   #

data/lib/airwallex/resources/rate.rb

@@ -10,15 +10,10 @@ module Airwallex
   #   rate = Airwallex::Rate.retrieve(buy_currency: 'EUR', sell_currency: 'USD')
   #   puts "1 USD = #{rate.client_rate} EUR"
   #
-  # @example Get multiple rates (Note: API may not support multiple at once)
-  #   rate = Airwallex::Rate.retrieve(
-  #     buy_currency: 'EUR',
-  #     sell_currency: 'USD'
-  #   )
-  #
+  # There is no .list — /fx/rates/current always returns the rate for one
+  # specific currency pair, not a collection.
   class Rate < APIResource
     extend APIOperations::Retrieve
-    extend APIOperations::List
 
     def self.resource_path
       "/api/v1/fx/rates/current"

data/lib/airwallex/version.rb

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

data/lib/airwallex/webhook.rb

@@ -5,6 +5,8 @@ require "openssl"
 module Airwallex
   module Webhook
     DEFAULT_TOLERANCE = 300 # 5 minutes
+    # Timestamps below this are seconds, at/above are milliseconds. Valid until year 2286.
+    MS_THRESHOLD = 10_000_000_000
 
     module_function
 
@@ -37,6 +39,8 @@ module Airwallex
     def verify_timestamp(timestamp, tolerance)
       current_time = Time.now.to_i
       timestamp_int = timestamp.to_i
+      # Airwallex sends x-timestamp in milliseconds; normalize to seconds before comparing.
+      timestamp_int /= 1000 if timestamp_int > MS_THRESHOLD
 
       if (current_time - timestamp_int).abs > tolerance
         raise SignatureVerificationError, "Timestamp outside tolerance (#{tolerance}s)"
@@ -54,11 +58,11 @@ module Airwallex
     private_class_method :compute_signature, :verify_timestamp, :secure_compare
 
     class Event
-      attr_reader :id, :type, :data, :created_at
+      attr_reader :id, :name, :data, :created_at
 
       def initialize(attributes = {})
         @id = attributes["id"]
-        @type = attributes["type"]
+        @name = attributes["name"]
         @data = attributes["data"]
         @created_at = attributes["created_at"]
       end

data/lib/airwallex.rb

@@ -26,6 +26,7 @@ require_relative "airwallex/resources/transfer"
 require_relative "airwallex/resources/beneficiary"
 require_relative "airwallex/resources/refund"
 require_relative "airwallex/resources/payment_method"
+require_relative "airwallex/resources/payment_consent"
 require_relative "airwallex/resources/customer"
 require_relative "airwallex/resources/batch_transfer"
 require_relative "airwallex/resources/dispute"
@@ -33,6 +34,20 @@ require_relative "airwallex/resources/rate"
 require_relative "airwallex/resources/quote"
 require_relative "airwallex/resources/conversion"
 require_relative "airwallex/resources/balance"
+require_relative "airwallex/resources/global_account"
+require_relative "airwallex/resources/global_account_transaction"
+require_relative "airwallex/resources/global_account_alias"
+require_relative "airwallex/resources/global_account_mandate"
+require_relative "airwallex/resources/billing_product"
+require_relative "airwallex/resources/billing_price"
+require_relative "airwallex/resources/billing_customer"
+require_relative "airwallex/resources/billing_subscription"
+require_relative "airwallex/resources/billing_subscription_item"
+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/charge"
 
 module Airwallex
   class << self

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: airwallex
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Chayut Orapinpatipat
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-11-25 00:00:00.000000000 Z
+date: 2026-08-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -80,14 +80,29 @@ files:
 - lib/airwallex/list_object.rb
 - lib/airwallex/middleware/auth_refresh.rb
 - lib/airwallex/middleware/idempotency.rb
+- lib/airwallex/resources/account_amendment.rb
 - lib/airwallex/resources/balance.rb
 - lib/airwallex/resources/batch_transfer.rb
 - lib/airwallex/resources/beneficiary.rb
+- lib/airwallex/resources/billing_customer.rb
+- lib/airwallex/resources/billing_price.rb
+- lib/airwallex/resources/billing_product.rb
+- lib/airwallex/resources/billing_subscription.rb
+- lib/airwallex/resources/billing_subscription_item.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/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/payment_consent.rb
 - lib/airwallex/resources/payment_intent.rb
 - lib/airwallex/resources/payment_method.rb
+- lib/airwallex/resources/payment_source.rb
 - lib/airwallex/resources/quote.rb
 - lib/airwallex/resources/rate.rb
 - lib/airwallex/resources/refund.rb
@@ -122,7 +137,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
+rubygems_version: 3.5.16
 signing_key:
 specification_version: 4
 summary: Production-grade Ruby client for the Airwallex API