1 // Copyright 2013 The Chromium Authors. All rights reserved. 2 // Use of this source code is governed by a BSD-style license that can be 3 // found in the LICENSE file. 4 5 #ifndef COMPONENTS_AUTOFILL_CONTENT_BROWSER_WALLET_FULL_WALLET_H_ 6 #define COMPONENTS_AUTOFILL_CONTENT_BROWSER_WALLET_FULL_WALLET_H_ 7 8 #include <string> 9 #include <vector> 10 11 #include "base/basictypes.h" 12 #include "base/gtest_prod_util.h" 13 #include "base/memory/scoped_ptr.h" 14 #include "base/strings/string16.h" 15 #include "components/autofill/content/browser/wallet/required_action.h" 16 #include "components/autofill/content/browser/wallet/wallet_address.h" 17 18 namespace base { 19 class DictionaryValue; 20 } 21 22 namespace autofill { 23 24 class AutofillType; 25 26 namespace wallet { 27 28 class FullWalletTest; 29 30 // FullWallet contains all the information a merchant requires from a user for 31 // that user to make a purchase. This includes: 32 // - billing information 33 // - shipping information 34 // - a proxy card for the backing card selected from a user's wallet items 35 class FullWallet { 36 public: 37 ~FullWallet(); 38 39 // Returns an empty scoped_ptr if the input invalid, an empty wallet with 40 // required actions if there are any, or a valid wallet. 41 static scoped_ptr<FullWallet> 42 CreateFullWallet(const base::DictionaryValue& dictionary); 43 44 // Returns a wallet built from the provided clear-text data. 45 // Data is not validated; |pan|, |cvn| and |billing_address| must be set. 46 static scoped_ptr<FullWallet> 47 CreateFullWalletFromClearText(int expiration_month, 48 int expiration_year, 49 const std::string& pan, 50 const std::string& cvn, 51 scoped_ptr<Address> billing_address, 52 scoped_ptr<Address> shipping_address); 53 54 // Returns corresponding data for |type|. 55 base::string16 GetInfo(const std::string& app_locale, 56 const AutofillType& type); 57 58 // Whether or not |action| is in |required_actions_|. 59 bool HasRequiredAction(RequiredAction action) const; 60 61 // The type of the card that this FullWallet contains and the last four digits 62 // like this "Visa - 4111". 63 base::string16 TypeAndLastFourDigits(); 64 65 // Decrypts and returns the primary account number (PAN) using the generated 66 // one time pad, |one_time_pad_|. 67 const std::string& GetPan(); 68 69 bool operator==(const FullWallet& other) const; 70 bool operator!=(const FullWallet& other) const; 71 72 // If there are required actions |billing_address_| might contain NULL. 73 const Address* billing_address() const { return billing_address_.get(); } 74 75 // If there are required actions or shipping address is not required 76 // |shipping_address_| might contain NULL. 77 const Address* shipping_address() const { return shipping_address_.get(); } 78 79 const std::vector<RequiredAction>& required_actions() const { 80 return required_actions_; 81 } 82 int expiration_month() const { return expiration_month_; } 83 int expiration_year() const { return expiration_year_; } 84 85 void set_one_time_pad(const std::vector<uint8>& one_time_pad) { 86 one_time_pad_ = one_time_pad; 87 } 88 89 private: 90 friend class FullWalletTest; 91 friend scoped_ptr<FullWallet> GetTestFullWalletWithRequiredActions( 92 const std::vector<RequiredAction>& action); 93 friend scoped_ptr<FullWallet> GetTestFullWalletInstrumentOnly(); 94 FRIEND_TEST_ALL_PREFIXES(FullWalletTest, CreateFullWallet); 95 FRIEND_TEST_ALL_PREFIXES(FullWalletTest, CreateFullWalletWithRequiredActions); 96 FRIEND_TEST_ALL_PREFIXES(FullWalletTest, RestLengthCorrectDecryptionTest); 97 FRIEND_TEST_ALL_PREFIXES(FullWalletTest, RestLengthUnderDecryptionTest); 98 FRIEND_TEST_ALL_PREFIXES(FullWalletTest, GetCreditCardInfo); 99 100 FullWallet(int expiration_month, 101 int expiration_year, 102 const std::string& iin, 103 const std::string& encrypted_rest, 104 scoped_ptr<Address> billing_address, 105 scoped_ptr<Address> shipping_address, 106 const std::vector<RequiredAction>& required_actions); 107 108 // Decrypts both |pan_| and |cvn_|. 109 void DecryptCardInfo(); 110 111 // Decrypts and returns the card verification number (CVN) using the generated 112 // one time pad, |one_time_pad_|. 113 const std::string& GetCvn(); 114 115 // The expiration month of the proxy card. It should be 1-12. 116 int expiration_month_; 117 118 // The expiration year of the proxy card. It should be a 4-digit year. 119 int expiration_year_; 120 121 // Primary account number (PAN). Its format is \d{16}. 122 std::string pan_; 123 124 // Card verification number (CVN). Its format is \d{3}. 125 std::string cvn_; 126 127 // Issuer identification number (IIN). Its format is \d{6}. 128 std::string iin_; 129 130 // Encrypted concatentation of CVN and PAN without IIN 131 std::string encrypted_rest_; 132 133 // The billing address of the backing instrument. 134 scoped_ptr<Address> billing_address_; 135 136 // The shipping address for the transaction. 137 scoped_ptr<Address> shipping_address_; 138 139 // Actions that must be completed by the user before a FullWallet can be 140 // issued to them by the Online Wallet service. 141 std::vector<RequiredAction> required_actions_; 142 143 // The one time pad used for FullWallet encryption. 144 std::vector<uint8> one_time_pad_; 145 146 DISALLOW_COPY_AND_ASSIGN(FullWallet); 147 }; 148 149 } // namespace wallet 150 } // namespace autofill 151 152 #endif // COMPONENTS_AUTOFILL_CONTENT_BROWSER_WALLET_FULL_WALLET_H_ 153