jamm 2.0.0 → 2.2.0

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

@@ -25,24 +25,43 @@ module Api
 
     attr_accessor :merchant_name
 
+    # Original charge amount before discount and before any refund is applied.
     attr_accessor :initial_amount
 
+    # Discount amount deducted from the original charge amount.
     attr_accessor :discount
 
+    # Final charge amount after discount, before any refund is applied.
     attr_accessor :final_amount
 
+    # Total amount refunded for this charge when the charge has been refunded.
     attr_accessor :amount_refunded
 
     attr_accessor :currency
 
+    # Timestamp when the charge or refund outcome was completed.
     attr_accessor :processed_at
 
+    # Jamm fee associated with this refund event (refund uses refund fee; cancel uses 0).
+    attr_accessor :jamm_fee
+
     attr_accessor :created_at
 
     attr_accessor :updated_at
 
+    # Whether the original transaction's Jamm fee was waived (same-day cancel) or not (refund). Values: \"waived\", \"not_waived\".
+    attr_accessor :original_transaction_jamm_fee
+
+    # Consumption tax (10% of the Jamm fee).
+    attr_accessor :consumption_tax
+
     attr_accessor :error
 
+    # External refund identifier (rfd-*) for refund/refund-failed webhooks.
+    attr_accessor :refund_id
+
+    attr_accessor :refund
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -79,9 +98,14 @@ module Api
         :'amount_refunded' => :'amountRefunded',
         :'currency' => :'currency',
         :'processed_at' => :'processedAt',
+        :'jamm_fee' => :'jammFee',
         :'created_at' => :'createdAt',
         :'updated_at' => :'updatedAt',
-        :'error' => :'error'
+        :'original_transaction_jamm_fee' => :'originalTransactionJammFee',
+        :'consumption_tax' => :'consumptionTax',
+        :'error' => :'error',
+        :'refund_id' => :'refundId',
+        :'refund' => :'refund'
       }
     end
 
@@ -104,9 +128,14 @@ module Api
         :'amount_refunded' => :'Integer',
         :'currency' => :'String',
         :'processed_at' => :'String',
+        :'jamm_fee' => :'Integer',
         :'created_at' => :'String',
         :'updated_at' => :'String',
-        :'error' => :'Apiv1Error'
+        :'original_transaction_jamm_fee' => :'String',
+        :'consumption_tax' => :'Integer',
+        :'error' => :'Apiv1Error',
+        :'refund_id' => :'String',
+        :'refund' => :'RefundInfo'
       }
     end
 
@@ -177,6 +206,10 @@ module Api
         self.processed_at = attributes[:'processed_at']
       end
 
+      if attributes.key?(:'jamm_fee')
+        self.jamm_fee = attributes[:'jamm_fee']
+      end
+
       if attributes.key?(:'created_at')
         self.created_at = attributes[:'created_at']
       end
@@ -185,9 +218,25 @@ module Api
         self.updated_at = attributes[:'updated_at']
       end
 
+      if attributes.key?(:'original_transaction_jamm_fee')
+        self.original_transaction_jamm_fee = attributes[:'original_transaction_jamm_fee']
+      end
+
+      if attributes.key?(:'consumption_tax')
+        self.consumption_tax = attributes[:'consumption_tax']
+      end
+
       if attributes.key?(:'error')
         self.error = attributes[:'error']
       end
+
+      if attributes.key?(:'refund_id')
+        self.refund_id = attributes[:'refund_id']
+      end
+
+      if attributes.key?(:'refund')
+        self.refund = attributes[:'refund']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -221,9 +270,14 @@ module Api
           amount_refunded == o.amount_refunded &&
           currency == o.currency &&
           processed_at == o.processed_at &&
+          jamm_fee == o.jamm_fee &&
           created_at == o.created_at &&
           updated_at == o.updated_at &&
-          error == o.error
+          original_transaction_jamm_fee == o.original_transaction_jamm_fee &&
+          consumption_tax == o.consumption_tax &&
+          error == o.error &&
+          refund_id == o.refund_id &&
+          refund == o.refund
     end
 
     # @see the `==` method
@@ -235,7 +289,7 @@ module Api
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, customer, status, description, merchant_name, initial_amount, discount, final_amount, amount_refunded, currency, processed_at, created_at, updated_at, error].hash
+      [id, customer, status, description, merchant_name, initial_amount, discount, final_amount, amount_refunded, currency, processed_at, jamm_fee, created_at, updated_at, original_transaction_jamm_fee, consumption_tax, error, refund_id, refund].hash
     end
 
     # Builds the object from hash

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

@@ -21,9 +21,10 @@ module Api
     WAITING_EKYC = "STATUS_WAITING_EKYC".freeze
     BLOCKING = "STATUS_BLOCKING".freeze
     CANCELLED = "STATUS_CANCELLED".freeze
+    REFUNDED = "STATUS_REFUNDED".freeze
 
     def self.all_vars
-      @all_vars ||= [UNSPECIFIED, SUCCESS, FAILURE, WAITING_EKYC, BLOCKING, CANCELLED].freeze
+      @all_vars ||= [UNSPECIFIED, SUCCESS, FAILURE, WAITING_EKYC, BLOCKING, CANCELLED, REFUNDED].freeze
     end
 
     # Builds the enum from string

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

@@ -50,6 +50,8 @@ module Api
 
     attr_accessor :charge_status
 
+    attr_accessor :error
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -90,7 +92,8 @@ module Api
         :'created_at' => :'createdAt',
         :'updated_at' => :'updatedAt',
         :'processed_at' => :'processedAt',
-        :'charge_status' => :'chargeStatus'
+        :'charge_status' => :'chargeStatus',
+        :'error' => :'error'
       }
     end
 
@@ -117,7 +120,8 @@ module Api
         :'created_at' => :'Time',
         :'updated_at' => :'Time',
         :'processed_at' => :'Time',
-        :'charge_status' => :'ChargeStatus'
+        :'charge_status' => :'ChargeStatus',
+        :'error' => :'ChargeError'
       }
     end
 
@@ -209,6 +213,10 @@ module Api
       else
         self.charge_status = 'CHARGE_STATUS_UNSPECIFIED'
       end
+
+      if attributes.key?(:'error')
+        self.error = attributes[:'error']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -246,7 +254,8 @@ module Api
           created_at == o.created_at &&
           updated_at == o.updated_at &&
           processed_at == o.processed_at &&
-          charge_status == o.charge_status
+          charge_status == o.charge_status &&
+          error == o.error
     end
 
     # @see the `==` method
@@ -258,7 +267,7 @@ module Api
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [charge_id, paid, reason, description, merchant_name, initial_amount, discount, final_amount, amount_refunded, currency, token_id, metadata, created_at, updated_at, processed_at, charge_status].hash
+      [charge_id, paid, reason, description, merchant_name, initial_amount, discount, final_amount, amount_refunded, currency, token_id, metadata, created_at, updated_at, processed_at, charge_status, error].hash
     end
 
     # Builds the object from hash

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

@@ -35,6 +35,8 @@ module Api
     PAYMENT_CHARGE_SUBSCRIPTION_EXPIRED = "ERROR_TYPE_PAYMENT_CHARGE_SUBSCRIPTION_EXPIRED".freeze
     PAYMENT_LINK_EXPIRED = "ERROR_TYPE_PAYMENT_LINK_EXPIRED".freeze
     PAYMENT_CHARGE_INSUFFICIENT_FUNDS = "ERROR_TYPE_PAYMENT_CHARGE_INSUFFICIENT_FUNDS".freeze
+    PAYMENT_CUSTOMER_NOT_FOUND = "ERROR_TYPE_PAYMENT_CUSTOMER_NOT_FOUND".freeze
+    PAYMENT_CUSTOMER_INACTIVE = "ERROR_TYPE_PAYMENT_CUSTOMER_INACTIVE".freeze
     CSV_VALIDATION_FAILED = "ERROR_TYPE_CSV_VALIDATION_FAILED".freeze
     CSV_TOTP_REQUIRED = "ERROR_TYPE_CSV_TOTP_REQUIRED".freeze
     CSV_TOTP_INVALID = "ERROR_TYPE_CSV_TOTP_INVALID".freeze
@@ -52,7 +54,7 @@ module Api
     TOTP_DISABLE_FAILED = "ERROR_TYPE_TOTP_DISABLE_FAILED".freeze
 
     def self.all_vars
-      @all_vars ||= [UNSPECIFIED, AUTH_FAILED, AUTH_REJECTED, ACCOUNT_CREATION_FAILED, ACCOUNT_MODIFICATION_FAILED, ACCOUNT_DELETION_FAILED, ACCOUNT_BANK_REGISTRATION_FAILED, KYC_REJECTED, NOTIFICATION_WEBHOOK_FAILED, NOTIFICATION_EMAIL_FAILED, NOTIFICATION_SMS_FAILED, PAYMENT_GATEWAY_UNAVAILABLE, PAYMENT_GATEWAY_FAILED, PAYMENT_VALIDATION_FAILED, PAYMENT_CHARGE_FAILED, PAYMENT_CHARGE_REJECTED, PAYMENT_CHARGE_OVER_LIMIT, PAYMENT_CHARGE_SUBSCRIPTION_EXPIRED, PAYMENT_LINK_EXPIRED, PAYMENT_CHARGE_INSUFFICIENT_FUNDS, CSV_VALIDATION_FAILED, CSV_TOTP_REQUIRED, CSV_TOTP_INVALID, CSV_TOTP_EXPIRED, CSV_TOTP_LOCKED, CSV_BATCH_TOO_LARGE, CSV_CUSTOMER_NOT_FOUND, CSV_PROCESSING_FAILED, CSV_CHALLENGE_NOT_FOUND, CSV_DUPLICATE_USER, TOTP_SETUP_FAILED, TOTP_ALREADY_ENABLED, TOTP_NOT_ENABLED, TOTP_SETUP_INVALID, TOTP_DISABLE_FAILED].freeze
+      @all_vars ||= [UNSPECIFIED, AUTH_FAILED, AUTH_REJECTED, ACCOUNT_CREATION_FAILED, ACCOUNT_MODIFICATION_FAILED, ACCOUNT_DELETION_FAILED, ACCOUNT_BANK_REGISTRATION_FAILED, KYC_REJECTED, NOTIFICATION_WEBHOOK_FAILED, NOTIFICATION_EMAIL_FAILED, NOTIFICATION_SMS_FAILED, PAYMENT_GATEWAY_UNAVAILABLE, PAYMENT_GATEWAY_FAILED, PAYMENT_VALIDATION_FAILED, PAYMENT_CHARGE_FAILED, PAYMENT_CHARGE_REJECTED, PAYMENT_CHARGE_OVER_LIMIT, PAYMENT_CHARGE_SUBSCRIPTION_EXPIRED, PAYMENT_LINK_EXPIRED, PAYMENT_CHARGE_INSUFFICIENT_FUNDS, PAYMENT_CUSTOMER_NOT_FOUND, PAYMENT_CUSTOMER_INACTIVE, CSV_VALIDATION_FAILED, CSV_TOTP_REQUIRED, CSV_TOTP_INVALID, CSV_TOTP_EXPIRED, CSV_TOTP_LOCKED, CSV_BATCH_TOO_LARGE, CSV_CUSTOMER_NOT_FOUND, CSV_PROCESSING_FAILED, CSV_CHALLENGE_NOT_FOUND, CSV_DUPLICATE_USER, TOTP_SETUP_FAILED, TOTP_ALREADY_ENABLED, TOTP_NOT_ENABLED, TOTP_SETUP_INVALID, TOTP_DISABLE_FAILED].freeze
     end
 
     # Builds the enum from string

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

@@ -20,13 +20,14 @@ module Api
     CHARGE_UPDATED = "EVENT_TYPE_CHARGE_UPDATED".freeze
     CHARGE_SUCCESS = "EVENT_TYPE_CHARGE_SUCCESS".freeze
     CHARGE_FAIL = "EVENT_TYPE_CHARGE_FAIL".freeze
-    CHARGE_REFUND = "EVENT_TYPE_CHARGE_REFUND".freeze
+    REFUND_SUCCEEDED = "EVENT_TYPE_REFUND_SUCCEEDED".freeze
+    REFUND_FAILED = "EVENT_TYPE_REFUND_FAILED".freeze
     CONTRACT_ACTIVATED = "EVENT_TYPE_CONTRACT_ACTIVATED".freeze
     USER_ACCOUNT_DELETED = "EVENT_TYPE_USER_ACCOUNT_DELETED".freeze
     TESTING = "EVENT_TYPE_TESTING".freeze
 
     def self.all_vars
-      @all_vars ||= [UNSPECIFIED, CHARGE_CREATED, CHARGE_UPDATED, CHARGE_SUCCESS, CHARGE_FAIL, CHARGE_REFUND, CONTRACT_ACTIVATED, USER_ACCOUNT_DELETED, TESTING].freeze
+      @all_vars ||= [UNSPECIFIED, CHARGE_CREATED, CHARGE_UPDATED, CHARGE_SUCCESS, CHARGE_FAIL, REFUND_SUCCEEDED, REFUND_FAILED, CONTRACT_ACTIVATED, USER_ACCOUNT_DELETED, TESTING].freeze
     end
 
     # Builds the enum from string

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

@@ -19,12 +19,15 @@ module Api
     # Amount of the charge in Japanese Yen. The amount must be the total price of the product/service including tax.  決済金額。日本円で指定してください。 金額は商品/サービスの合計金額 (税込) を指定してください。  @gotags: validate:\"gte=1,lte=500000\"
     attr_accessor :price
 
-    # Description is an arbitrary string for merchant to track the charge. This information is displayed on Merchant Dashboard.  決済の説明。ショップが決済を追跡するための任意の文字列です。  @gotags: validate:\"required\"
+    # Description is an arbitrary string for merchant to track the charge. This information is displayed on Merchant Dashboard.  決済の説明。ショップが決済を追跡するための任意の文字列です。  @gotags: validate:\"required,max=1024\"
     attr_accessor :description
 
-    # Arbitrary key-value additional information about the charge. You can see this information in our merchant dashboard.  Chargeに関する任意のキーと値の追加情報。 加盟店ダッシュボードで確認できます。
+    # Arbitrary key-value additional information about the charge. You can see this information in our merchant dashboard.  ## Testing with triggerError  Set the key \"triggerError\" to a valid ERROR_TYPE_* enum name (e.g. \"ERROR_TYPE_PAYMENT_CHARGE_FAILED\") to simulate a payment failure. Behavior differs by flow:  Off-session (Withdraw, WithdrawAsync, OffSessionPayment, OffSessionPaymentAsync):   Reads triggerError from this field (charge.metadata).   Creates a failed transaction record and sends a failure webhook.   Returns transport-level 400 for ERROR_TYPE_PAYMENT_VALIDATION_FAILED,   500 for all other ERROR_TYPE_* values.  On-session (InitiatePayment / ApprovePayment — consumer-facing core service):   Reads triggerError from the payment's stored metadata (charge or merchant-customer).   Initiate stage: only ERROR_TYPE_PAYMENT_VALIDATION_FAILED and     ERROR_TYPE_PAYMENT_LINK_EXPIRED are honored; other types are ignored.     No failed transaction or webhook is created. Returns 200 OK with     an embedded InitiatePaymentError payload.   Approve stage: all ERROR_TYPE_* values are honored.     Creates workflow-specific failure records (cancelled contract and/or     failed transaction depending on the workflow type). Returns 200 OK with     an embedded ApprovePaymentError payload.  Note: CreateContractWithoutCharge has no charge, so this field does not apply. On-session triggerError for that flow is read from merchant-customer metadata instead.  ## Error types by payment stage  Initiate (payment session setup, workflow creation):   - ERROR_TYPE_PAYMENT_VALIDATION_FAILED  — invalid request   - ERROR_TYPE_PAYMENT_LINK_EXPIRED       — payment link expired  Approve (pre-charge validation + BankPay charge execution):   - ERROR_TYPE_PAYMENT_VALIDATION_FAILED  — invalid request (e.g. deleted/inactive customer)   - ERROR_TYPE_PAYMENT_CHARGE_REJECTED    — KYC not approved   - ERROR_TYPE_PAYMENT_CHARGE_OVER_LIMIT  — charge exceeds bank quota   - ERROR_TYPE_PAYMENT_LINK_EXPIRED       — payment link expired   - ERROR_TYPE_PAYMENT_GATEWAY_UNAVAILABLE — BankPay/bank under maintenance   - ERROR_TYPE_PAYMENT_CHARGE_INSUFFICIENT_FUNDS — insufficient funds in customer's account   - ERROR_TYPE_PAYMENT_GATEWAY_FAILED     — BankPay rejected the charge   - ERROR_TYPE_PAYMENT_CHARGE_FAILED      — generic charge failure (internal, not found, etc.)  Chargeに関する任意のキーと値の追加情報。 加盟店ダッシュボードで確認できます。  テスト環境では、\"triggerError\" キーに ERROR_TYPE_* の列挙名を設定すると 決済エラーをシミュレートできます。動作はフローによって異なります。 詳細は上記の英語コメントを参照してください。
     attr_accessor :metadata
 
+    # Fee charged by the platform (in JPY). Must be >= the Jamm fee for the merchant. Only meaningful when the caller is a platform. Ignored for direct merchant calls.  プラットフォームが徴収する手数料（日本円）。加盟店のJamm手数料以上である必要があります。
+    attr_accessor :platform_fee
+
     # Merchant can optionally set the expiry date for the payment. Defaults to 90 minutes if not specified.  決済の有効期限。未指定の場合は90分後に自動失効します。
     attr_accessor :expires_at
 
@@ -34,6 +37,7 @@ module Api
         :'price' => :'price',
         :'description' => :'description',
         :'metadata' => :'metadata',
+        :'platform_fee' => :'platformFee',
         :'expires_at' => :'expiresAt'
       }
     end
@@ -49,6 +53,7 @@ module Api
         :'price' => :'Integer',
         :'description' => :'String',
         :'metadata' => :'Hash<String, String>',
+        :'platform_fee' => :'Integer',
         :'expires_at' => :'Time'
       }
     end
@@ -88,6 +93,10 @@ module Api
         end
       end
 
+      if attributes.key?(:'platform_fee')
+        self.platform_fee = attributes[:'platform_fee']
+      end
+
       if attributes.key?(:'expires_at')
         self.expires_at = attributes[:'expires_at']
       end
@@ -116,6 +125,7 @@ module Api
           price == o.price &&
           description == o.description &&
           metadata == o.metadata &&
+          platform_fee == o.platform_fee &&
           expires_at == o.expires_at
     end
 
@@ -128,7 +138,7 @@ module Api
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [price, description, metadata, expires_at].hash
+      [price, description, metadata, platform_fee, expires_at].hash
     end
 
     # Builds the object from hash

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

@@ -23,13 +23,16 @@ module Api
 
     attr_accessor :user_account_message
 
+    attr_accessor :refund_info
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'merchant_webhook_message' => :'merchantWebhookMessage',
         :'charge_message' => :'chargeMessage',
         :'contract_message' => :'contractMessage',
-        :'user_account_message' => :'userAccountMessage'
+        :'user_account_message' => :'userAccountMessage',
+        :'refund_info' => :'refundInfo'
       }
     end
 
@@ -44,7 +47,8 @@ module Api
         :'merchant_webhook_message' => :'MerchantWebhookMessage',
         :'charge_message' => :'ChargeMessage',
         :'contract_message' => :'ContractMessage',
-        :'user_account_message' => :'UserAccountMessage'
+        :'user_account_message' => :'UserAccountMessage',
+        :'refund_info' => :'RefundInfo'
       }
     end
 
@@ -84,6 +88,10 @@ module Api
       if attributes.key?(:'user_account_message')
         self.user_account_message = attributes[:'user_account_message']
       end
+
+      if attributes.key?(:'refund_info')
+        self.refund_info = attributes[:'refund_info']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -109,7 +117,8 @@ module Api
           merchant_webhook_message == o.merchant_webhook_message &&
           charge_message == o.charge_message &&
           contract_message == o.contract_message &&
-          user_account_message == o.user_account_message
+          user_account_message == o.user_account_message &&
+          refund_info == o.refund_info
     end
 
     # @see the `==` method
@@ -121,7 +130,7 @@ module Api
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [merchant_webhook_message, charge_message, contract_message, user_account_message].hash
+      [merchant_webhook_message, charge_message, contract_message, user_account_message, refund_info].hash
     end
 
     # Builds the object from hash

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

@@ -14,17 +14,21 @@ require 'date'
 require 'time'
 
 module Api
-  # This message represents a request to process an off-session payment asynchronously. It contains the customer ID and the amount to charge.
+  # This message represents a request to process an off-session payment asynchronously. It contains the customer ID and the amount to charge. Supports triggerError in charge.metadata for test error simulation. See InitialCharge.metadata.
   class OffSessionPaymentAsyncRequest
     attr_accessor :customer
 
     attr_accessor :charge
 
+    # Merchant-supplied idempotency key for retry safety. When present, a retry with the same (merchant, idempotency_key) returns the original charge instead of creating a new one. When absent (empty), the server generates a UUID per call (current behavior). ASCII only, 1-255 chars matching ^[a-zA-Z0-9_\\-]{1,255}$.
+    attr_accessor :idempotency_key
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'customer' => :'customer',
-        :'charge' => :'charge'
+        :'charge' => :'charge',
+        :'idempotency_key' => :'idempotencyKey'
       }
     end
 
@@ -37,7 +41,8 @@ module Api
     def self.openapi_types
       {
         :'customer' => :'String',
-        :'charge' => :'InitialCharge'
+        :'charge' => :'InitialCharge',
+        :'idempotency_key' => :'String'
       }
     end
 
@@ -69,6 +74,10 @@ module Api
       if attributes.key?(:'charge')
         self.charge = attributes[:'charge']
       end
+
+      if attributes.key?(:'idempotency_key')
+        self.idempotency_key = attributes[:'idempotency_key']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -92,7 +101,8 @@ module Api
       return true if self.equal?(o)
       self.class == o.class &&
           customer == o.customer &&
-          charge == o.charge
+          charge == o.charge &&
+          idempotency_key == o.idempotency_key
     end
 
     # @see the `==` method
@@ -104,7 +114,7 @@ module Api
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [customer, charge].hash
+      [customer, charge, idempotency_key].hash
     end
 
     # Builds the object from hash

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

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module Api
-  # This message represents a request to process a payment directly within the application. It contains the customer ID and charge details to be processed.
+  # This message represents a request to process a payment directly within the application. It contains the customer ID and charge details to be processed. Supports triggerError in charge.metadata for test error simulation. See InitialCharge.metadata.
   class OffSessionPaymentRequest
     attr_accessor :customer
 

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

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module Api
-  # Request message for the unified payment interface. The system intelligently routes the request to the appropriate payment method based on the provided parameters.
+  # Request message for the unified payment interface. The system intelligently routes the request to the appropriate payment method based on the provided parameters. Supports triggerError for test error simulation via the core InitiatePayment/ApprovePayment flow. See InitialCharge.metadata for details on behavior differences by stage.
   class OnSessionPaymentRequest
     attr_accessor :customer