paypal-server-sdk 0.6.1 → 0.7.0

data/lib/paypal_server_sdk/models/card_vault_response.rb

@@ -82,5 +82,18 @@ module PaypalServerSdk
                             links: links,
                             customer: customer)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id}, status: #{@status}, links: #{@links}, customer: #{@customer}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id.inspect}, status: #{@status.inspect}, links: #{@links.inspect},"\
+      " customer: #{@customer.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/card_verification.rb

@@ -11,7 +11,7 @@ module PaypalServerSdk
     private_constant :SKIP
 
     # The method used for card verification.
-    # @return [CardVerificationMethod]
+    # @return [OrdersCardVerificationMethod]
     attr_accessor :method
 
     # A mapping from model property names to API property names.
@@ -33,7 +33,7 @@ module PaypalServerSdk
       []
     end
 
-    def initialize(method: CardVerificationMethod::SCA_WHEN_REQUIRED)
+    def initialize(method: OrdersCardVerificationMethod::SCA_WHEN_REQUIRED)
       @method = method unless method == SKIP
     end
 
@@ -42,10 +42,23 @@ module PaypalServerSdk
       return nil unless hash
 
       # Extract variables from the hash.
-      method = hash['method'] ||= CardVerificationMethod::SCA_WHEN_REQUIRED
+      method =
+        hash['method'] ||= OrdersCardVerificationMethod::SCA_WHEN_REQUIRED
 
       # Create object from extracted values.
       CardVerification.new(method: method)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} method: #{@method}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} method: #{@method.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/card_verification_details.rb

@@ -10,15 +10,15 @@ module PaypalServerSdk
     SKIP = Object.new
     private_constant :SKIP
 
-    # Transaction Identifier as given by the network to indicate a previously
-    # executed CIT authorization. Only present when authorization is successful
-    # for a verification.
+    # DEPRECATED. This field is DEPRECATED. Please find the network transaction
+    # id data in the 'id' field under the 'network_transaction_reference' object
+    # instead of the 'verification' object.
     # @return [String]
     attr_accessor :network_transaction_id
 
-    # The date that the transaction was authorized by the scheme. This field may
-    # not be returned for all networks. MasterCard refers to this field as
-    # "BankNet reference date".
+    # DEPRECATED. This field is DEPRECATED. Please find the date data in the
+    # 'date' field under the 'network_transaction_reference' object instead of
+    # the 'verification' object.
     # @return [String]
     attr_accessor :date
 
@@ -29,9 +29,8 @@ module PaypalServerSdk
 
     # The date and time, in [Internet date and time
     # format](https://tools.ietf.org/html/rfc3339#section-5.6). Seconds are
-    # required while fractional seconds are
-    # optional.<blockquote><strong>Note:</strong> The regular expression
-    # provides guidance but does not reject all invalid dates.</blockquote>
+    # required while fractional seconds are optional. Note: The regular
+    # expression provides guidance but does not reject all invalid dates.
     # @return [String]
     attr_accessor :time
 
@@ -46,8 +45,8 @@ module PaypalServerSdk
     attr_accessor :processor_response
 
     # DEPRECATED. This field is DEPRECATED. Please find the 3D secure
-    # authentication data in 'three_d_secure' object under
-    # 'authentication_result' object instead of the 'verification' field.
+    # authentication data in the 'three_d_secure' object under the
+    # 'authentication_result' object instead of the 'verification' object.
     # @return [Object]
     attr_accessor :three_d_secure
 
@@ -120,5 +119,22 @@ module PaypalServerSdk
                                   processor_response: processor_response,
                                   three_d_secure: three_d_secure)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} network_transaction_id: #{@network_transaction_id}, date: #{@date},"\
+      " network: #{@network}, time: #{@time}, amount: #{@amount}, processor_response:"\
+      " #{@processor_response}, three_d_secure: #{@three_d_secure}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} network_transaction_id: #{@network_transaction_id.inspect}, date:"\
+      " #{@date.inspect}, network: #{@network.inspect}, time: #{@time.inspect}, amount:"\
+      " #{@amount.inspect}, processor_response: #{@processor_response.inspect}, three_d_secure:"\
+      " #{@three_d_secure.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/card_verification_processor_response.rb

@@ -58,5 +58,17 @@ module PaypalServerSdk
       CardVerificationProcessorResponse.new(avs_code: avs_code,
                                             cvv_code: cvv_code)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} avs_code: #{@avs_code}, cvv_code: #{@cvv_code}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} avs_code: #{@avs_code.inspect}, cvv_code: #{@cvv_code.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/card_verification_status.rb

@@ -0,0 +1,23 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # Verification status of Card.
+  class CardVerificationStatus
+    CARD_VERIFICATION_STATUS = [
+      # Card has been verified
+      VERIFIED = 'VERIFIED'.freeze,
+
+      # Card verification has failed
+      FAILED = 'FAILED'.freeze
+    ].freeze
+
+    def self.validate(value)
+      return false if value.nil?
+
+      true
+    end
+  end
+end

data/lib/paypal_server_sdk/models/checkout_payment_intent.rb

@@ -8,10 +8,18 @@ module PaypalServerSdk
   # an order after order creation.
   class CheckoutPaymentIntent
     CHECKOUT_PAYMENT_INTENT = [
-      # TODO: Write general description for CAPTURE
+      # The merchant intends to capture payment immediately after the customer
+      # makes a payment.
       CAPTURE = 'CAPTURE'.freeze,
 
-      # TODO: Write general description for AUTHORIZE
+      # The merchant intends to authorize a payment and place funds on hold
+      # after the customer makes a payment. Authorized payments are best
+      # captured within three days of authorization but are available to capture
+      # for up to 29 days. After the three-day honor period, the original
+      # authorized payment expires and you must re-authorize the payment. You
+      # must make a separate request to capture payments on demand. This intent
+      # is not supported when you have more than one `purchase_unit` within your
+      # order.
       AUTHORIZE = 'AUTHORIZE'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/cobranded_card.rb

@@ -66,5 +66,18 @@ module PaypalServerSdk
                         payee: payee,
                         amount: amount)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} labels: #{@labels}, payee: #{@payee}, amount: #{@amount}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} labels: #{@labels.inspect}, payee: #{@payee.inspect}, amount:"\
+      " #{@amount.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/confirm_order_request.rb

@@ -14,10 +14,6 @@ module PaypalServerSdk
     # @return [PaymentSource]
     attr_accessor :payment_source
 
-    # The payment source definition.
-    # @return [Object]
-    attr_accessor :processing_instruction
-
     # Customizes the payer confirmation experience.
     # @return [OrderConfirmApplicationContext]
     attr_accessor :application_context
@@ -26,7 +22,6 @@ module PaypalServerSdk
     def self.names
       @_hash = {} if @_hash.nil?
       @_hash['payment_source'] = 'payment_source'
-      @_hash['processing_instruction'] = 'processing_instruction'
       @_hash['application_context'] = 'application_context'
       @_hash
     end
@@ -34,7 +29,6 @@ module PaypalServerSdk
     # An array for optional fields
     def self.optionals
       %w[
-        processing_instruction
         application_context
       ]
     end
@@ -44,10 +38,8 @@ module PaypalServerSdk
       []
     end
 
-    def initialize(payment_source:, processing_instruction: SKIP,
-                   application_context: SKIP)
+    def initialize(payment_source:, application_context: SKIP)
       @payment_source = payment_source
-      @processing_instruction = processing_instruction unless processing_instruction == SKIP
       @application_context = application_context unless application_context == SKIP
     end
 
@@ -57,15 +49,26 @@ module PaypalServerSdk
 
       # Extract variables from the hash.
       payment_source = PaymentSource.from_hash(hash['payment_source']) if hash['payment_source']
-      processing_instruction =
-        hash.key?('processing_instruction') ? hash['processing_instruction'] : SKIP
       application_context = OrderConfirmApplicationContext.from_hash(hash['application_context']) if
         hash['application_context']
 
       # Create object from extracted values.
       ConfirmOrderRequest.new(payment_source: payment_source,
-                              processing_instruction: processing_instruction,
                               application_context: application_context)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} payment_source: #{@payment_source}, application_context:"\
+      " #{@application_context}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} payment_source: #{@payment_source.inspect}, application_context:"\
+      " #{@application_context.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/{customer_request.rb → customer.rb}

@@ -4,8 +4,9 @@
 # ( https://apimatic.io ).
 
 module PaypalServerSdk
-  # Customer in merchant's or partner's system of records.
-  class CustomerRequest < BaseModel
+  # This object defines a customer in your system. Use it to manage customer
+  # profiles, save payment methods and contact details.
+  class Customer < BaseModel
     SKIP = Object.new
     private_constant :SKIP
 
@@ -55,8 +56,21 @@ module PaypalServerSdk
         hash.key?('merchant_customer_id') ? hash['merchant_customer_id'] : SKIP
 
       # Create object from extracted values.
-      CustomerRequest.new(id: id,
-                          merchant_customer_id: merchant_customer_id)
+      Customer.new(id: id,
+                   merchant_customer_id: merchant_customer_id)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id}, merchant_customer_id: #{@merchant_customer_id}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id.inspect}, merchant_customer_id:"\
+      " #{@merchant_customer_id.inspect}>"
     end
   end
 end

data/lib/paypal_server_sdk/models/customer_information.rb

@@ -13,11 +13,10 @@ module PaypalServerSdk
     # @return [String]
     attr_accessor :id
 
-    # The internationalized email address.<blockquote><strong>Note:</strong> Up
-    # to 64 characters are allowed before and 255 characters are allowed after
-    # the <code>@</code> sign. However, the generally accepted maximum length
-    # for an email address is 254 characters. The pattern verifies that an
-    # unquoted <code>@</code> sign exists.</blockquote>
+    # The internationalized email address. Note: Up to 64 characters are allowed
+    # before and 255 characters are allowed after the @ sign. However, the
+    # generally accepted maximum length for an email address is 254 characters.
+    # The pattern verifies that an unquoted @ sign exists.
     # @return [String]
     attr_accessor :email_address
 
@@ -68,5 +67,18 @@ module PaypalServerSdk
                               email_address: email_address,
                               phone: phone)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id}, email_address: #{@email_address}, phone: #{@phone}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id.inspect}, email_address: #{@email_address.inspect}, phone:"\
+      " #{@phone.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/customer_response.rb

@@ -0,0 +1,76 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # This object defines a customer in your system. Use it to manage customer
+  # profiles, save payment methods and contact details.
+  class CustomerResponse < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The unique ID for a customer generated by PayPal.
+    # @return [String]
+    attr_accessor :id
+
+    # Merchants and partners may already have a data-store where their customer
+    # information is persisted. Use merchant_customer_id to associate the
+    # PayPal-generated customer.id to your representation of a customer.
+    # @return [String]
+    attr_accessor :merchant_customer_id
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['id'] = 'id'
+      @_hash['merchant_customer_id'] = 'merchant_customer_id'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        id
+        merchant_customer_id
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(id: SKIP, merchant_customer_id: SKIP)
+      @id = id unless id == SKIP
+      @merchant_customer_id = merchant_customer_id unless merchant_customer_id == SKIP
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      id = hash.key?('id') ? hash['id'] : SKIP
+      merchant_customer_id =
+        hash.key?('merchant_customer_id') ? hash['merchant_customer_id'] : SKIP
+
+      # Create object from extracted values.
+      CustomerResponse.new(id: id,
+                           merchant_customer_id: merchant_customer_id)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id}, merchant_customer_id: #{@merchant_customer_id}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id.inspect}, merchant_customer_id:"\
+      " #{@merchant_customer_id.inspect}>"
+    end
+  end
+end

data/lib/paypal_server_sdk/models/customer_vault_payment_tokens_response.rb

@@ -17,11 +17,13 @@ module PaypalServerSdk
     # @return [Integer]
     attr_accessor :total_pages
 
-    # Customer in merchant's or partner's system of records.
-    # @return [CustomerRequest]
+    # This object defines a customer in your system. Use it to manage customer
+    # profiles, save payment methods and contact details.
+    # @return [VaultResponseCustomer]
     attr_accessor :customer
 
-    # Customer in merchant's or partner's system of records.
+    # This object defines a customer in your system. Use it to manage customer
+    # profiles, save payment methods and contact details.
     # @return [Array[PaymentTokenResponse]]
     attr_accessor :payment_tokens
 
@@ -72,7 +74,7 @@ module PaypalServerSdk
       # Extract variables from the hash.
       total_items = hash.key?('total_items') ? hash['total_items'] : SKIP
       total_pages = hash.key?('total_pages') ? hash['total_pages'] : SKIP
-      customer = CustomerRequest.from_hash(hash['customer']) if hash['customer']
+      customer = VaultResponseCustomer.from_hash(hash['customer']) if hash['customer']
       # Parameter is an array, so we need to iterate through it
       payment_tokens = nil
       unless hash['payment_tokens'].nil?
@@ -101,5 +103,20 @@ module PaypalServerSdk
                                              payment_tokens: payment_tokens,
                                              links: links)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} total_items: #{@total_items}, total_pages: #{@total_pages}, customer:"\
+      " #{@customer}, payment_tokens: #{@payment_tokens}, links: #{@links}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} total_items: #{@total_items.inspect}, total_pages: #{@total_pages.inspect},"\
+      " customer: #{@customer.inspect}, payment_tokens: #{@payment_tokens.inspect}, links:"\
+      " #{@links.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/cvv_code.rb

@@ -8,47 +8,55 @@ module PaypalServerSdk
   # American Express.
   class CvvCode
     CVV_CODE = [
-      # TODO: Write general description for E
-      E = 'E'.freeze,
+      # For Visa, Mastercard, Discover, or American Express, error -
+      # unrecognized or unknown response.
+      CVV_E = 'E'.freeze,
 
-      # TODO: Write general description for I
-      I = 'I'.freeze,
+      # For Visa, Mastercard, Discover, or American Express, invalid or null.
+      CVV_I = 'I'.freeze,
 
-      # TODO: Write general description for M
-      M = 'M'.freeze,
+      # For Visa, Mastercard, Discover, or American Express, the CVV2/CSC
+      # matches.
+      CVV_M = 'M'.freeze,
 
-      # TODO: Write general description for N
-      N = 'N'.freeze,
+      # For Visa, Mastercard, Discover, or American Express, the CVV2/CSC does
+      # not match.
+      CVV_N = 'N'.freeze,
 
-      # TODO: Write general description for P
-      P = 'P'.freeze,
+      # For Visa, Mastercard, Discover, or American Express, it was not
+      # processed.
+      CVV_P = 'P'.freeze,
 
-      # TODO: Write general description for S
-      S = 'S'.freeze,
+      # For Visa, Mastercard, Discover, or American Express, the service is not
+      # supported.
+      CVV_S = 'S'.freeze,
 
-      # TODO: Write general description for U
-      U = 'U'.freeze,
+      # For Visa, Mastercard, Discover, or American Express, unknown - the
+      # issuer is not certified.
+      CVV_U = 'U'.freeze,
 
-      # TODO: Write general description for X
-      X = 'X'.freeze,
+      # For Visa, Mastercard, Discover, or American Express, no response. For
+      # Maestro, the service is not available.
+      CVV_X = 'X'.freeze,
 
-      # TODO: Write general description for ENUM_ALL_OTHERS
+      # For Visa, Mastercard, Discover, or American Express, error.
       ENUM_ALL_OTHERS = 'All others'.freeze,
 
-      # TODO: Write general description for ENUM_0
-      ENUM_0 = '0'.freeze,
+      # For Maestro, the CVV2 matched.
+      CVV_0 = '0'.freeze,
 
-      # TODO: Write general description for ENUM_1
-      ENUM_1 = '1'.freeze,
+      # For Maestro, the CVV2 did not match.
+      CVV_1 = '1'.freeze,
 
-      # TODO: Write general description for ENUM_2
-      ENUM_2 = '2'.freeze,
+      # For Maestro, the merchant has not implemented CVV2 code handling.
+      CVV_2 = '2'.freeze,
 
-      # TODO: Write general description for ENUM_3
-      ENUM_3 = '3'.freeze,
+      # For Maestro, the merchant has indicated that CVV2 is not present on
+      # card.
+      CVV_3 = '3'.freeze,
 
-      # TODO: Write general description for ENUM_4
-      ENUM_4 = '4'.freeze
+      # For Maestro, the service is not available.
+      CVV_4 = '4'.freeze
     ].freeze
 
     def self.validate(value)

data/lib/paypal_server_sdk/models/disbursement_mode.rb

@@ -7,10 +7,13 @@ module PaypalServerSdk
   # The funds that are held on behalf of the merchant.
   class DisbursementMode
     DISBURSEMENT_MODE = [
-      # TODO: Write general description for INSTANT
+      # The funds are released to the merchant immediately.
       INSTANT = 'INSTANT'.freeze,
 
-      # TODO: Write general description for DELAYED
+      # The funds are held for a finite number of days. The actual duration
+      # depends on the region and type of integration. You can release the funds
+      # through a referenced payout. Otherwise, the funds disbursed
+      # automatically after the specified duration.
       DELAYED = 'DELAYED'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/dispute_category.rb

@@ -7,10 +7,10 @@ module PaypalServerSdk
   # The condition that is covered for the transaction.
   class DisputeCategory
     DISPUTE_CATEGORY = [
-      # TODO: Write general description for ITEM_NOT_RECEIVED
+      # The payer paid for an item that they did not receive.
       ITEM_NOT_RECEIVED = 'ITEM_NOT_RECEIVED'.freeze,
 
-      # TODO: Write general description for UNAUTHORIZED_TRANSACTION
+      # The payer did not authorize the payment.
       UNAUTHORIZED_TRANSACTION = 'UNAUTHORIZED_TRANSACTION'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/eci_flag.rb

@@ -9,24 +9,22 @@ module PaypalServerSdk
   # should be passed on the authorization transaction to the Gateway/Processor.
   class EciFlag
     ECI_FLAG = [
-      # TODO: Write general description for MASTERCARD_NON_3D_SECURE_TRANSACTION
+      # Mastercard non-3-D Secure transaction.
       MASTERCARD_NON_3D_SECURE_TRANSACTION = 'MASTERCARD_NON_3D_SECURE_TRANSACTION'.freeze,
 
-      # TODO: Write general description for
-      # MASTERCARD_ATTEMPTED_AUTHENTICATION_TRANSACTION
+      # Mastercard attempted authentication transaction.
       MASTERCARD_ATTEMPTED_AUTHENTICATION_TRANSACTION = 'MASTERCARD_ATTEMPTED_AUTHENTICATION_TRANSACTION'.freeze,
 
-      # TODO: Write general description for
-      # MASTERCARD_FULLY_AUTHENTICATED_TRANSACTION
+      # Mastercard fully authenticated transaction.
       MASTERCARD_FULLY_AUTHENTICATED_TRANSACTION = 'MASTERCARD_FULLY_AUTHENTICATED_TRANSACTION'.freeze,
 
-      # TODO: Write general description for FULLY_AUTHENTICATED_TRANSACTION
+      # VISA, AMEX, JCB, DINERS CLUB fully authenticated transaction.
       FULLY_AUTHENTICATED_TRANSACTION = 'FULLY_AUTHENTICATED_TRANSACTION'.freeze,
 
-      # TODO: Write general description for ATTEMPTED_AUTHENTICATION_TRANSACTION
+      # VISA, AMEX, JCB, DINERS CLUB attempted authentication transaction.
       ATTEMPTED_AUTHENTICATION_TRANSACTION = 'ATTEMPTED_AUTHENTICATION_TRANSACTION'.freeze,
 
-      # TODO: Write general description for NON_3D_SECURE_TRANSACTION
+      # VISA, AMEX, JCB, DINERS CLUB non-3-D Secure transaction.
       NON_3D_SECURE_TRANSACTION = 'NON_3D_SECURE_TRANSACTION'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/enrollment_status.rb

@@ -7,17 +7,20 @@ module PaypalServerSdk
   # Status of Authentication eligibility.
   class EnrollmentStatus
     ENROLLMENT_STATUS = [
-      # TODO: Write general description for Y
-      Y = 'Y'.freeze,
+      # Yes. The bank is participating in 3-D Secure protocol and will return
+      # the ACSUrl.
+      ENROLLED = 'Y'.freeze,
 
-      # TODO: Write general description for N
-      N = 'N'.freeze,
+      # No. The bank is not participating in 3-D Secure protocol.
+      NOTENROLLED = 'N'.freeze,
 
-      # TODO: Write general description for U
-      U = 'U'.freeze,
+      # Unavailable. The DS or ACS is not available for authentication at the
+      # time of the request.
+      UNAVAILABLE = 'U'.freeze,
 
-      # TODO: Write general description for B
-      B = 'B'.freeze
+      # Bypass. The merchant authentication rule is triggered to bypass
+      # authentication.
+      BYPASS = 'B'.freeze
     ].freeze
 
     def self.validate(value)