paypal-server-sdk 0.6.0 → 0.6.1

data/lib/paypal_server_sdk/controllers/payments_controller.rb

@@ -9,14 +9,23 @@ module PaypalServerSdk
     # Shows details for an authorized payment, by ID.
     # @param [String] authorization_id Required parameter: The ID of the
     # authorized payment for which to show details.
+    # @param [String] paypal_auth_assertion Optional parameter: An
+    # API-caller-provided JSON Web Token (JWT) assertion that identifies the
+    # merchant. For details, see
+    # [PayPal-Auth-Assertion](/docs/api/reference/api-requests/#paypal-auth-asse
+    # rtion).<blockquote><strong>Note:</strong>For three party transactions in
+    # which a partner is managing the API calls on behalf of a merchant, the
+    # partner must identify the merchant using either a PayPal-Auth-Assertion
+    # header or an access token with target_subject.</blockquote>
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def authorizations_get(authorization_id)
+    def authorizations_get(options = {})
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::GET,
                                      '/v2/payments/authorizations/{authorization_id}',
                                      Server::DEFAULT)
-                   .template_param(new_parameter(authorization_id, key: 'authorization_id')
+                   .template_param(new_parameter(options['authorization_id'], key: 'authorization_id')
                                     .should_encode(true))
+                   .header_param(new_parameter(options['paypal_auth_assertion'], key: 'PayPal-Auth-Assertion'))
                    .header_param(new_parameter('application/json', key: 'accept'))
                    .auth(Single.new('Oauth2')))
         .response(new_response_handler
@@ -27,10 +36,6 @@ module PaypalServerSdk
                                  'Authentication failed due to missing authorization header, or'\
                                   ' invalid authentication credentials.',
                                  ErrorException)
-                    .local_error('403',
-                                 'The request failed because the caller has insufficient'\
-                                  ' permissions.',
-                                 ErrorException)
                     .local_error('404',
                                  'The request failed because the resource does not exist.',
                                  ErrorException)
@@ -56,6 +61,14 @@ module PaypalServerSdk
     # HATEOAS links.</li><li><code>return=representation</code>. The server
     # returns a complete resource representation, including the current state of
     # the resource.</li></ul>
+    # @param [String] paypal_auth_assertion Optional parameter: An
+    # API-caller-provided JSON Web Token (JWT) assertion that identifies the
+    # merchant. For details, see
+    # [PayPal-Auth-Assertion](/docs/api/reference/api-requests/#paypal-auth-asse
+    # rtion).<blockquote><strong>Note:</strong>For three party transactions in
+    # which a partner is managing the API calls on behalf of a merchant, the
+    # partner must identify the merchant using either a PayPal-Auth-Assertion
+    # header or an access token with target_subject.</blockquote>
     # @param [CaptureRequest] body Optional parameter: Example:
     # @return [ApiResponse]  the complete http response with raw body and status code.
     def authorizations_capture(options = {})
@@ -68,6 +81,7 @@ module PaypalServerSdk
                    .header_param(new_parameter('application/json', key: 'Content-Type'))
                    .header_param(new_parameter(options['paypal_request_id'], key: 'PayPal-Request-Id'))
                    .header_param(new_parameter(options['prefer'], key: 'Prefer'))
+                   .header_param(new_parameter(options['paypal_auth_assertion'], key: 'PayPal-Auth-Assertion'))
                    .body_param(new_parameter(options['body']))
                    .header_param(new_parameter('application/json', key: 'accept'))
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
@@ -108,18 +122,24 @@ module PaypalServerSdk
         .execute
     end
 
-    # Voids, or cancels, an authorized payment, by ID. You cannot void an
-    # authorized payment that has been fully captured.
+    # Reauthorizes an authorized PayPal account payment, by ID. To ensure that
+    # funds are still available, reauthorize a payment after its initial
+    # three-day honor period expires. Within the 29-day authorization period,
+    # you can issue multiple re-authorizations after the honor period
+    # expires.<br/><br/>If 30 days have transpired since the date of the
+    # original authorization, you must create an authorized payment instead of
+    # reauthorizing the original authorized payment.<br/><br/>A reauthorized
+    # payment itself has a new honor period of three days.<br/><br/>You can
+    # reauthorize an authorized payment from 4 to 29 days after the 3-day honor
+    # period. The allowed amount depends on context and geography, for example
+    # in US it is up to 115% of the original authorized amount, not to exceed an
+    # increase of $75 USD.<br/><br/>Supports only the `amount` request
+    # parameter.<blockquote><strong>Note:</strong> This request is currently not
+    # supported for Partner use cases.</blockquote>
     # @param [String] authorization_id Required parameter: The PayPal-generated
-    # ID for the authorized payment to void.
-    # @param [String] paypal_auth_assertion Optional parameter: An
-    # API-caller-provided JSON Web Token (JWT) assertion that identifies the
-    # merchant. For details, see
-    # [PayPal-Auth-Assertion](/docs/api/reference/api-requests/#paypal-auth-asse
-    # rtion).<blockquote><strong>Note:</strong>For three party transactions in
-    # which a partner is managing the API calls on behalf of a merchant, the
-    # partner must identify the merchant using either a PayPal-Auth-Assertion
-    # header or an access token with target_subject.</blockquote>
+    # ID for the authorized payment to reauthorize.
+    # @param [String] paypal_request_id Optional parameter: The server stores
+    # keys for 45 days.
     # @param [String] prefer Optional parameter: The preferred server response
     # upon successful completion of the request. Value
     # is:<ul><li><code>return=minimal</code>. The server returns a minimal
@@ -128,20 +148,32 @@ module PaypalServerSdk
     # HATEOAS links.</li><li><code>return=representation</code>. The server
     # returns a complete resource representation, including the current state of
     # the resource.</li></ul>
+    # @param [String] paypal_auth_assertion Optional parameter: An
+    # API-caller-provided JSON Web Token (JWT) assertion that identifies the
+    # merchant. For details, see
+    # [PayPal-Auth-Assertion](/docs/api/reference/api-requests/#paypal-auth-asse
+    # rtion).<blockquote><strong>Note:</strong>For three party transactions in
+    # which a partner is managing the API calls on behalf of a merchant, the
+    # partner must identify the merchant using either a PayPal-Auth-Assertion
+    # header or an access token with target_subject.</blockquote>
+    # @param [ReauthorizeRequest] body Optional parameter: Example:
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def authorizations_void(options = {})
+    def authorizations_reauthorize(options = {})
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
-                                     '/v2/payments/authorizations/{authorization_id}/void',
+                                     '/v2/payments/authorizations/{authorization_id}/reauthorize',
                                      Server::DEFAULT)
                    .template_param(new_parameter(options['authorization_id'], key: 'authorization_id')
                                     .should_encode(true))
-                   .header_param(new_parameter(options['paypal_auth_assertion'], key: 'PayPal-Auth-Assertion'))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .header_param(new_parameter(options['paypal_request_id'], key: 'PayPal-Request-Id'))
                    .header_param(new_parameter(options['prefer'], key: 'Prefer'))
+                   .header_param(new_parameter(options['paypal_auth_assertion'], key: 'PayPal-Auth-Assertion'))
+                   .body_param(new_parameter(options['body']))
                    .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(Single.new('Oauth2')))
         .response(new_response_handler
-                    .is_nullable_response(true)
                     .deserializer(APIHelper.method(:custom_type_deserializer))
                     .deserialize_into(PaymentAuthorization.method(:from_hash))
                     .is_api_response(true)
@@ -153,17 +185,9 @@ module PaypalServerSdk
                                  'Authentication failed due to missing authorization header, or'\
                                   ' invalid authentication credentials.',
                                  ErrorException)
-                    .local_error('403',
-                                 'The request failed because the caller has insufficient'\
-                                  ' permissions.',
-                                 ErrorException)
                     .local_error('404',
                                  'The request failed because the resource does not exist.',
                                  ErrorException)
-                    .local_error('409',
-                                 'The request failed because a previous call for the given'\
-                                  ' resource is in progress.',
-                                 ErrorException)
                     .local_error('422',
                                  'The request failed because it either is semantically incorrect'\
                                   ' or failed business validation.',
@@ -177,22 +201,18 @@ module PaypalServerSdk
         .execute
     end
 
-    # Reauthorizes an authorized PayPal account payment, by ID. To ensure that
-    # funds are still available, reauthorize a payment after its initial
-    # three-day honor period expires. Within the 29-day authorization period,
-    # you can issue multiple re-authorizations after the honor period
-    # expires.<br/><br/>If 30 days have transpired since the date of the
-    # original authorization, you must create an authorized payment instead of
-    # reauthorizing the original authorized payment.<br/><br/>A reauthorized
-    # payment itself has a new honor period of three days.<br/><br/>You can
-    # reauthorize an authorized payment from 4 to 29 days after the 3-day honor
-    # period. The allowed amount depends on context and geography, for example
-    # in US it is up to 115% of the original authorized amount, not to exceed an
-    # increase of $75 USD.<br/><br/>Supports only the `amount` request
-    # parameter.<blockquote><strong>Note:</strong> This request is currently not
-    # supported for Partner use cases.</blockquote>
+    # Voids, or cancels, an authorized payment, by ID. You cannot void an
+    # authorized payment that has been fully captured.
     # @param [String] authorization_id Required parameter: The PayPal-generated
-    # ID for the authorized payment to reauthorize.
+    # ID for the authorized payment to void.
+    # @param [String] paypal_auth_assertion Optional parameter: An
+    # API-caller-provided JSON Web Token (JWT) assertion that identifies the
+    # merchant. For details, see
+    # [PayPal-Auth-Assertion](/docs/api/reference/api-requests/#paypal-auth-asse
+    # rtion).<blockquote><strong>Note:</strong>For three party transactions in
+    # which a partner is managing the API calls on behalf of a merchant, the
+    # partner must identify the merchant using either a PayPal-Auth-Assertion
+    # header or an access token with target_subject.</blockquote>
     # @param [String] paypal_request_id Optional parameter: The server stores
     # keys for 45 days.
     # @param [String] prefer Optional parameter: The preferred server response
@@ -203,30 +223,24 @@ module PaypalServerSdk
     # HATEOAS links.</li><li><code>return=representation</code>. The server
     # returns a complete resource representation, including the current state of
     # the resource.</li></ul>
-    # @param [ReauthorizeRequest] body Optional parameter: Example:
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def authorizations_reauthorize(options = {})
+    def authorizations_void(options = {})
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
-                                     '/v2/payments/authorizations/{authorization_id}/reauthorize',
+                                     '/v2/payments/authorizations/{authorization_id}/void',
                                      Server::DEFAULT)
                    .template_param(new_parameter(options['authorization_id'], key: 'authorization_id')
                                     .should_encode(true))
-                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .header_param(new_parameter(options['paypal_auth_assertion'], key: 'PayPal-Auth-Assertion'))
                    .header_param(new_parameter(options['paypal_request_id'], key: 'PayPal-Request-Id'))
                    .header_param(new_parameter(options['prefer'], key: 'Prefer'))
-                   .body_param(new_parameter(options['body']))
                    .header_param(new_parameter('application/json', key: 'accept'))
-                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(Single.new('Oauth2')))
         .response(new_response_handler
+                    .is_nullable_response(true)
                     .deserializer(APIHelper.method(:custom_type_deserializer))
                     .deserialize_into(PaymentAuthorization.method(:from_hash))
                     .is_api_response(true)
-                    .local_error('400',
-                                 'The request failed because it is not well-formed or is'\
-                                  ' syntactically incorrect or violates schema.',
-                                 ErrorException)
                     .local_error('401',
                                  'Authentication failed due to missing authorization header, or'\
                                   ' invalid authentication credentials.',
@@ -238,6 +252,10 @@ module PaypalServerSdk
                     .local_error('404',
                                  'The request failed because the resource does not exist.',
                                  ErrorException)
+                    .local_error('409',
+                                 'The request failed because a previous call for the given'\
+                                  ' resource is in progress.',
+                                 ErrorException)
                     .local_error('422',
                                  'The request failed because it either is semantically incorrect'\
                                   ' or failed business validation.',
@@ -367,14 +385,23 @@ module PaypalServerSdk
     # Shows details for a refund, by ID.
     # @param [String] refund_id Required parameter: The PayPal-generated ID for
     # the refund for which to show details.
+    # @param [String] paypal_auth_assertion Optional parameter: An
+    # API-caller-provided JSON Web Token (JWT) assertion that identifies the
+    # merchant. For details, see
+    # [PayPal-Auth-Assertion](/docs/api/reference/api-requests/#paypal-auth-asse
+    # rtion).<blockquote><strong>Note:</strong>For three party transactions in
+    # which a partner is managing the API calls on behalf of a merchant, the
+    # partner must identify the merchant using either a PayPal-Auth-Assertion
+    # header or an access token with target_subject.</blockquote>
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def refunds_get(refund_id)
+    def refunds_get(options = {})
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::GET,
                                      '/v2/payments/refunds/{refund_id}',
                                      Server::DEFAULT)
-                   .template_param(new_parameter(refund_id, key: 'refund_id')
+                   .template_param(new_parameter(options['refund_id'], key: 'refund_id')
                                     .should_encode(true))
+                   .header_param(new_parameter(options['paypal_auth_assertion'], key: 'PayPal-Auth-Assertion'))
                    .header_param(new_parameter('application/json', key: 'accept'))
                    .auth(Single.new('Oauth2')))
         .response(new_response_handler

data/lib/paypal_server_sdk/controllers/vault_controller.rb

@@ -6,6 +6,48 @@
 module PaypalServerSdk
   # VaultController
   class VaultController < BaseController
+    # Creates a Payment Token from the given payment source and adds it to the
+    # Vault of the associated customer.
+    # @param [String] paypal_request_id Required parameter: The server stores
+    # keys for 3 hours.
+    # @param [PaymentTokenRequest] body Required parameter: Payment Token
+    # creation with a financial instrument and an optional customer_id.
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def payment_tokens_create(options = {})
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/v3/vault/payment-tokens',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter(options['paypal_request_id'], key: 'PayPal-Request-Id'))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(options['body']))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('Oauth2')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(PaymentTokenResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Request is not well-formed, syntactically incorrect, or'\
+                                  ' violates schema.',
+                                 ErrorException)
+                    .local_error('403',
+                                 'Authorization failed due to insufficient permissions.',
+                                 ErrorException)
+                    .local_error('404',
+                                 'Request contains reference to resources that do not exist.',
+                                 ErrorException)
+                    .local_error('422',
+                                 'The requested action could not be performed, semantically'\
+                                  ' incorrect, or failed business validation.',
+                                 ErrorException)
+                    .local_error('500',
+                                 'An internal server error has occurred.',
+                                 ErrorException))
+        .execute
+    end
+
     # Returns all payment tokens for a customer.
     # @param [String] customer_id Required parameter: A unique identifier
     # representing a specific customer in merchant's/partner's system or
@@ -79,27 +121,19 @@ module PaypalServerSdk
         .execute
     end
 
-    # Creates a Payment Token from the given payment source and adds it to the
-    # Vault of the associated customer.
-    # @param [String] paypal_request_id Required parameter: The server stores
-    # keys for 3 hours.
-    # @param [PaymentTokenRequest] body Required parameter: Payment Token
-    # creation with a financial instrument and an optional customer_id.
+    # Delete the payment token associated with the payment token id.
+    # @param [String] id Required parameter: ID of the payment token.
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def payment_tokens_create(options = {})
+    def payment_tokens_delete(id)
       new_api_call_builder
-        .request(new_request_builder(HttpMethodEnum::POST,
-                                     '/v3/vault/payment-tokens',
+        .request(new_request_builder(HttpMethodEnum::DELETE,
+                                     '/v3/vault/payment-tokens/{id}',
                                      Server::DEFAULT)
-                   .header_param(new_parameter(options['paypal_request_id'], key: 'PayPal-Request-Id'))
-                   .header_param(new_parameter('application/json', key: 'Content-Type'))
-                   .body_param(new_parameter(options['body']))
-                   .header_param(new_parameter('application/json', key: 'accept'))
-                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .template_param(new_parameter(id, key: 'id')
+                                    .should_encode(true))
                    .auth(Single.new('Oauth2')))
         .response(new_response_handler
-                    .deserializer(APIHelper.method(:custom_type_deserializer))
-                    .deserialize_into(PaymentTokenResponse.method(:from_hash))
+                    .is_response_void(true)
                     .is_api_response(true)
                     .local_error('400',
                                  'Request is not well-formed, syntactically incorrect, or'\
@@ -108,13 +142,6 @@ module PaypalServerSdk
                     .local_error('403',
                                  'Authorization failed due to insufficient permissions.',
                                  ErrorException)
-                    .local_error('404',
-                                 'Request contains reference to resources that do not exist.',
-                                 ErrorException)
-                    .local_error('422',
-                                 'The requested action could not be performed, semantically'\
-                                  ' incorrect, or failed business validation.',
-                                 ErrorException)
                     .local_error('500',
                                  'An internal server error has occurred.',
                                  ErrorException))
@@ -161,33 +188,6 @@ module PaypalServerSdk
         .execute
     end
 
-    # Delete the payment token associated with the payment token id.
-    # @param [String] id Required parameter: ID of the payment token.
-    # @return [ApiResponse]  the complete http response with raw body and status code.
-    def payment_tokens_delete(id)
-      new_api_call_builder
-        .request(new_request_builder(HttpMethodEnum::DELETE,
-                                     '/v3/vault/payment-tokens/{id}',
-                                     Server::DEFAULT)
-                   .template_param(new_parameter(id, key: 'id')
-                                    .should_encode(true))
-                   .auth(Single.new('Oauth2')))
-        .response(new_response_handler
-                    .is_response_void(true)
-                    .is_api_response(true)
-                    .local_error('400',
-                                 'Request is not well-formed, syntactically incorrect, or'\
-                                  ' violates schema.',
-                                 ErrorException)
-                    .local_error('403',
-                                 'Authorization failed due to insufficient permissions.',
-                                 ErrorException)
-                    .local_error('500',
-                                 'An internal server error has occurred.',
-                                 ErrorException))
-        .execute
-    end
-
     # Returns a readable representation of temporarily vaulted payment source
     # associated with the setup token id.
     # @param [String] id Required parameter: ID of the setup token.

data/lib/paypal_server_sdk/models/card_verification_details.rb

@@ -45,6 +45,12 @@ module PaypalServerSdk
     # @return [CardVerificationProcessorResponse]
     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.
+    # @return [Object]
+    attr_accessor :three_d_secure
+
     # A mapping from model property names to API property names.
     def self.names
       @_hash = {} if @_hash.nil?
@@ -54,6 +60,7 @@ module PaypalServerSdk
       @_hash['time'] = 'time'
       @_hash['amount'] = 'amount'
       @_hash['processor_response'] = 'processor_response'
+      @_hash['three_d_secure'] = 'three_d_secure'
       @_hash
     end
 
@@ -66,6 +73,7 @@ module PaypalServerSdk
         time
         amount
         processor_response
+        three_d_secure
       ]
     end
 
@@ -75,13 +83,15 @@ module PaypalServerSdk
     end
 
     def initialize(network_transaction_id: SKIP, date: SKIP, network: SKIP,
-                   time: SKIP, amount: SKIP, processor_response: SKIP)
+                   time: SKIP, amount: SKIP, processor_response: SKIP,
+                   three_d_secure: SKIP)
       @network_transaction_id = network_transaction_id unless network_transaction_id == SKIP
       @date = date unless date == SKIP
       @network = network unless network == SKIP
       @time = time unless time == SKIP
       @amount = amount unless amount == SKIP
       @processor_response = processor_response unless processor_response == SKIP
+      @three_d_secure = three_d_secure unless three_d_secure == SKIP
     end
 
     # Creates an instance of the object from a hash.
@@ -98,6 +108,8 @@ module PaypalServerSdk
       if hash['processor_response']
         processor_response = CardVerificationProcessorResponse.from_hash(hash['processor_response'])
       end
+      three_d_secure =
+        hash.key?('three_d_secure') ? hash['three_d_secure'] : SKIP
 
       # Create object from extracted values.
       CardVerificationDetails.new(network_transaction_id: network_transaction_id,
@@ -105,7 +117,8 @@ module PaypalServerSdk
                                   network: network,
                                   time: time,
                                   amount: amount,
-                                  processor_response: processor_response)
+                                  processor_response: processor_response,
+                                  three_d_secure: three_d_secure)
     end
   end
 end

data/lib/paypal_server_sdk/models/confirm_order_request.rb

@@ -14,8 +14,8 @@ module PaypalServerSdk
     # @return [PaymentSource]
     attr_accessor :payment_source
 
-    # The instruction to process an order.
-    # @return [ProcessingInstruction]
+    # The payment source definition.
+    # @return [Object]
     attr_accessor :processing_instruction
 
     # Customizes the payer confirmation experience.
@@ -44,11 +44,8 @@ module PaypalServerSdk
       []
     end
 
-    def initialize(
-      payment_source:,
-      processing_instruction: ProcessingInstruction::NO_INSTRUCTION,
-      application_context: SKIP
-    )
+    def initialize(payment_source:, processing_instruction: SKIP,
+                   application_context: SKIP)
       @payment_source = payment_source
       @processing_instruction = processing_instruction unless processing_instruction == SKIP
       @application_context = application_context unless application_context == SKIP
@@ -61,7 +58,7 @@ module PaypalServerSdk
       # Extract variables from the hash.
       payment_source = PaymentSource.from_hash(hash['payment_source']) if hash['payment_source']
       processing_instruction =
-        hash['processing_instruction'] ||= ProcessingInstruction::NO_INSTRUCTION
+        hash.key?('processing_instruction') ? hash['processing_instruction'] : SKIP
       application_context = OrderConfirmApplicationContext.from_hash(hash['application_context']) if
         hash['application_context']
 

data/lib/paypal_server_sdk/models/{fullfillment_type.rb → fulfillment_type.rb}

@@ -7,8 +7,8 @@ module PaypalServerSdk
   # A classification for the method of purchase fulfillment (e.g shipping,
   # in-store pickup, etc). Either `type` or `options` may be present, but not
   # both.
-  class FullfillmentType
-    FULLFILLMENT_TYPE = [
+  class FulfillmentType
+    FULFILLMENT_TYPE = [
       # TODO: Write general description for SHIPPING
       SHIPPING = 'SHIPPING'.freeze,
 

data/lib/paypal_server_sdk/models/google_pay_card.rb

@@ -0,0 +1,114 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # The payment card used to fund a Google Pay payment. Can be a credit or debit
+  # card.
+  class GooglePayCard < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The card holder's name as it appears on the card.
+    # @return [String]
+    attr_accessor :name
+
+    # The primary account number (PAN) for the payment card.
+    # @return [String]
+    attr_accessor :number
+
+    # The year and month, in ISO-8601 `YYYY-MM` date format. See [Internet date
+    # and time format](https://tools.ietf.org/html/rfc3339#section-5.6).
+    # @return [String]
+    attr_accessor :expiry
+
+    # The last digits of the payment card.
+    # @return [String]
+    attr_accessor :last_digits
+
+    # Type of card. i.e Credit, Debit and so on.
+    # @return [CardType]
+    attr_accessor :type
+
+    # The card network or brand. Applies to credit, debit, gift, and payment
+    # cards.
+    # @return [CardBrand]
+    attr_accessor :brand
+
+    # The portable international postal address. Maps to
+    # [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/
+    # wiki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls:
+    # the autocomplete
+    # attribute](https://www.w3.org/TR/html51/sec-forms.html#autofilling-form-co
+    # ntrols-the-autocomplete-attribute).
+    # @return [PortablePostalAddressMediumGrained]
+    attr_accessor :billing_address
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['name'] = 'name'
+      @_hash['number'] = 'number'
+      @_hash['expiry'] = 'expiry'
+      @_hash['last_digits'] = 'last_digits'
+      @_hash['type'] = 'type'
+      @_hash['brand'] = 'brand'
+      @_hash['billing_address'] = 'billing_address'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        name
+        number
+        expiry
+        last_digits
+        type
+        brand
+        billing_address
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(name: SKIP, number: SKIP, expiry: SKIP, last_digits: SKIP,
+                   type: SKIP, brand: SKIP, billing_address: SKIP)
+      @name = name unless name == SKIP
+      @number = number unless number == SKIP
+      @expiry = expiry unless expiry == SKIP
+      @last_digits = last_digits unless last_digits == SKIP
+      @type = type unless type == SKIP
+      @brand = brand unless brand == SKIP
+      @billing_address = billing_address unless billing_address == 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.
+      name = hash.key?('name') ? hash['name'] : SKIP
+      number = hash.key?('number') ? hash['number'] : SKIP
+      expiry = hash.key?('expiry') ? hash['expiry'] : SKIP
+      last_digits = hash.key?('last_digits') ? hash['last_digits'] : SKIP
+      type = hash.key?('type') ? hash['type'] : SKIP
+      brand = hash.key?('brand') ? hash['brand'] : SKIP
+      billing_address = PortablePostalAddressMediumGrained.from_hash(hash['billing_address']) if
+        hash['billing_address']
+
+      # Create object from extracted values.
+      GooglePayCard.new(name: name,
+                        number: number,
+                        expiry: expiry,
+                        last_digits: last_digits,
+                        type: type,
+                        brand: brand,
+                        billing_address: billing_address)
+    end
+  end
+end