checkout_sdk 2.7.0 → 2.8.0

data/lib/checkout_sdk/payments/payout_request.rb

@@ -2,26 +2,80 @@
 
 module CheckoutSdk
   module Payments
+    # A card payout or bank payout request, sent to POST /payments.
+    #
     # @!attribute source
+    #   The source of the payout. For bank payouts, the source from which the payout is funded.
+    #   [Required]
     #   @return [PayoutSource]
     # @!attribute destination
+    #   The destination of the payout.
+    #   You can encrypt this field by using the Cko-Encryption-Key-Id and Cko-Encrypted-Properties headers.
+    #   Card payouts take {CardDestination}, {NetworkTokenDestination}, {IdDestination} or {TokenDestination};
+    #   bank payouts take {IdDestination} or {BankAccountDestination}.
+    #   [Required]
     #   @return [Destination]
     # @!attribute amount
+    #   The amount to pay out, in minor units.
+    #   [Optional] for card payouts, [Required] for bank payouts
+    #   min 0
     #   @return [Integer]
     # @!attribute currency
+    #   The three-letter ISO 4217 code for the currency you want to pay out to the recipient.
+    #   For bank payouts, it should match the currency of the destination account.
+    #   [Required]
+    #   min 3 characters, max 3 characters for bank payouts
     #   @return [String] {CheckoutSdk::Common::Currency}
     # @!attribute reference
+    #   A custom reference to identify the payout. For example, an order number.
+    #   [Optional]
+    #   max 50 characters for card payouts
     #   @return [String]
     # @!attribute billing_descriptor
+    #   The billing descriptor for bank payouts. Beneficiary banks typically construct it using the
+    #   billing descriptor reference and the sender information.
+    #   [Required] for bank payouts, not used by card payouts
     #   @return [PayoutBillingDescriptor]
     # @!attribute sender
+    #   The sender of the payout. Required for money transfer card payouts. For bank payouts, the
+    #   ultimate sender of the payout, that is, your customer; not supported for Platform or Direct
+    #   Seller Checkout.com clients.
+    #   [Optional]
     #   @return [Sender]
     # @!attribute instruction
+    #   Additional details about the payout instruction.
+    #   [Required] for card payouts, [Optional] for bank payouts
     #   @return [PaymentInstruction]
     # @!attribute processing_channel_id
+    #   The unique identifier for the processing channel.
+    #   [Required]
+    #   ^(pc)_(\w{26})$
+    #   29 characters (min 29, max 29) for card payouts only
     #   @return [String]
     # @!attribute metadata
+    #   Stores additional information about the transaction with custom fields. Card payouts only.
+    #   [Optional]
     #   @return [Hash{String => Object}]
+    # @!attribute segment
+    #   The dimension details about business segment for payment request. At least one dimension required.
+    #   [Optional]
+    #   @return [PaymentSegment]
+    # @!attribute items
+    #   The order's line items. Card payouts only.
+    #   [Optional]
+    #   @return [Array(CardPayoutItem)]
+    # @!attribute previous_payment_id
+    #   The identifier of an existing payment from the recurring series, if the payout is a recurring
+    #   payment that uses stored card details. If the card payout is linked to a previous Account
+    #   Funding Transaction (AFT), include the previous payment's ID when Checkout.com processed the
+    #   AFT, or the scheme's transaction ID when another payment service provider processed it.
+    #   Card payouts only.
+    #   [Optional]
+    #   @return [String]
+    # @!attribute processing
+    #   Information related to the processing of the payout. Card payouts only.
+    #   [Optional]
+    #   @return [CardPayoutProcessing]
     class PayoutRequest
       attr_accessor :source,
                     :destination,
@@ -32,7 +86,11 @@ module CheckoutSdk
                     :sender,
                     :instruction,
                     :processing_channel_id,
-                    :metadata
+                    :metadata,
+                    :segment,
+                    :items,
+                    :previous_payment_id,
+                    :processing
     end
   end
 end

data/lib/checkout_sdk/payments/sender/corporate_sender.rb

@@ -2,15 +2,34 @@
 
 module CheckoutSdk
   module Payments
+    # A corporate sender, with type corporate. Used by card payouts, bank payouts and regular payments.
+    # The reference is inherited from {Sender}.
+    #
     # @!attribute company_name
+    #   The sender's company name. For card payouts, this must be a valid legal name: a single character or
+    #   all non-alphabetic characters return a field validation error.
+    #   [Required]
+    #   max 35 characters for card payouts
     #   @return [String]
     # @!attribute address
+    #   The sender's address. For card payouts, the residential address of an individual sender or the
+    #   registered corporate address of a corporate or government sender.
+    #   [Required]
     #   @return [CheckoutSdk::Common::Address]
     # @!attribute reference_type
+    #   The type of identifier used as the reference. Card payouts only.
+    #   [Required] for card payouts
+    #   Enum: "other"
     #   @return [String]
     # @!attribute source_of_funds
+    #   The source of the funds used to fund the card payout. Card payouts only.
+    #   [Required] for card payouts
+    #   Enum: "credit" "debit" "prepaid" "deposit_account" "mobile_money_account" "cash"
     #   @return [String] {SourceOfFunds}
     # @!attribute identification
+    #   The sender's identification. For card payouts, required if the card's issuer_country is one of AR, BR,
+    #   CO or PE.
+    #   [Optional] Card payouts only.
     #   @return [CheckoutSdk::Common::AccountHolderIdentification]
     class CorporateSender < Sender
       attr_accessor :company_name,

data/lib/checkout_sdk/payments/sender/government_sender.rb

@@ -2,17 +2,38 @@
 
 module CheckoutSdk
   module Payments
+    # A government sender, with type government. Card payouts only.
+    #
     # @!attribute company_name
+    #   The sender's company name. This must be a valid legal name: a single character or all non-alphabetic
+    #   characters return a field validation error.
+    #   [Required]
+    #   max 35 characters
     #   @return [String]
     # @!attribute address
+    #   The sender's registered corporate address.
+    #   [Required]
     #   @return [CheckoutSdk::Common::Address]
     # @!attribute reference
+    #   The unique identifier for the sender, for example a customer number. Only alphanumeric characters
+    #   are supported.
+    #   [Required]
+    #   min 5 characters
+    #   max 15 characters
     #   @return [String]
     # @!attribute reference_type
+    #   The type of identifier used as the reference.
+    #   [Required]
+    #   Enum: "other"
     #   @return [String]
     # @!attribute source_of_funds
+    #   The source of the funds used to fund the card payout.
+    #   [Required]
+    #   Enum: "credit" "debit" "prepaid" "deposit_account" "mobile_money_account" "cash"
     #   @return [String] {SourceOfFunds}
     # @!attribute identification
+    #   The sender's identification. Required if the card's issuer_country is one of AR, BR, CO or PE.
+    #   [Optional]
     #   @return [CheckoutSdk::Common::AccountHolderIdentification]
     class GovernmentSender < Sender
       attr_accessor :company_name,

data/lib/checkout_sdk/payments/sender/individual_sender.rb

@@ -2,29 +2,75 @@
 
 module CheckoutSdk
   module Payments
+    # An individual sender, with type individual. Used by card payouts, bank payouts and regular payments.
+    #
     # @!attribute first_name
+    #   The sender's legal first name. For card payouts, the combination of first_name, middle_name and
+    #   last_name should exceed 3 letters in length, and a single character or all non-alphabetic
+    #   characters return a field validation error.
+    #   [Required]
+    #   max 50 characters for card payouts
     #   @return [String]
     # @!attribute middle_name
+    #   The sender's middle name. Card payouts only.
+    #   [Optional]
+    #   max 50 characters
     #   @return [String]
     # @!attribute last_name
+    #   The sender's legal last name. For card payouts, the combination of first_name, middle_name and
+    #   last_name must exceed 3 letters in length, and a single character or all non-alphabetic characters
+    #   return a field validation error.
+    #   [Required]
+    #   max 50 characters for card payouts
     #   @return [String]
     # @!attribute dob
+    #   The sender's date of birth in a YYYY-MM-DD format. Strongly recommended where available. Bank
+    #   payouts only; card payouts and regular payments use date_of_birth.
+    #   [Optional]
+    #   max 10 characters
     #   @return [String]
     # @!attribute address
+    #   The sender's address. For card payouts, the sender's residential address.
+    #   [Required]
     #   @return [CheckoutSdk::Common::Address]
     # @!attribute identification
+    #   The sender's identification. For card payouts, required if the card's issuer_country is one of AR, BR,
+    #   CO or PE.
+    #   [Optional]
     #   @return [CheckoutSdk::Common::AccountHolderIdentification]
     # @!attribute reference
+    #   For card payouts, the unique identifier for the sender, for example a customer number; only
+    #   alphanumeric characters are supported. For bank payouts, a unique reference to the underlying
+    #   client's customer, a global KYC requirement. For regular payments, the unique reference for the
+    #   sender of the payment.
+    #   [Required] for card payouts and bank payouts, [Optional] for regular payments
+    #   min 5 characters, max 15 characters for card payouts
     #   @return [String]
     # @!attribute reference_type
+    #   The type of identifier used as the reference. Card payouts only.
+    #   [Required] for card payouts
+    #   Enum: "other"
     #   @return [String]
     # @!attribute date_of_birth
+    #   The sender's date of birth, in the format YYYY-MM-DD. For card payouts, required for cross-border
+    #   money transfers. Card payouts and regular payments; bank payouts use dob.
+    #   [Optional]
+    #   10 characters for card payouts, max 10 characters for regular payments
     #   @return [String]
     # @!attribute source_of_funds
+    #   The source of the funds used to fund the card payout. Card payouts only.
+    #   [Required] for card payouts
+    #   Enum: "credit" "debit" "prepaid" "deposit_account" "mobile_money_account" "cash"
     #   @return [String] {SourceOfFunds}
     # @!attribute country_of_birth
+    #   The sender's country of birth, as a two-letter ISO country code. Card payouts only.
+    #   [Optional]
+    #   2 characters
     #   @return [String] {CheckoutSdk::Common::Country}
     # @!attribute nationality
+    #   The sender's nationality, as a two-letter ISO country code. Card payouts only.
+    #   [Optional]
+    #   2 characters
     #   @return [String] {CheckoutSdk::Common::Country}
     class IndividualSender < Sender
       attr_accessor :first_name,

data/lib/checkout_sdk/payments/sender/instrument_sender.rb

@@ -2,6 +2,9 @@
 
 module CheckoutSdk
   module Payments
+    # An instrument sender, with type instrument: the sender information is retrieved from the payment
+    # instrument (the destination, for bank payouts). Used by bank payouts and regular payments.
+    # The reference is inherited from {Sender}: [Required] for bank payouts, [Optional] for regular payments.
     class InstrumentSender < Sender
       def initialize
         super(CheckoutSdk::Payments::SenderType::INSTRUMENT)

data/lib/checkout_sdk/payments/sender/sender.rb

@@ -2,9 +2,25 @@
 
 module CheckoutSdk
   module Payments
+    # The sender of a payment or a payout. Set the subclass that matches the sender type.
+    # - Card payouts (money transfers): {IndividualSender}, {CorporateSender}, {GovernmentSender}.
+    # - Bank payouts: {IndividualSender}, {CorporateSender}, {InstrumentSender}. Not supported for Platform or
+    #   Direct Seller Checkout.com clients.
+    # - Regular payments (PaymentRequest): {IndividualSender}, {CorporateSender}, {InstrumentSender}.
+    #
     # @!attribute type
+    #   The sender type. Set by each subclass.
+    #   [Required]
+    #   Enum: "individual" "corporate" "government" (card payouts); "instrument" "individual" "corporate"
+    #   (bank payouts and regular payments)
     #   @return [String] {SenderType}
     # @!attribute reference
+    #   For card payouts, the unique identifier for the sender, for example a customer number; only
+    #   alphanumeric characters are supported. For bank payouts, a unique reference to the underlying
+    #   client's customer, a global KYC requirement. For regular payments, the unique reference for the
+    #   sender of the payment.
+    #   [Required] for card payouts and bank payouts, [Optional] for regular payments
+    #   min 5 characters, max 15 characters for card payouts
     #   @return [String]
     class Sender
       attr_reader :type

data/lib/checkout_sdk/payments/sessions/payment_sessions_request.rb

@@ -3,69 +3,90 @@
 module CheckoutSdk
   module Payments
     # @!attribute amount
-    #   @return [Integer]
+    #   @return [Integer] [Required] The payment amount.
     # @!attribute currency
-    #   @return [String] {CheckoutSdk::Common::Currency}
+    #   @return [String] {CheckoutSdk::Common::Currency} [Required] The three-letter ISO currency code.
     # @!attribute payment_type
-    #   @return [TrueClass, FalseClass]
+    #   @return [String] {PaymentType} [Optional] Must be specified for card-not-present (CNP) payments.
+    #     Enum: "Regular" "Recurring" "MOTO" "Installment" "Unscheduled". Default: "Regular".
     # @!attribute billing
-    #   @return [BillingInformation]
+    #   @return [BillingInformation] [Required] The billing details.
     # @!attribute billing_descriptor
-    #   @return [BillingDescriptor]
+    #   @return [BillingDescriptor] [Optional] A description of the purchase, which is displayed on the customer's
+    #     statement.
     # @!attribute reference
-    #   @return [String]
+    #   @return [String] [Optional] A reference you can use to identify the payment.
     # @!attribute description
-    #   @return [String]
+    #   @return [String] [Optional] A description for the payment.
     # @!attribute customer
-    #   @return [CheckoutSdk::Common::CustomerRequest]
+    #   @return [CheckoutSdk::Common::CustomerRequest] [Optional] The customer's details.
     # @!attribute shipping
-    #   @return [ShippingDetails]
+    #   @return [ShippingDetails] [Optional] The shipping details
     # @!attribute recipient
-    #   @return [PaymentRecipient]
+    #   @return [PaymentRecipient] [Optional] Information about the recipient of the payment's funds.
     # @!attribute processing
-    #   @return [ProcessingSettings]
+    #   @return [ProcessingSettings] [Optional] Use the processing object to influence or override the data sent
+    #     during card processing
     # @!attribute processing_channel_id
-    #   @return [String]
+    #   @return [String] [Optional] The processing channel to use for the payment.
     # @!attribute expires_on
-    #   @return [Time]
+    #   @return [Time] [Optional] A timestamp specifying when the `PaymentSession` should expire, as an ISO 8601 code.
     # @!attribute payment_method_configuration
-    #   @return [PaymentMethodConfiguration]
+    #   @return [PaymentMethodConfiguration] [Optional] Configurations for payment method-specific settings.
     # @!attribute enabled_payment_methods
-    #   @return [Array(PaymentMethodsType)]
+    #   @return [Array(PaymentMethodsType)] [Optional] Specifies which payment method options to present to the
+    #     customer.
     # @!attribute disabled_payment_methods
-    #   @return [Array(PaymentMethodsType)]
+    #   @return [Array(PaymentMethodsType)] [Optional] Specifies which payment method options to not present to the
+    #     customer.
     # @!attribute items
-    #   @return [Array(Product)]
+    #   @return [Array(Product)] [Optional] The line items in the order.
     # @!attribute amount_allocations
-    #   @return [Array(CheckoutSdk::Common::AmountAllocations)]
+    #   @return [Array(CheckoutSdk::Common::AmountAllocations)] [Optional] The sub-entities that the payment is being
+    #     processed on behalf of.
     # @!attribute risk
-    #   @return [RiskRequest]
+    #   @return [RiskRequest] [Optional] Configures the risk assessment performed during payment processing.
     # @!attribute retry
-    #   @return [PaymentRetryRequest]
+    #   @return [PaymentRetryRequest] [Optional] Configuration of asynchronous retries.
+    #   @deprecated Not part of the payment sessions request; the API ignores it. Will be removed in the next
+    #     major version.
+    # @!attribute customer_retry
+    #   @return [CheckoutSdk::Common::CustomerRetry] [Optional] Configures the parameters for customer retries
+    #     performed by the customer on the checkout page. max_attempts is the maximum number of customer retry
+    #     attempts, excluding the initial payment attempt (minimum 0, maximum 5, default 5); it is required
+    #     when customer_retry is set.
     # @!attribute display_name
-    #   @return [String]
+    #   @return [String] [Optional] The merchant's display name.
     # @!attribute success_url
-    #   @return [String]
+    #   @return [String] [Required] Overrides the default success redirect URL configured on your account, for payment
+    #     methods that require a redirect.
     # @!attribute failure_url
-    #   @return [String]
+    #   @return [String] [Required] Overrides the default failure redirect URL configured on your account, for payment
+    #     methods that require a redirect.
     # @!attribute metadata
-    #   @return [Hash{String => Object}]
+    #   @return [Hash{String => Object}] [Optional] Allows you to store additional information about a transaction
+    #     with custom fields and up to five user-defined fields, which can be used for reporting purposes.
     # @!attribute locale
-    #   @return [String]
+    #   @return [String] [Optional] Creates a translated version of the page in the specified language.
     # @!attribute three_ds
-    #   @return [ThreeDSRequest]
+    #   @return [ThreeDSRequest] [Optional] Information required for 3D Secure authentication payments.
     # @!attribute sender
-    #   @return [Sender]
+    #   @return [Sender] [Optional] The sender of the payment.
     # @!attribute capture
-    #   @return [TrueClass, FalseClass]
+    #   @return [TrueClass, FalseClass] [Optional] Specifies whether to capture the payment, if applicable.
     # @!attribute ip_address
-    #   @return [String]
+    #   @return [String] [Optional] The Customers IP address. Only IPv4 and IPv6 addresses are accepted.
+    #   @deprecated The Customers IP address is deprecated in the API reference. Will be removed in the next
+    #     major version.
     # @!attribute capture_on
-    #   @return [Time]
+    #   @return [Time] [Optional] A timestamp specifying when to capture the payment, as an ISO 8601 code.
     # @!attribute tax_amount
-    #   @return [Integer]
+    #   @return [Integer] [Optional] The total tax amount, in the minor currency unit. Not in the
+    #     payment sessions request specification.
     # @!attribute authorization_type
     #   @return [String] [Optional] {AuthorizationType} Enum: "Final" "Estimated". Default: "Final".
+    # @!attribute instruction
+    #   @return [HostedPaymentInstruction] [Optional] Details about the payment instruction.
     # @!attribute payment_plan
     #   @return [PaymentPlan] [Optional] The information to process a recurring payment request.
     #     To be used when the payment_type is Recurring.
@@ -90,6 +111,7 @@ module CheckoutSdk
                     :amount_allocations,
                     :risk,
                     :retry,
+                    :customer_retry,
                     :display_name,
                     :success_url,
                     :failure_url,
@@ -102,7 +124,8 @@ module CheckoutSdk
                     :capture_on,
                     :tax_amount,
                     :authorization_type,
-                    :payment_plan
+                    :payment_plan,
+                    :instruction
     end
   end
 end

data/lib/checkout_sdk/payments/setups/account_funding_transaction_identification.rb

@@ -2,11 +2,20 @@
 
 module CheckoutSdk
   module Payments
+    # Sender identification details of an Account Funding Transaction on a Payment Setup.
+    # Maps swagger `PaymentSetup.account_funding_transaction.sender.identification`.
+    #
     # @!attribute type
-    #   @return [String] {AccountFundingTransactionIdentificationType}
+    #   The type of identification used to identify the sender.
+    #   [Optional]
+    #   @return [String] One of {AccountFundingTransactionIdentificationType}.
     # @!attribute number
+    #   The identification number.
+    #   [Optional]
     #   @return [String]
     # @!attribute issuing_country
+    #   The two-letter ISO country code of the country that issued the identification.
+    #   [Optional]
     #   @return [String] {CheckoutSdk::Common::Country}
     class AccountFundingTransactionIdentification
       attr_accessor :type,

data/lib/checkout_sdk/payments/setups/account_funding_transaction_identification_type.rb

@@ -2,14 +2,15 @@
 
 module CheckoutSdk
   module Payments
-    # Identification document type used by the sender of an Account Funding Transaction
-    # on a Payment Setup.
+    # The type of identification used to identify the sender of an Account Funding Transaction on a
+    # Payment Setup. Maps swagger `PaymentSetup.account_funding_transaction.sender.identification.type`.
     module AccountFundingTransactionIdentificationType
+      # A driving license.
       DRIVING_LICENSE = 'driving_license'
+      # A passport.
       PASSPORT = 'passport'
+      # A national identity document.
       NATIONAL_ID = 'national_id'
-      TAX_ID = 'tax_id'
-      OTHER = 'other'
     end
   end
 end

data/lib/checkout_sdk/payments/setups/account_funding_transaction_recipient.rb

@@ -2,17 +2,45 @@
 
 module CheckoutSdk
   module Payments
+    # Account funding transaction recipient details on a Payment Setup.
+    # Maps swagger `PaymentSetup.account_funding_transaction.recipient`.
+    #
     # @!attribute first_name
+    #   The recipient's first name.
+    #   [Optional]
+    #   max 50 characters
     #   @return [String]
     # @!attribute last_name
+    #   The recipient's last name.
+    #   [Optional]
+    #   max 50 characters
     #   @return [String]
     # @!attribute account_number
+    #   Any identifier like part of the PAN (first six digits and last four digits), an IBAN, an internal
+    #   account number, or a phone number related to the primary recipient's account.
+    #   [Optional]
+    #   max 34 characters
     #   @return [String]
     # @!attribute account_type
+    #   The type of the recipient's account.
+    #   [Optional]
+    #   @deprecated Not part of the Recipient schema of the Payment Setups account funding transaction; the
+    #     API ignores it on requests. There is no replacement. Will be removed in the next major version.
     #   @return [String]
     # @!attribute date_of_birth
-    #   @return [String] Format: YYYY-MM-DD
+    #   Date of birth of the recipient (yyyy-mm-dd).
+    #   [Optional]
+    #   Format: date
+    #   @return [String]
     # @!attribute address
+    #   The recipient's address. Maps swagger `PaymentSetupAddress`; all keys are optional:
+    #   - `address_line1`: The first line of the address. max 200 characters
+    #   - `address_line2`: The second line of the address. max 200 characters
+    #   - `city`: The address city. max 50 characters
+    #   - `state`: The address state or county. max 50 characters
+    #   - `zip`: The postal or zip code. max 50 characters
+    #   - `country`: The address country, in ISO 3166-1 alpha-2 format. max 2 characters
+    #   [Optional]
     #   @return [CheckoutSdk::Common::Address]
     class AccountFundingTransactionRecipient
       attr_accessor :first_name,

data/lib/checkout_sdk/payments/setups/account_funding_transaction_sender.rb

@@ -2,19 +2,51 @@
 
 module CheckoutSdk
   module Payments
+    # Account funding transaction sender details on a Payment Setup.
+    # Maps swagger `PaymentSetup.account_funding_transaction.sender`.
+    #
     # @!attribute first_name
+    #   The sender's first name.
+    #   [Optional]
+    #   @deprecated Not part of the Sender schema of the Payment Setups account funding transaction; the
+    #     API ignores it on requests. There is no replacement. Will be removed in the next major version.
     #   @return [String]
     # @!attribute last_name
+    #   The sender's last name.
+    #   [Optional]
+    #   @deprecated Not part of the Sender schema of the Payment Setups account funding transaction; the
+    #     API ignores it on requests. There is no replacement. Will be removed in the next major version.
     #   @return [String]
     # @!attribute date_of_birth
-    #   @return [String] Format: YYYY-MM-DD
+    #   Date of birth of the sender (yyyy-mm-dd).
+    #   [Optional]
+    #   Format: date
+    #   @return [String]
     # @!attribute country_of_birth
+    #   The sender's country of birth, as an ISO 3166-1 alpha-2 code.
+    #   [Optional]
+    #   @deprecated Not part of the Sender schema of the Payment Setups account funding transaction; the
+    #     API ignores it on requests. There is no replacement. Will be removed in the next major version.
     #   @return [String] {CheckoutSdk::Common::Country}
     # @!attribute nationality
+    #   The sender's nationality, as an ISO 3166-1 alpha-2 code.
+    #   [Optional]
+    #   @deprecated Not part of the Sender schema of the Payment Setups account funding transaction; the
+    #     API ignores it on requests. There is no replacement. Will be removed in the next major version.
     #   @return [String] {CheckoutSdk::Common::Country}
     # @!attribute address
+    #   The sender's address.
+    #   [Optional]
+    #   @deprecated Not part of the Sender schema of the Payment Setups account funding transaction; the
+    #     API ignores it on requests. There is no replacement. Will be removed in the next major version.
     #   @return [CheckoutSdk::Common::Address]
+    # @!attribute reference
+    #   The unique reference for the sender of the payment.
+    #   [Optional]
+    #   @return [String]
     # @!attribute identification
+    #   Sender identification details.
+    #   [Optional]
     #   @return [AccountFundingTransactionIdentification]
     class AccountFundingTransactionSender
       attr_accessor :first_name,
@@ -23,6 +55,7 @@ module CheckoutSdk
                     :country_of_birth,
                     :nationality,
                     :address,
+                    :reference,
                     :identification
     end
   end