PageRenderTime 66ms CodeModel.GetById 20ms RepoModel.GetById 0ms app.codeStats 0ms

/phpPayPal.php

https://github.com/cmarkell/phpPayPal
PHP | 2319 lines | 1622 code | 301 blank | 396 comment | 71 complexity | 145fdb527f4c2286ab6ac1503de3f225 MD5 | raw file
    

  1. <?php
    2. 

  2. 

  3. /*
    4. 

  4. 	Created by Drew Johnston, 2007, drewjoh.com
    5. 

  5. 	
    6. 

  6. 	Please give credit where credit is due. :)
    7. 

  7. 	
    8. 

  8. 	Licensed under the Apache License, Version 2.0 (the "License"); 
    9. 

  9. 	you may not use this file except in compliance with the License. 
    10. 

  10. 	You may obtain a copy of the License at 
    11. 

  11. 	
    12. 

  12. 		http://www.apache.org/licenses/LICENSE-2.0 
    13. 

  13. 	
    14. 

  14. 	Unless required by applicable law or agreed to in writing, software 
    15. 

  15. 	distributed under the License is distributed on an "AS IS" BASIS, 
    16. 

  16. 	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
    17. 

  17. 	See the License for the specific language governing permissions and 
    18. 

  18. 	limitations under the License.
    19. 

  19. 	
    20. 

  20. 	Get, Create and Update Recurring Payment Profiles available thanks to Bill Joslin (billjoslin.com)!
    21. 

  21. */
    22. 

  22. 

  23. class phpPayPal { 
    24. 

  24. 	
    25. 

  25. 	// ---------------------------
    26. 

  26. 	// PRIVATE VARIABLES
    27. 

  27. 	// ---------------------------
    28. 

  28. 	// NOTE: LIVE and SANDBOX variables are included.  Sandbox is enabled by default.
    29. 

  29. 	
    30. 

  30. 	private $sandbox	= TRUE;
    31. 

  31. 	private $live		= FALSE;
    32. 

  32. 	
    33. 

  33. 		public $API_USERNAME = NULL;
    34. 

  34. 		public $API_PASSWORD = NULL;
    35. 

  35. 		public $API_SIGNATURE = NULL;
    36. 

  36. 		
    37. 

  37. 		private $API_ENDPOINT = NULL;
    38. 

  38. 		
    39. 

  39. 		public $USE_PROXY = NULL;
    40. 

  40. 		public $PROXY_HOST = NULL;
    41. 

  41. 		public $PROXY_PORT = NULL;
    42. 

  42. 		
    43. 

  43. 		private $PAYPAL_URL = NULL;
    44. 

  44. 		
    45. 

  45. 		public $return_url = NULL;
    46. 

  46. 		public $cancel_url = NULL;
    47. 

  47. 		
    48. 

  48. 		public $VERSION = '3.0';
    49. 

  49. 	
    50. 

  50. 	
    51. 

  51. 	
    52. 

  52. 	
    53. 

  53. 	// ----------------------------
    54. 

  54. 	// PUBLIC VARIABLES
    55. 

  55. 	// ----------------------------
    56. 

  56. 	
    57. 

  57. 	// Array of the response variables from PayPal requests
    58. 

  58. 	public $Response;
    59. 

  59. 	
    60. 

  60. 	/* 	-------------------
    61. 

  61. 		ERROR VARIABLES
    62. 

  62. 		-------------------
    63. 

  63. 		- $Error = an array of PayPal's response to any paypal errors
    64. 

  64. 		- All $_error's = are filled for any error that occurs, including PayPal errors
    65. 

  65. 		- If a method returns false, the $_error's should be filled with error information
    66. 

  66. 	*/
    67. 

  67. 	
    68. 

  68. 	// Array of the error response from PayPal - [TIMESTAMP] [CORRELATIONID] [ACK] [L_ERRORCODE0] [L_SHORTMESSAGE0] [L_LONGMESSAGE0] [L_SEVERITYCODE0] [VERSION] [BUILD]
    69. 

  69. 	public $Error; 
    70. 

  70. 	
    71. 

  71. 	public $_error = false;
    72. 

  72. 	public $_error_ack;
    73. 

  73. 	public $_error_type;
    74. 

  74. 	public $_error_date;
    75. 

  75. 	public $_error_code;
    76. 

  76. 	public $_error_short_message;
    77. 

  77. 	public $_error_long_message;
    78. 

  78. 	public $_error_corrective_action;
    79. 

  79. 	public $_error_severity_code;
    80. 

  80. 	public $_error_version;
    81. 

  81. 	public $_error_build; 
    82. 

  82. 	public $_error_display_message;
    83. 

  83. 	
    84. 

  84. 	/*	----------------------
    85. 

  85. 		REQUEST VARIABLES
    86. 

  86. 		----------------------
    87. 

  87. 		- All values found in a Request
    88. 

  88. 		- Format is  $our_variable_name; // PAYPALS_VARIABLE_NAME
    89. 

  89. 	*/
    90. 

  90. 	
    91. 

  91. 	public $payment_type = 'Sale'; // PAYMENTTYPE
    92. 

  92. 	
    93. 

  93. 	public $email; // EMAIL
    94. 

  94. 	public $salutation; // SALUTATION
    95. 

  95. 	public $first_name; // FIRSTNAME
    96. 

  96. 	public $middle_name; // MIDDLENAME
    97. 

  97. 	public $last_name; // LASTNAME
    98. 

  98. 	public $suffix; // SUFFIX
    99. 

  99. 	public $credit_card_type; // CREDITCARDTYPE --- Visa, MasterCard, Discover, Amex, Switch, Solo
    100. 

  100. 	public $credit_card_number; // ACCT
    101. 

  101. 	public $expire_date;  // EXPDATE - MMYYYY
    102. 

  102. 	public $cvv2_code; // CVV2
    103. 

  103. 	public $address1; // STREET
    104. 

  104. 	public $address2; // STREET2
    105. 

  105. 	public $city; // CITY
    106. 

  106. 	public $state; // STATE
    107. 

  107. 	public $postal_code; // ZIP
    108. 

  108. 	public $phone_number; // PHONENUM
    109. 

  109. 	
    110. 

  110. 	public $country_code; // COUNTRYCODE
    111. 

  111. 	
    112. 

  112. 	public $currency_code = "USD"; // CURRENCYCODE
    113. 

  113. 	
    114. 

  114. 	public $ip_address; //IPADDRESS
    115. 

  115. 	
    116. 

  116. 	public $amount_total; // AMT
    117. 

  117. 	public $amount_shipping; // SHIPPINGAMT
    118. 

  118. 	public $amount_handling; // HANDLINGAMT
    119. 

  119. 	public $amount_tax; // TAXAMT
    120. 

  120. 	public $amount_sales_tax; // SALESTAX - This is apparently only used with getTransactionDetails, and appears to be the same as amount_tax
    121. 

  121. 	public $amount_items; // ITEMAMT
    122. 

  122. 	public $amount_max; // MAXAMT
    123. 

  123. 	public $amount_fee; // FEEAMT
    124. 

  124. 	public $amount_settle; // SETTLEAMT
    125. 

  125. 	public $amount_refund_net; // NETREFUNDAMT
    126. 

  126. 	public $amount_refund_fee; // FEEREFUNDAMT
    127. 

  127. 	public $amount_refund_total; // GROSSREFUNDAMT
    128. 

  128. 	
    129. 

  129. 	public $billing_type;
    130. 

  130. 	public $billing_agreement;
    131. 

  131. 	
    132. 

  132. 	public $shipping_name; // SHIPTONAME
    133. 

  133. 	public $shipping_address1; // SHIPTOSTREET
    134. 

  134. 	public $shipping_address2; // SHIPTOSTREET2
    135. 

  135. 	public $shipping_city; // SHIPTOCITY
    136. 

  136. 	public $shipping_state; // SHIPTOSTATE
    137. 

  137. 	public $shipping_postal_code; // SHIPTOZIP
    138. 

  138. 	public $shipping_country_code; // SHIPTOCOUNTRYCODE
    139. 

  139. 	public $shipping_country_name;
    140. 

  140. 	public $shipping_phone_number; // SHIPTOPHONENUM
    141. 

  141. 	
    142. 

  142. 	public $description; // DESC
    143. 

  143. 	public $custom; // CUSTOM
    144. 

  144. 	public $invoice_number; // INVNUM
    145. 

  145. 	
    146. 

  146. 	public $note; // NOTE
    147. 

  147. 	
    148. 

  148. 	public $notify_url; // NOTIFYURL
    149. 

  149. 	public $require_confirmed_shipping_address; // REQCONFIRMSHIPPING
    150. 

  150. 	public $no_shipping; // NOSHIPPING
    151. 

  151. 	public $address_override; // ADDROVERRIDE
    152. 

  152. 	public $local_code; // LOCALECODE
    153. 

  153. 	public $page_style; // PAGESTYLE
    154. 

  154. 	public $hdr_image; // HDRIMG
    155. 

  155. 	public $hdr_border_color; //HDRBORDERCOLOR
    156. 

  156. 	public $hdr_back_color; // HDRBACKCOLOR
    157. 

  157. 	public $payflow_color; // PAYFLOWCOLOR
    158. 

  158. 	public $channel_type; // CHANNELTYPE
    159. 

  159. 	public $solution_type; // SOLUTIONTYPE
    160. 

  160. 	public $user_action; // USERACTION
    161. 

  161. 	
    162. 

  162. 	public $return_fmf_details = 0; // RETURNFMFDETAILS - 0 by default
    163. 

  163. 	
    164. 

  164. 	 // Variables found in Authorize and Capture
    165. 

  165. 	
    166. 

  166. 	public $authorization_id; // AUTHORIZATIONID
    167. 

  167. 	public $complete_type; // COMPLETETYPE
    168. 

  168. 	public $soft_descriptor; // SOFTDESCRIPTOR
    169. 

  169. 	public $transaction_entity; // TRANSACTIONENTITY
    170. 

  170. 	
    171. 

  171. 	
    172. 

  172. 	 // Variables that are returned to us
    173. 

  173. 	
    174. 

  174. 	public $ack;
    175. 

  175. 	public $token; // TOKEN
    176. 

  176. 	public $payer_id; // PAYERID
    177. 

  177. 	public $payer_status; // PAYERSTATUS
    178. 

  178. 	public $payer_business; // PAYERBUSINESS
    179. 

  179. 	public $address_owner; // ADDRESSOWNER
    180. 

  180. 	public $address_status; // ADDRESSSTATUS
    181. 

  181. 	public $address_id;
    182. 

  182. 	public $business; // BUSINESS
    183. 

  183. 	
    184. 

  184. 	public $avs_code;
    185. 

  185. 	public $cvv2_match;
    186. 

  186. 	
    187. 

  187. 	public $transaction_id; // TRANSACTIONID
    188. 

  188. 	public $parent_transaction_id; // PARENTTRANSACTIONID
    189. 

  189. 	public $refund_transaction_id; // REFUNDTRANSACTIONID
    190. 

  190. 	public $transaction_type; // TRANSACTIONTYPE
    191. 

  191. 	public $payment_status; // PAYMENTSTATUS
    192. 

  192. 	public $payment_pending_reason; // PENDINGREASON
    193. 

  193. 	public $payment_reason_code; // REASONCODE
    194. 

  194. 	public $order_time; // ORDERTIME
    195. 

  195. 	public $timestamp;
    196. 

  196. 	
    197. 

  197. 	public $exchange_rate; // EXCHANGERATE
    198. 

  198. 	
    199. 

  199. 	public $receipt_id; // RECEIPTID
    200. 

  200. 	
    201. 

  201. 	public $receiver_business; // RECEIVERBUSINESS
    202. 

  202. 	public $receiver_email; // RECEIVEREMAIL
    203. 

  203. 	public $receiver_id; // RECEIVERID
    204. 

  204. 	
    205. 

  205. 	public $subscription_id; // SUBSCRIPTIONID
    206. 

  206. 	public $subscription_date; // SUBSCRIPTIONDATE
    207. 

  207. 	public $effective_date; // EFFECTIVEDATE
    208. 

  208. 	public $retry_time; // RETRYTIME
    209. 

  209. 	public $user_name; // USERNAME
    210. 

  210. 	public $password; // PASSWORD
    211. 

  211. 	public $recurrences; // RECURRENCES
    212. 

  212. 	public $reattempt; // REATTEMPT
    213. 

  213. 	public $recurring; // RECURRING
    214. 

  214. 	public $period; // PERIOD
    215. 

  215. 	public $buyer_id; // BUYERID
    216. 

  216. 	public $closing_date; // CLOSINGDATE
    217. 

  217. 	public $multi_item; // MULTIITEM
    218. 

  218. 	
    219. 

  219. 	public $refund_type; // REFUNDTYPE
    220. 

  220. 	
    221. 

  221. 	// Other
    222. 

  222. 	
    223. 

  223. 	public $build;
    224. 

  224. 	public $version;
    225. 

  225. 	public $correlation_id;
    226. 

  226. 	
    227. 

  227. 	/*
    228. 

  228. 		This is the Items array, contains KEY => VALUE pairs for NAME => VALUE of items where NAME = name of item variable
    229. 

  229. 		Names include: name, number, quantity, amount_tax, amount_total
    230. 

  230. 	*/
    231. 

  231. 	public $ItemsArray;
    232. 

  232. 	
    233. 

  233. 	
    234. 

  234. 	/*	-----------------------
    235. 

  235. 		COUNTRY NAMES & CODES
    236. 

  236. 		-----------------------
    237. 

  237. 		- This is an array of country names and their country codes
    238. 

  238. 		- Organized in CODE => NAME format ($countries[COUNTRY_CODE] = COUNTRY_NAME)
    239. 

  239. 		- This is purely for informational purposes, the class itself doesn't use these.  
    240. 

  240. 		- PayPal does use the country CODES when sending address information; can come in very handy then.
    241. 

  241. 		- List should include all countries that PayPal accepts payments from.
    242. 

  242. 	*/
    243. 

  243. 	
    244. 

  244. 	public $countries = array ("US"=>"United States","AL"=>"Albania","DZ"=>"Algeria","AS"=>"American Samoa","AD"=>"Andorra","AI"=>"Anguilla","AG"=>"Antigua and Barbuda","AR"=>"Argentina","AM"=>"Armenia","AW"=>"Aruba","AU"=>"Australia","AT"=>"Austria","AZ"=>"Azerbaijan Republic","BS"=>"Bahamas","BH"=>"Bahrain","BD"=>"Bangladesh","BB"=>"Barbados","BY"=>"Belarus","BE"=>"Belgium","BZ"=>"Belize","BJ"=>"Benin","BM"=>"Bermuda","BO"=>"Bolivia","BA"=>"Bosnia and Herzegovina","BW"=>"Botswana","BR"=>"Brazil","VG"=>"British Virgin Islands","BN"=>"Brunei","BG"=>"Bulgaria","BF"=>"Burkina Faso","KH"=>"Cambodia","CM"=>"Cameroon","CA"=>"Canada","CV"=>"Cape Verde","KY"=>"Cayman Islands","CL"=>"Chile","C2"=>"China","CO"=>"Colombia","CK"=>"Cook Islands","CR"=>"Costa Rica","CI"=>"Cote D'Ivoire","HR"=>"Croatia","CY"=>"Cyprus","CZ"=>"Czech Republic","DK"=>"Denmark","DJ"=>"Djibouti","DM"=>"Dominica","DO"=>"Dominican Republic","TP"=>"East Timor","EC"=>"Ecuador","EG"=>"Egypt","SV"=>"El Salvador","EE"=>"Estonia","FM"=>"Federated States of Micronesia","FJ"=>"Fiji","FI"=>"Finland","FR"=>"France","GF"=>"French Guiana","PF"=>"French Polynesia","GA"=>"Gabon Republic","GE"=>"Georgia","DE"=>"Germany","GH"=>"Ghana","GI"=>"Gibraltar","GR"=>"Greece","GD"=>"Grenada","GP"=>"Guadeloupe","GU"=>"Guam","GT"=>"Guatemala","GN"=>"Guinea","GY"=>"Guyana","HT"=>"Haiti","HN"=>"Honduras","HK"=>"Hong Kong","HU"=>"Hungary","IS"=>"Iceland","IN"=>"India","ID"=>"Indonesia","IE"=>"Ireland","IL"=>"Israel","IT"=>"Italy","JM"=>"Jamaica","JP"=>"Japan","JO"=>"Jordan","KZ"=>"Kazakhstan","KE"=>"Kenya","KW"=>"Kuwait","LA"=>"Laos","LV"=>"Latvia","LB"=>"Lebanon","LS"=>"Lesotho","LT"=>"Lithuania","LU"=>"Luxembourg","MO"=>"Macau","MK"=>"Macedonia","MG"=>"Madagascar","MY"=>"Malaysia","MV"=>"Maldives","ML"=>"Mali","MT"=>"Malta","MH"=>"Marshall Islands","MQ"=>"Martinique","MU"=>"Mauritius","MX"=>"Mexico","MD"=>"Moldova","MN"=>"Mongolia","MS"=>"Montserrat","MA"=>"Morocco","MZ"=>"Mozambique","NA"=>"Namibia","NP"=>"Nepal","NL"=>"Netherlands","AN"=>"Netherlands Antilles","NZ"=>"New Zealand","NI"=>"Nicaragua","MP"=>"Northern Mariana Islands","NO"=>"Norway","OM"=>"Oman","PK"=>"Pakistan","PW"=>"Palau","PS"=>"Palestine","PA"=>"Panama","PG"=>"Papua New Guinea","PY"=>"Paraguay","PE"=>"Peru","PH"=>"Philippines","PL"=>"Poland","PT"=>"Portugal","PR"=>"Puerto Rico","QA"=>"Qatar","RO"=>"Romania","RU"=>"Russia","RW"=>"Rwanda","VC"=>"Saint Vincent and the Grenadines","WS"=>"Samoa","SA"=>"Saudi Arabia","SN"=>"Senegal","CS"=>"Serbia and Montenegro","SC"=>"Seychelles","SG"=>"Singapore","SK"=>"Slovakia","SI"=>"Slovenia","SB"=>"Solomon Islands","ZA"=>"South Africa","KR"=>"South Korea","ES"=>"Spain","LK"=>"Sri Lanka","KN"=>"St. Kitts and Nevis","LC"=>"St. Lucia","SZ"=>"Swaziland","SE"=>"Sweden","CH"=>"Switzerland","TW"=>"Taiwan","TZ"=>"Tanzania","TH"=>"Thailand","TG"=>"Togo","TO"=>"Tonga","TT"=>"Trinidad and Tobago","TN"=>"Tunisia","TR"=>"Turkey","TM"=>"Turkmenistan","TC"=>"Turks and Caicos Islands","UG"=>"Uganda","UA"=>"Ukraine","AE"=>"United Arab Emirates","GB"=>"United Kingdom","UY"=>"Uruguay","UZ"=>"Uzbekistan","VU"=>"Vanuatu","VE"=>"Venezuela","VN"=>"Vietnam","VI"=>"Virgin Islands (USA)","YE"=>"Yemen","ZM"=>"Zambia");
    245. 

  245. 	
    246. 

  246. 	
    247. 

  247. 	/*	--------------------
    248. 

  248. 		STATES
    249. 

  249. 		--------------------
    250. 

  250. 		- States for certain countries, many of these are required formats for PayPal
    251. 

  251. 		- Multidimensional array
    252. 

  252. 		- $states[COUNTRY_CODE][STATE_CODE] = STATE_NAME
    253. 

  253. 	*/
    254. 

  254. 	
    255. 

  255. 	public $states = array(
    256. 

  256. 		'US' => array ("AK"=>"AK","AL"=>"AL","AR"=>"AR","AZ"=>"AZ","CA"=>"CA","CO"=>"CO","CT"=>"CT","DC"=>"DC","DE"=>"DE","FL"=>"FL","GA"=>"GA","HI"=>"HI",
    257. 

  257. 					"IA"=>"IA","ID"=>"ID","IL"=>"IL","IN"=>"IN","KS"=>"KS","KY"=>"KY","LA"=>"LA","MA"=>"MA","MD"=>"MD","ME"=>"ME","MI"=>"MI","MN"=>"MN",
    258. 

  258. 					"MO"=>"MO","MS"=>"MS","MT"=>"MT","NC"=>"NC","ND"=>"ND","NE"=>"NE","NH"=>"NH","NJ"=>"NJ","NM"=>"NM","NV"=>"NV","NY"=>"NY","OH"=>"OH",
    259. 

  259. 					"OK"=>"OK","OR"=>"OR","PA"=>"PA","RI"=>"RI","SC"=>"SC","SD"=>"SD","TN"=>"TN","TX"=>"TX","UT"=>"UT","VA"=>"VA","VT"=>"VT","WA"=>"WA",
    260. 

  260. 					"WI"=>"WI","WV"=>"WV","WY"=>"WY","AA"=>"AA","AE"=>"AE","AP"=>"AP","AS"=>"AS","FM"=>"FM","GU"=>"GU","MH"=>"MH","MP"=>"MP","PR"=>"PR",
    261. 

  261. 					"PW"=>"PW","VI"=>"VI")
    262. 

  262. 				,
    263. 

  263. 		'CA' => array ("AB"=>"Alberta", "BC"=>"British Columbia", "MB"=>"Manitoba", "NB"=>"New Brunswick", "NL"=>"Newfoundland", "NS"=>"Nova Scotia", 
    264. 

  264. 					"NU"=>"Nunavut", "NT"=>"Northwest Territories", "ON"=>"Ontario", "PE"=>"Prince Edward Island", "QC"=>"Quebec", "SK"=>"Saskatchewan", 
    265. 

  265. 					"YT"=>"Yukon")
    266. 

  266. 				,
    267. 

  267. 		'AU' => array ("Australian Capital Territory"=>"Australian Capital Territory","New South Wales"=>"New South Wales","Northern Territory"=>"Northern Territory",
    268. 

  268. 					"Queensland"=>"Queensland","South Australia"=>"South Australia","Tasmania"=>"Tasmania","Victoria"=>"Victoria","Western Australia"=>"Western Australia")
    269. 

  269. 				,
    270. 

  270. 		'GB' => array ("Aberdeen City"=>"Aberdeen City","Aberdeenshire"=>"Aberdeenshire","Angus"=>"Angus","Antrim"=>"Antrim","Argyll and Bute"=>"Argyll and Bute",
    271. 

  271. 					"Armagh"=>"Armagh","Avon"=>"Avon","Bedfordshire"=>"Bedfordshire","Berkshire"=>"Berkshire","Blaenau Gwent"=>"Blaenau Gwent","Borders"=>"Borders",
    272. 

  272. 					"Bridgend"=>"Bridgend","Bristol"=>"Bristol","Buckinghamshire"=>"Buckinghamshire","Caerphilly"=>"Caerphilly","Cambridgeshire"=>"Cambridgeshire",
    273. 

  273. 					"Cardiff"=>"Cardiff","Carmarthenshire"=>"Carmarthenshire","Ceredigion"=>"Ceredigion","Channel Islands"=>"Channel Islands","Cheshire"=>"Cheshire",
    274. 

  274. 					"Clackmannan"=>"Clackmannan","Cleveland"=>"Cleveland","Conwy"=>"Conwy","Cornwall"=>"Cornwall","Cumbria"=>"Cumbria","Denbighshire"=>"Denbighshire",
    275. 

  275. 					"Derbyshire"=>"Derbyshire","Devon"=>"Devon","Dorset"=>"Dorset","Down"=>"Down","Dumfries and Galloway"=>"Dumfries and Galloway","Durham"=>"Durham",
    276. 

  276. 					"East Ayrshire"=>"East Ayrshire","East Dunbartonshire"=>"East Dunbartonshire","East Lothian"=>"East Lothian","East Renfrewshire"=>"East Renfrewshire",
    277. 

  277. 					"East Riding of Yorkshire"=>"East Riding of Yorkshire","East Sussex"=>"East Sussex","Edinburgh City"=>"Edinburgh City","Essex"=>"Essex",
    278. 

  278. 					"Falkirk"=>"Falkirk","Fermanagh"=>"Fermanagh","Fife"=>"Fife","Flintshire"=>"Flintshire","Glasgow"=>"Glasgow","Gloucestershire"=>"Gloucestershire",
    279. 

  279. 					"Greater Manchester"=>"Greater Manchester","Gwynedd"=>"Gwynedd","Hampshire"=>"Hampshire","Herefordshire"=>"Herefordshire",
    280. 

  280. 					"Hertfordshire"=>"Hertfordshire","Highland"=>"Highland","Humberside"=>"Humberside","Inverclyde"=>"Inverclyde","Isle of Anglesey"=>"Isle of Anglesey",
    281. 

  281. 					"Isle of Man"=>"Isle of Man","Isle of Wight"=>"Isle of Wight","Isles of Scilly"=>"Isles of Scilly","Kent"=>"Kent","Lancashire"=>"Lancashire",
    282. 

  282. 					"Leicestershire"=>"Leicestershire","Lincolnshire"=>"Lincolnshire","London"=>"London","Londonderry"=>"Londonderry","Merseyside"=>"Merseyside",
    283. 

  283. 					"Merthyr Tydfil"=>"Merthyr Tydfil","Middlesex"=>"Middlesex","Midlothian"=>"Midlothian","Monmouthshire"=>"Monmouthshire","Moray"=>"Moray",
    284. 

  284. 					"Neath Port Talbot"=>"Neath Port Talbot","Newport"=>"Newport","Norfolk"=>"Norfolk","North Ayrshire"=>"North Ayrshire",
    285. 

  285. 					"North Lanarkshire"=>"North Lanarkshire","North Yorkshire"=>"North Yorkshire","Northamptonshire"=>"Northamptonshire","Northumberland"=>"Northumberland",
    286. 

  286. 					"Nottinghamshire"=>"Nottinghamshire","Orkney"=>"Orkney","Oxfordshire"=>"Oxfordshire","Pembrokeshire"=>"Pembrokeshire",
    287. 

  287. 					"Perthshire and Kinross"=>"Perthshire and Kinross","Powys"=>"Powys","Renfrewshire"=>"Renfrewshire","Rhondda Cynon Taff"=>"Rhondda Cynon Taff",
    288. 

  288. 					"Rutland"=>"Rutland","Shetland"=>"Shetland","Shropshire"=>"Shropshire","Somerset"=>"Somerset","South Ayrshire"=>"South Ayrshire",
    289. 

  289. 					"South Lanarkshire"=>"South Lanarkshire","South Yorkshire"=>"South Yorkshire","Staffordshire"=>"Staffordshire","Stirling"=>"Stirling",
    290. 

  290. 					"Suffolk"=>"Suffolk","Surrey"=>"Surrey","Swansea"=>"Swansea","The Vale of Glamorgan"=>"The Vale of Glamorgan","Tofaen"=>"Tofaen",
    291. 

  291. 					"Tyne and Wear"=>"Tyne and Wear","Tyrone"=>"Tyrone","Warwickshire"=>"Warwickshire","West Dunbartonshire"=>"West Dunbartonshire",
    292. 

  292. 					"West Lothian"=>"West Lothian","West Midlands"=>"West Midlands","West Sussex"=>"West Sussex","West Yorkshire"=>"West Yorkshire",
    293. 

  293. 					"Western Isles"=>"Western Isles","Wiltshire"=>"Wiltshire","Worcestershire"=>"Worcestershire","Wrexham"=>"Wrexham")
    294. 

  294. 				,
    295. 

  295. 		'ES' => array ("Alava" => "Alava", "Albacete" => "Albacete", "Alicante" => "Alicante", "Almeria" => "Almeria", "Asturias" => "Asturias", 
    296. 

  296. 					"Avila" => "Avila", "Badajoz" => "Badajoz", "Barcelona" => "Barcelona", "Burgos" => "Burgos", "Caceres" => "Caceres", 
    297. 

  297. 					"Cadiz" => "Cadiz", "Cantabria" => "Cantabria", "Castellon" => "Castellon", "Ceuta" => "Ceuta", "Ciudad Real" => "Ciudad Real", 
    298. 

  298. 					"Cordoba" => "Cordoba", "Cuenca" => "Cuenca", "Guadalajara" => "Guadalajara", "Gerona" => "Gerona", "Granada" => "Granada", 
    299. 

  299. 					"Guipuzcoa" => "Guipuzcoa", "Huelva" => "Huelva", "Huesca" => "Huesca", "Islas Baleares" => "Islas Baleares", "Jaen" => "Jaen", 
    300. 

  300. 					"La Coruna" => "La Coruna", "Las Palmas" => "Las Palmas", "La Rioja" => "La Rioja", "Leon" => "Leon", "Lerida" => "Lerida", 
    301. 

  301. 					"Lugo" => "Lugo", "Madrid" => "Madrid", "Malaga" => "Malaga", "Melilla" => "Melilla", "Murcia" => "Murcia", "Navarra" => "Navarra", 
    302. 

  302. 					"Orense" => "Orense", "Palencia" => "Palencia", "Pontevedra" => "Pontevedra", "Salamanca" => "Salamanca", 
    303. 

  303. 					"Santa Cruz de Tenerife" => "Santa Cruz de Tenerife", "Segovia" => "Segovia", "Sevilla" => "Sevilla", "Soria" => "Soria", 
    304. 

  304. 					"Tarragona" => "Tarragona", "Teruel" => "Teruel", "Toledo" => "Toledo", "Valencia" => "Valencia", "Valladolid" => "Valladolid", 
    305. 

  305. 					"Vizcaya" => "Vizcaya", "Zamora" => "Zamora", "Zaragoza" => "Zaragoza")
    306. 

  306. 				);
    307. 

  307. 	
    308. 

  308. 	
    309. 

  309. 	
    310. 

  310. 	// ----------------------------
    311. 

  311. 	// Internal Use Varibles
    312. 

  312. 	// ----------------------------
    313. 

  313. 	
    314. 

  314. 	
    315. 

  315. 	/*	-----------------------------------------
    316. 

  316. 		AVS Response Code Values and Meanings
    317. 

  317. 		-----------------------------------------
    318. 

  318. 		- $AvsResponseCodesArray[CODE][MESSAGE]
    319. 

  319. 		- $AvsResponseCodesArray[CODE][DETAILS]
    320. 

  320. 	*/
    321. 

  321. 	public $AvsResponseCodesArray = array (
    322. 

  322. 			'A' => array('message' => 'Address', 'details' => 'Address Only (no ZIP)'),
    323. 

  323. 			'B' => array('message' => 'International "A"', 'details' => 'Address Only (no ZIP)'),
    324. 

  324. 			'C' => array('message' => 'International "N"', 'details' => 'None - The transaction is declined.'),
    325. 

  325. 			'D' => array('message' => 'International "X"', 'details' => 'Address and Postal Code'),
    326. 

  326. 			'E' => array('message' => 'Not Allowed for MOTO (Internet/Phone) transactions', 'details' => 'Not applicable - The transaction is declined.'),
    327. 

  327. 			'F' => array('message' => 'UK-Specific "X"', 'details' => 'Address and Postal Code'),
    328. 

  328. 			'G' => array('message' => 'Global Unavailable', 'details' => 'Not applicable'),
    329. 

  329. 			'I' => array('message' => 'International Unavailable', 'details' => 'Not applicable'),
    330. 

  330. 			'N' => array('message' => 'No', 'details' => 'None - The transaction is declined.'),
    331. 

  331. 			'P' => array('message' => 'Postal (International "Z")', 'details' => 'Postal Code only (no Address)'),
    332. 

  332. 			'R' => array('message' => 'Retry', 'details' => 'Not Applicable'),
    333. 

  333. 			'S' => array('message' => 'Service Not Supported', 'details' => 'Not Applicable'),
    334. 

  334. 			'U' => array('message' => 'Unavailable', 'details' => 'Not Applicable'),
    335. 

  335. 			'W' => array('message' => 'Whole ZIP', 'details' => 'Nine-digit ZIP code (no Address)'),
    336. 

  336. 			'X' => array('message' => 'Exact Match', 'details' => 'Address and nine-digit ZIP code'),
    337. 

  337. 			'Y' => array('message' => 'Yes', 'details' => 'Address and five-digit ZIP'),
    338. 

  338. 			'Z' => array('message' => 'ZIP', 'details' => 'Five-digit ZIP code (no Address)'),
    339. 

  339. 			'' => array('message' => 'Error', 'details' => 'Not Applicable')
    340. 

  340. 		);
    341. 

  341. 	
    342. 

  342. 	/*	---------------------------------------	
    343. 

  343. 		CVV Rsponse Code Values and Meanings
    344. 

  344. 		---------------------------------------
    345. 

  345. 		- $CvvResponseCodesArray[CODE][MESSAGE]
    346. 

  346. 		- $CvvResponseCodesArray[CODE][DETAILS]
    347. 

  347. 	*/
    348. 

  348. 	public $CvvResponseCodesArray = array (
    349. 

  349. 			'M' => array('message' => 'Match', 'details' => 'CVV2'), 
    350. 

  350. 			'N' => array('message' => 'No Match', 'details' => 'None'), 
    351. 

  351. 			'P' => array('message' => 'Not Processed', 'details' => 'Not Applicable'), 
    352. 

  352. 			'S' => array('message' => 'Service not supported', 'details' => 'Not Applicable'), 
    353. 

  353. 			'U' => array('message' => 'Service not available', 'details' => 'Not Applicable'), 
    354. 

  354. 			'X' => array('message' => 'No response', 'details' => 'Not Applicable')
    355. 

  355. 		);
    356. 

  356. 	
    357. 

  357. 	/*	---------------------------------------
    358. 

  358. 		CVV Rsponse Code Values and Meanings for Switch and Solo cards
    359. 

  359. 		---------------------------------------
    360. 

  360. 		- TODO: ??
    361. 

  361. 	*/
    362. 

  362. 			
    363. 

  363. 	
    364. 

  364. 	
    365. 

  365. 	/*	--------------------------------------------
    366. 

  366. 		REQUEST FIELDS ARRAYS
    367. 

  367. 		--------------------------------------------
    368. 

  368. 	*/
    369. 

  369. 	
    370. 

  370. 	public $RequestFieldsArray = array(
    371. 

  371. 		'DoCapture' => array(
    372. 

  372. 				'authorization_id' 			=> array('name' =>'AUTHORIZATIONID',		'required' => 'yes'),
    373. 

  373. 				'amount' 					=> array('name' =>'AMT',					'required' => 'yes'),
    374. 

  374. 				'currency_code' 			=> array('name' =>'CURRENCYCODE',			'required' => 'no'),
    375. 

  375. 				'complete_type' 			=> array('name' =>'COMPLETETYPE',			'required' => 'yes'),
    376. 

  376. 				'invoice_number' 			=> array('name' =>'INVNUM',					'required' => 'no'),
    377. 

  377. 				'note' 						=> array('name' =>'NOTE',					'required' => 'no'),
    378. 

  378. 				'soft_descriptor' 			=> array('name' =>'SOFTDESCRIPTOR',			'required' => 'no')
    379. 

  379. 				),
    380. 

  380. 		'DoAuthorization' => array(
    381. 

  381. 				'transaction_id' 			=> array('name' =>'TRANSACTIONID',			'required' => 'yes'),
    382. 

  382. 				'amount' 					=> array('name' =>'AMT',					'required' => 'yes'),
    383. 

  383. 				'transaction_entity' 		=> array('name' =>'TRANSACTIONENTITY',		'required' => 'no'),
    384. 

  384. 				'currency_code' 			=> array('name' =>'CURRENCYCODE',			'required' => 'no')
    385. 

  385. 				),
    386. 

  386. 		'DoReauthorization' => array(
    387. 

  387. 				'authorization_id' 			=> array('name' =>'AUTHORIZATIONID',		'required' => 'yes'),
    388. 

  388. 				'amount'					=> array('name' =>'AMT',					'required' => 'yes')
    389. 

  389. 				),
    390. 

  390. 		'DoVoid' => array(
    391. 

  391. 				'authorization_id' 			=> array('name' =>'AUTHORIZATIONID',		'required' => 'yes'),
    392. 

  392. 				'note' 						=> array('name' =>'NOTE',					'required' => 'no')
    393. 

  393. 				),
    394. 

  394. 		'DoDirectPayment' => array(
    395. 

  395. 				'payment_type' 				=> array('name' => 'PAYMENTACTION',			'required' => 'yes'),
    396. 

  396. 				'ip_address' 				=> array('name' => 'IPADDRESS',				'required' => 'yes'),
    397. 

  397. 				'return_fmf_details' 		=> array('name' => 'RETURNFMFDETAILS',		'required' => 'no'),
    398. 

  398. 				'amount_total' 				=> array('name' => 'AMT',					'required' => 'yes'), 
    399. 

  399. 				'credit_card_type' 			=> array('name' => 'CREDITCARDTYPE',		'required' => 'yes'), 
    400. 

  400. 				'credit_card_number'		=> array('name' => 'ACCT',					'required' => 'yes'), 
    401. 

  401. 				'expire_date' 				=> array('name' => 'EXPDATE',				'required' => 'yes'), 
    402. 

  402. 				'first_name' 				=> array('name' => 'FIRSTNAME',				'required' => 'yes'), 
    403. 

  403. 				'last_name' 				=> array('name' => 'LASTNAME',				'required' => 'yes'), 
    404. 

  404. 				'address1' 					=> array('name' => 'STREET',				'required' => 'no'), 
    405. 

  405. 				'address2' 					=> array('name' => 'STREET2',				'required' => 'no'), 
    406. 

  406. 				'city' 						=> array('name' => 'CITY',					'required' => 'no'), 
    407. 

  407. 				'state' 					=> array('name' => 'STATE',					'required' => 'no'), 
    408. 

  408. 				'country_code' 				=> array('name' => 'COUNTRYCODE',			'required' => 'no'), 
    409. 

  409. 				'postal_code' 				=> array('name' => 'ZIP',					'required' => 'no'), 
    410. 

  410. 				'notify_url' 				=> array('name' => 'NOTIFYURL',				'required' => 'no'), 
    411. 

  411. 				'currency_code' 			=> array('name' => 'CURRENCYCODE',			'required' => 'no'), 
    412. 

  412. 				'amount_items' 				=> array('name' => 'ITEMAMT',				'required' => 'no'), 
    413. 

  413. 				'amount_shipping' 			=> array('name' => 'SHIPPINGAMT',			'required' => 'no'), 
    414. 

  414. 				'amount_handling' 			=> array('name' => 'HANDLINGAMT',			'required' => 'no'), 
    415. 

  415. 				'amount_tax' 				=> array('name' => 'TAXAMT',				'required' => 'no'), 
    416. 

  416. 				'description' 				=> array('name' => 'DESC',					'required' => 'no'), 
    417. 

  417. 				'custom' 					=> array('name' => 'CUSTOM',				'required' => 'no'), 
    418. 

  418. 				'invoice_number' 			=> array('name' => 'INVNUM',				'required' => 'no'), 
    419. 

  419. 				'cvv2_code' 				=> array('name' => 'CVV2',					'required' => 'yes'), 
    420. 

  420. 				'start_date' 				=> array('name' => 'STARTDATE',				'required' => 'no'), // For Maestro/Solo cards
    421. 

  421. 				'issue_number'				=> array('name' => 'ISSUENUMBER',			'required' => 'no'), // For maestro/Solo Cards
    422. 

  422. 				'email' 					=> array('name' => 'EMAIL',					'required' => 'no'), 
    423. 

  423. 				'phone_number' 				=> array('name' => 'PHONENUM',				'required' => 'no'), 
    424. 

  424. 				'shipping_name' 			=> array('name' => 'SHIPTONAME',			'required' => 'no'), 
    425. 

  425. 				'shipping_address1' 		=> array('name' => 'SHIPTOSTREET',			'required' => 'no'), 
    426. 

  426. 				'shipping_address2' 		=> array('name' => 'SHIPTOSTREET2',			'required' => 'no'), 
    427. 

  427. 				'shipping_city' 			=> array('name' => 'SHIPTOCITY',			'required' => 'no'), 
    428. 

  428. 				'shipping_state' 			=> array('name' => 'SHIPTOSTATE',			'required' => 'no'), 
    429. 

  429. 				'shipping_postal_code' 		=> array('name' => 'SHIPTOZIP',				'required' => 'no'), 
    430. 

  430. 				'shipping_country_code'		=> array('name' => 'SHIPTOCOUNTRYCODE',		'required' => 'no'), 
    431. 

  431. 				'shipping_phone_number' 	=> array('name' => 'SHIPTOPHONENUM',		'required' => 'no')
    432. 

  432. 				),		
    433. 

  433. 		'SetExpressCheckout' => array(
    434. 

  434. 				'return_url' 				=> array('name' => 'RETURNURL', 'required' => 'yes'),
    435. 

  435. 				'cancel_url' 				=> array('name' => 'CANCELURL', 'required' => 'yes'),
    436. 

  436. 				'amount_total' 				=> array('name' => 'AMT', 'required' => 'yes'), 
    437. 

  437. 				'currency_code' 			=> array('name' => 'CURRENCYCODE', 'required' => 'no'), 
    438. 

  438. 				'amount_max' 				=> array('name' => 'MAXAMT', 'required' => 'no'), 
    439. 

  439. 				'payment_type' 				=> array('name' => 'PAYMENTACTION', 'required' => 'no'), 
    440. 

  440. 				'email'						=> array('name' => 'EMAIL', 'required' => 'no'), 
    441. 

  441. 				'description' 				=> array('name' => 'DESC', 'required' => 'no'), 
    442. 

  442. 				'custom' 					=> array('name' => 'CUSTOM', 'required' => 'no'), 
    443. 

  443. 				'invoice_number' 			=> array('name' => 'INVNUM', 'required' => 'no'), 
    444. 

  444. 				'phone_number' 				=> array('name' => 'PHONENUM', 'required' => 'no'), 
    445. 

  445. 				'shipping_name' 			=> array('name' => 'SHIPTONAME', 'required' => 'no'), 
    446. 

  446. 				'shipping_address1' 		=> array('name' => 'SHIPTOSTREET', 'required' => 'no'), 
    447. 

  447. 				'shipping_address2' 		=> array('name' => 'SHIPTOSTREET2', 'required' => 'no'), 
    448. 

  448. 				'shipping_city' 			=> array('name' => 'SHIPTOCITY', 'required' => 'no'), 
    449. 

  449. 				'shipping_state' 			=> array('name' => 'SHIPTOSTATE', 'required' => 'no'), 
    450. 

  450. 				'shipping_postal_code' 		=> array('name' => 'SHIPTOZIP', 'required' => 'no'), 
    451. 

  451. 				'shipping_country_code' 	=> array('name' => 'SHIPTOCOUNTRYCODE', 'required' => 'no'), 
    452. 

  452. 				'shipping_phone_number' 	=> array('name' => 'SHIPTOPHONENUM', 'required' => 'no'), 
    453. 

  453. 				'require_confirmed_shipping_address' => array('name' => 'REQCONFIRMSHIPPING', 'required' => 'no'),
    454. 

  454. 				'no_shipping' 				=> array('name' => 'NOSHIPPING', 'required' => 'no'), 
    455. 

  455. 				'address_override' 			=> array('name' => 'ADDROVERRIDE', 'required' => 'no'), 
    456. 

  456. 				'token' 					=> array('name' => 'TOKEN', 'required' => 'no'), 
    457. 

  457. 				'locale_code' 				=> array('name' => 'LOCALECODE', 'required' => 'no'), 
    458. 

  458. 				'page_style' 				=> array('name' => 'PAGESTYLE', 'required' => 'no'), 
    459. 

  459. 				'hdr_img' 					=> array('name' => 'HDRIMG', 'required' => 'no'), 
    460. 

  460. 				'hdr_border_color' 			=> array('name' => 'HDRBORDERCOLOR', 'required' => 'no'), 
    461. 

  461. 				'hdr_background_color' 		=> array('name' => 'HDRBACKCOLOR', 'required' => 'no'), 
    462. 

  462. 				'payflow_color' 			=> array('name' => 'PAYFLOWCOLOR', 'required' => 'no'), 
    463. 

  463. 				'user_action' 				=> array('name' => 'USERACTION', 'required' => 'no'),
    464. 

  464. 				'channel_type' 				=> array('name' => 'CHANNELTYPE', 'required' => 'no'),
    465. 

  465. 				'solution_type' 			=> array('name' => 'SOLUTIONTYPE', 'required' => 'no') ,
    466. 

  466. 				'billing_type' 				=> array('name' => 'L_BILLINGTYPE0', 'required' => 'no'),
    467. 

  467. 				'billing_agreement' 		=> array('name' => 'L_BILLINGAGREEMENTDESCRIPTION0', 'required' => 'no') 
    468. 

  468. 				),		
    469. 

  469. 		'GetExpressCheckoutDetails' => array(
    470. 

  470. 				'token' 					=> array('name' => 'TOKEN',					'required' => 'yes')
    471. 

  471. 				),		
    472. 

  472. 		'DoExpressCheckoutPayment' => array(
    473. 

  473. 				'token' 					=> array('name' => 'TOKEN',					'required' => 'yes'),
    474. 

  474. 				'payment_type' 				=> array('name' => 'PAYMENTACTION',			'required' => 'yes'), 
    475. 

  475. 				'payer_id' 					=> array('name' => 'PAYERID',				'required' => 'yes'),
    476. 

  476. 				'amount_total' 				=> array('name' => 'AMT',					'required' => 'yes'), 
    477. 

  477. 				'description' 				=> array('name' => 'DESC',					'required' => 'no'), 
    478. 

  478. 				'custom' 					=> array('name' => 'CUSTOM',				'required' => 'no'), 
    479. 

  479. 				'invoice_number' 			=> array('name' => 'INVNUM',				'required' => 'no'), 
    480. 

  480. 				'notify_url' 				=> array('name' => 'NOTIFYURL',				'required' => 'no'), 
    481. 

  481. 				'amount_items' 				=> array('name' => 'ITEMAMT',				'required' => 'no'), 
    482. 

  482. 				'amount_shipping' 			=> array('name' => 'SHIPPINGAMT',			'required' => 'no'), 
    483. 

  483. 				'amount_handling' 			=> array('name' => 'HANDLINGAMT',			'required' => 'no'), 
    484. 

  484. 				'amount_tax' 				=> array('name' => 'TAXAMT',				'required' => 'no'), 
    485. 

  485. 				'currency_code' 			=> array('name' => 'CURRENCYCODE',			'required' => 'no'), 
    486. 

  486. 				'shipping_name' 			=> array('name' => 'SHIPTONAME',			'required' => 'no'), 
    487. 

  487. 				'shipping_address1' 		=> array('name' => 'SHIPTOSTREET',			'required' => 'no'), 
    488. 

  488. 				'shipping_address2' 		=> array('name' => 'SHIPTOSTREET2',			'required' => 'no'), 
    489. 

  489. 				'shipping_city' 			=> array('name' => 'SHIPTOCITY',			'required' => 'no'), 
    490. 

  490. 				'shipping_state' 			=> array('name' => 'SHIPTOSTATE',			'required' => 'no'), 
    491. 

  491. 				'shipping_postal_code' 		=> array('name' => 'SHIPTOZIP',				'required' => 'no'), 
    492. 

  492. 				'shipping_country_code' 	=> array('name' => 'SHIPTOCOUNTRYCODE',		'required' => 'no'), 
    493. 

  493. 				'shipping_phone_number' 	=> array('name' => 'SHIPTOPHONENUM',		'required' => 'no')
    494. 

  494. 				),		
    495. 

  495. 		'GetTransactionDetails' => array(
    496. 

  496. 				'transaction_id' 			=> array('name' => 'TRANSACTIONID',			'required' => 'yes')
    497. 

  497. 				),		
    498. 

  498. 		'RefundTransaction' => array(
    499. 

  499. 				'transaction_id'			=> array('name' => 'TRANSACTIONID',			'required' => 'yes'), 
    500. 

  500. 				'refund_type'				=> array('name' => 'REFUNDTYPE',			'required' => 'yes'), 
    501. 

  501. 				'amount_total' 				=> array('name' => 'AMT',					'required' => 'no'), 
    502. 

  502. 				'note' 						=> array('name' => 'NOTE',					'required' => 'no'),
    503. 

  503. 				),
    504. 

  504. 		'CreateRecurringPaymentsProfile' => array(
    505. 

  505. 				'token' 					=> array('name' => 'TOKEN',					'required' => 'yes'),
    506. 

  506. 				'payer_id' 					=> array('name' => 'PAYERID',				'required' => 'yes'),
    507. 

  507. 				'email' 				 	=> array('name' => 'EMAIL',					'required' => 'yes'),
    508. 

  508. 				'country_code'    			=> array('name' => 'COUNTRYCODE',			'required' => 'no'),
    509. 

  509. 				'business'    				=> array('name' => 'BUSINESS',				'required' => 'no'),
    510. 

  510. 				'payer_status'				=> array('name' => 'PAYERSTATUS',			'required' => 'no'),
    511. 

  511. 				'subscriber_name' 			=> array('name' => 'SUBSCRIBERNAME',		'required' => 'yes'),
    512. 

  512. 				'profile_reference'			=> array('name' => 'PROFILEREFERENCE',		'required' => 'yes'),
    513. 

  513. 				'credit_card_type'			=> array('name' => 'CREDITCARDTYPE',		'required' => 'yes'), 
    514. 

  514. 				'credit_card_number' 		=> array('name' => 'ACCT',					'required' => 'yes'), 
    515. 

  515. 				'expire_date' 				=> array('name' => 'EXPDATE',				'required' => 'yes'), 
    516. 

  516. 				'first_name' 				=> array('name' => 'FIRSTNAME',				'required' => 'yes'), 
    517. 

  517. 				'last_name' 				=> array('name' => 'LASTNAME',				'required' => 'yes'), 
    518. 

  518. 				'address1' 					=> array('name' => 'STREET',				'required' => 'no'), 
    519. 

  519. 				'address2' 					=> array('name' => 'STREET2',				'required' => 'no'), 
    520. 

  520. 				'city' 						=> array('name' => 'CITY',					'required' => 'no'), 
    521. 

  521. 				'state' 					=> array('name' => 'STATE',					'required' => 'no'), 
    522. 

  522. 				'country_code' 				=> array('name' => 'COUNTRYCODE',			'required' => 'no'), 
    523. 

  523. 				'postal_code' 				=> array('name' => 'ZIP',					'required' => 'no'),
    524. 

  524. 				
    525. 

  525. 				'shipping_name' 			=> array('name' => 'SHIPTONAME',			'required' => 'no'), 
    526. 

  526. 				'shipping_address1'			=> array('name' => 'SHIPTOSTREET',			'required' => 'no'), 
    527. 

  527. 				'shipping_address2' 		=> array('name' => 'SHIPTOSTREET2',			'required' => 'no'), 
    528. 

  528. 				'shipping_city' 			=> array('name' => 'SHIPTOCITY',			'required' => 'no'), 
    529. 

  529. 				'shipping_state' 			=> array('name' => 'SHIPTOSTATE',			'required' => 'no'), 
    530. 

  530. 				'shipping_postal_code' 		=> array('name' => 'SHIPTOZIP',				'required' => 'no'), 
    531. 

  531. 				'shipping_country_code' 	=> array('name' => 'SHIPTOCOUNTRYCODE',		'required' => 'no'), 
    532. 

  532. 				'shipping_phone_number' 	=> array('name' => 'SHIPTOPHONENUM',		'required' => 'no'),
    533. 

  533. 				 
    534. 

  534. 				'description' 				=> array('name' => 'DESC',					'required' => 'yes'), // You must match the billing agreement var in set Express checkout
    535. 

  535. 				'currency'					=> array('name' => 'CURRENCYCODE',			'required' => 'yes'),
    536. 

  536. 				'payment_type' 				=> array('name' => 'PAYMENTACTION',			'required' => 'yes'),
    537. 

  537. 				'billing_type' 				=> array('name' => 'L_BILLINGTYPE0',		'required' => 'yes'),
    538. 

  538. 				'billing_agreement' 		=> array('name' => 'L_BILLINGAGREEMENTDESCRIPTION0', 'required' => 'yes'),
    539. 

  539. 				'profile_start_date'		=> array('name' => 'PROFILESTARTDATE',		'required' => 'yes'),
    540. 

  540. 				'billing_period' 			=> array('name' => 'BILLINGPERIOD',			'required' => 'yes'), // Day Week Month SemiMonth Year
    541. 

  541. 				'billing_frequency' 		=> array('name' => 'BILLINGFREQUENCY',		'required' => 'yes'),
    542. 

  542. 				'billing_amount' 			=> array('name' => 'AMT',					'required' => 'yes'),
    543. 

  543. 				'tax_amount' 				=> array('name' => 'TAXAMT',				'required' => 'yes'),
    544. 

  544. 				'ship_amount' 				=> array('name' => 'SHIPPINGAMT',			'required' => 'yes'),
    545. 

  545. 				'inital_amount' 			=> array('name' => 'INITAMT',				'required' => 'no'),
    546. 

  546. 				'failed_inital_amount' 		=> array('name' => 'FAILEDINITAMTACTION',	'required' => 'no'),
    547. 

  547. 				'billing_total_cycles' 		=> array('name' => 'TOTALBILLINGCYCLES',	'required' => 'no'),
    548. 

  548. 				'trial_billing_period' 		=> array('name' => 'TRIALBILLINGPERIOD',	'required' => 'no'),
    549. 

  549. 				'trial_billing_frequency' 	=> array('name' => 'TRIALBILLINGFREQUENCY',	'required' => 'no'),
    550. 

  550. 				'trial_amount' 				=> array('name' => 'TRIALAMT', 				'required' => 'no'),	
    551. 

  551. 				'trial_billing_cycle' 		=> array('name' => 'TRIALTOTALBILLINGCYCLES', 'required' => 'no'),				
    552. 

  552. 				'max_failed_attempts'  		=> array('name' => 'MAXFAILEDPAYMENTS', 	'required' => 'no'),
    553. 

  553. 				'auto_bill_amt'  			=> array('name' => 'AUTOBILLOUTAMT', 		'required' => 'no')
    554. 

  554. 				),
    555. 

  555. 		'UpdateRecurringPaymentsProfile' => array(
    556. 

  556. 				'profile_id'				=> array('name' => 'PROFILEID', 			'required' => 'yes'),
    557. 

  557. 				'note'						=> array('name' => 'NOTE', 					'required' => 'no'),
    558. 

  558. 				'description'				=> array('name' => 'DESC', 					'required' => 'no'),
    559. 

  559. 				'subscriber_name'			=> array('name' => 'SUBSCRIBERNAME', 		'required' => 'no'),
    560. 

  560. 				'profile_reference'			=> array('name' => 'PROFILEREFERENCE', 		'required' => 'no'),
    561. 

  561. 				'additional_billing_cycles'	=> array('name' => 'ADDITIONALBILLINGCYCLES', 'required' => 'no'),
    562. 

  562. 				'amount'					=> array('name' => 'AMT', 					'required' => 'yes'),
    563. 

  563. 				'shipping_amount'			=> array('name' => 'SHIPPINGAMT', 			'required' => 'no'),
    564. 

  564. 				'tax_amount'				=> array('name' => 'TAXAMT', 				'required' => 'no'),
    565. 

  565. 				'outstanding_amount'		=> array('name' => 'OUTSTANDINGAMT', 		'required' => 'no'),
    566. 

  566. 				'auto_bill_out'				=> array('name' => 'AUTOBILLOUTAMT', 		'required' => 'no'),
    567. 

  567. 				'max_failed_payments'		=> array('name' => 'MAXFAILEDPAYMENTS', 	'required' => 'no'),
    568. 

  568. 				'profile_start_date'		=> array('name' => 'PROFILESTARTDATE' , 	'required' => 'no'),
    569. 

  569. 				'ship_to_name'				=> array('name' => 'SHIPTONAME', 			'required' => 'no'),
    570. 

  570. 				'ship_to_street'			=> array('name' => 'SHIPTOSTREET', 			'required' => 'no'),
    571. 

  571. 				'ship_to_street_2'			=> array('name' => 'SHIPTOSTREET2', 		'required' => 'no'),
    572. 

  572. 				'ship_to_city'				=> array('name' => 'SHIPTOCITY', 			'required' => 'no'),
    573. 

  573. 				'ship_to_province'			=> array('name' => 'SHIPTOSTATE', 			'required' => 'no'),
    574. 

  574. 				'ship_to_postal_code'		=> array('name' => 'SHIPTOZIP', 			'required' => 'no'),
    575. 

  575. 				'ship_to_country'			=> array('name' => 'SHIPTOCOUNTRY', 		'required' => 'no'),
    576. 

  576. 				'ship_to_phone_number'		=> array('name' => 'SHIPTOPHONENUM', 		'required' => 'no'),
    577. 

  577. 				'billing_period'			=> array('name' => 'BILLINGPERIOD', 		'required' => 'yes'),
    578. 

  578. 				'billing_frequency'			=> array('name' => 'BILLINGFREQUENCY', 		'required' => 'yes'),
    579. 

  579. 				'total_billing_cycles' 		=> array('name' => 'TOTALBILLINGCYCLES', 	'required' => 'no'),
    580. 

  580. 				'trial_billing_period'		=> array('name' => 'TRIALBILLINGPERIOD', 	'required' => 'no'),
    581. 

  581. 				'trial_billing_frequnecy'	=> array('name' => 'TRIALBILLINGFREQUENCY', 'required' => 'no'),
    582. 

  582. 				'trial_total_cycles'		=> array('name' => 'TRIALTOTALBILLINGCYCLES', 'required' => 'no'),
    583. 

  583. 				'trial_amount'				=> array('name' => 'TRIALAMT', 				'required' => 'no'),
    584. 

  584. 				'currency'					=> array('name' => 'CURRENCYCODE', 			'required' => 'yes'),
    585. 

  585. 				'shipping_amount'			=> array('name' => 'SHIPPINGAMT', 			'required' => 'no'),
    586. 

  586. 				'tax_amount'				=> array('name' => 'TAXAMT', 				'required' => 'no'),
    587. 

  587. 				'credit_card_type'			=> array('name' => 'CREDITCARDTYPE', 		'required' => 'no'),
    588. 

  588. 				'credit_card_number'		=> array('name' => 'ACCT', 					'required' => 'no'),
    589. 

  589. 				'expiration_date'			=> array('name' => 'EXPDATE', 				'required' => 'no'),
    590. 

  590. 				'cvv2'						=> array('name' => 'CVV2', 					'required' => 'no'),
    591. 

  591. 				'start_date'				=> array('name' => 'STARTDATE', 			'required' => 'no'),
    592. 

  592. 				'email'						=> array('name' => 'EMAIL', 				'required' => 'no'),
    593. 

  593. 				'first_name'				=> array('name' => 'FIRSTNAME', 			'required' => 'no'),
    594. 

  594. 				'last_name'					=> array('name' => 'LASTNAME',		 		'required' => 'no'),
    595. 

  595. 				'street'					=> array('name' => 'STREET', 				'required' => 'yes'),
    596. 

  596. 				'street2'					=> array('name' => 'STREET2', 				'required' => 'no'),
    597. 

  597. 				'city'						=> array('name' => 'CITY', 					'required' => 'yes'),
    598. 

  598. 				'province'					=> array('name' => 'STATE', 				'required' => 'yes'),
    599. 

  599. 				'country_code'				=> array('name' => 'COUNTRYCODE', 			'required' => 'yes'),
    600. 

  600. 				'postal_code'				=> array('name' => 'ZIP', 					'required' => 'yes'),
    601. 

  601. 				'phone_number'				=> array('name' => 'PHONENUM',				'required' => 'no')
    602. 

  602. 				),
    603. 

  603. 			'DoReferenceTransaction' => array(
    604. 

  604. 				'reference_id'				=> array('name' => 'REFERENCEID', 			'required' => 'yes'),
    605. 

  605. 				'payment_type'				=> array('name' => 'PAYMENTACTION', 		'required' => 'yes'),
    606. 

  606. 				'return_fmf_details'		=> array('name' => 'RETURNFMFDETAILS', 		'required' => 'no'),
    607. 

  607. 				'soft_descriptor'			=> array('name' => 'SOFTDESCRIPTOR', 		'required' => 'no'),
    608. 

  608. 				'ship_to_name'				=> array('name' => 'SHIPTONAME', 			'required' => 'no'),
    609. 

  609. 				'ship_to_street'			=> array('name' => 'SHIPTOSTREET', 			'required' => 'no'),
    610. 

  610. 				'ship_to_street_2'			=> array('name' => 'SHIPTOSTREET2', 		'required' => 'no'),
    611. 

  611. 				'ship_to_city'				=> array('name' => 'SHIPTOCITY', 			'required' => 'no'),
    612. 

  612. 				'ship_to_province'			=> array('name' => 'SHIPTOSTATE', 			'required' => 'no'),
    613. 

  613. 				'ship_to_postal_code'		=> array('name' => 'SHIPTOZIP', 			'required' => 'no'),
    614. 

  614. 				'ship_to_country'			=> array('name' => 'SHIPTOCOUNTRY', 		'required' => 'no'),
    615. 

  615. 				'ship_to_phone_number'		=> array('name' => 'SHIPTOPHONENUM', 		'required' => 'no'),
    616. 

  616. 				'billing_period'			=> array('name' => 'BILLINGPERIOD', 		'required' => 'yes'),
    617. 

  617. 				'billing_frequency'			=> array('name' => 'BILLINGFREQUENCY', 		'required' => 'yes'),
    618. 

  618. 				'phone_number'				=> array('name' => 'PHONENUM',				'required' => 'no'),
    619. 

  619. 				'amount_total' 				=> array('name' => 'AMT',					'required' => 'yes'), 
    620. 

  620. 				'currency_code' 			=> array('name' => 'CURRENCYCODE',			'required' => 'no'), 
    621. 

  621. 				'amount_items' 				=> array('name' => 'ITEMAMT',				'required' => 'no'), 
    622. 

  622. 				'amount_shipping' 			=> array('name' => 'SHIPPINGAMT',			'required' => 'no'), 
    623. 

  623. 				'amount_handling' 			=> array('name' => 'HANDLINGAMT',			'required' => 'no'), 
    624. 

  624. 				'amount_tax' 				=> array('name' => 'TAXAMT',				'required' => 'no'), 
    625. 

  625. 				'description' 				=> array('name' => 'DESC',					'required' => 'no'), 
    626. 

  626. 				'custom' 					=> array('name' => 'CUSTOM',				'required' => 'no'), 
    627. 

  627. 				'invoice_number' 			=> array('name' => 'INVNUM',				'required' => 'no'), 
    628. 

  628. 				'button_source' 			=> array('name' => 'BUTTONSOURCE',			'required' => 'no'), 
    629. 

  629. 				'notify_url' 				=> array('name' => 'NOTIFYURL',				'required' => 'no'), 
    630. 

  630. 				'credit_card_type' 			=> array('name' => 'CREDITCARDTYPE',		'required' => 'no'), 
    631. 

  631. 				'credit_card_number'		=> array('name' => 'ACCT',					'required' => 'no'), 
    632. 

  632. 				'cvv2_code' 				=> array('name' => 'CVV2',					'required' => 'yes'), 
    633. 

  633. 				'expire_date' 				=> array('name' => 'EXPDATE',				'required' => 'no'),
    634. 

  634. 				'start_date' 				=> array('name' => 'STARTDATE',				'required' => 'no'), // For Maestro/Solo cards
    635. 

  635. 				'issue_number'				=> array('name' => 'ISSUENUMBER',			'required' => 'no'), // For maestro/Solo Cards
    636. 

  636. 				'email' 					=> array('name' => 'EMAIL',					'required' => 'no'),
    637. 

  637. 				'first_name' 				=> array('name' => 'FIRSTNAME',				'required' => 'no'),
    638. 

  638. 				'last_name' 				=> array('name' => 'LASTNAME',				'required' => 'no'), 
    639. 

  639. 				'address1' 					=> array('name' => 'STREET',				'required' => 'no'), 
    640. 

  640. 				'address2' 					=> array('name' => 'STREET2',				'required' => 'no'), 
    641. 

  641. 				'city' 						=> array('name' => 'CITY',					'required' => 'no'), 
    642. 

  642. 				'state' 					=> array('name' => 'STATE',					'required' => 'no'), 
    643. 

  643. 				'country_code' 				=> array('name' => 'COUNTRYCODE',			'required' => 'no'), 
    644. 

  644. 				'postal_code' 				=> array('name' => 'ZIP',					'required' => 'no')
    645. 

  645. 				)
    646. 

  646. 		);
    647. 

  647. 	
    648. 

  648. 	
    649. 

  649. 	public $ResponseFieldsArray = array(
    650. 

  650. 		'DoCapture' => array(
    651. 

  651. 				'authorization_id' 		=> 'AUTHORIZATIONID',
    652. 

  652. 				'email' 				=> 'EMAIL',
    653. 

  653. 				'payer_id' 				=> 'PAYERID',
    654. 

  654. 				'payer_status' 			=> 'PAYERSTATUS',
    655. 

  655. 				'country_code' 			=> 'COUNTRYCODE',
    656. 

  656. 				'business' 				=> 'BUSINESS',
    657. 

  657. 				'address_status' 		=> 'ADDRESSSTATUS',
    658. 

  658. 				'shipping_name' 		=> 'SHIPTONAME',
    659. 

  659. 				'shipping_address1' 	=> 'SHIPTOSTREET',
    660. 

  660. 				'shipping_address2' 	=> 'SHIPTOSTREET2',
    661. 

  661. 				'shipping_city' 		=> 'SHIPTOCITY',
    662. 

  662. 				'shipping_state' 		=> 'SHIPTOSTATE',
    663. 

  663. 				'shipping_postal_code'	=> 'SHIPTOZIP',
    664. 

  664. 				'shipping_country_code' => 'SHIPTOCOUNTRYCODE',
    665. 

  665. 				'salutation' 			=> 'SALUTATION',
    666. 

  666. 				'first_name' 			=> 'FIRSTNAME',
    667. 

  667. 				'middle_name' 			=> 'MIDDLENAME',
    668. 

  668. 				'last_name' 			=> 'LASTNAME',
    669. 

  669. 				'suffix' 				=> 'SUFFIX'
    670. 

  670. 				),
    671. 

  671. 		'DoAuthorization' => array(
    672. 

  672. 				'transaction_id' 		=> 'TRANSACTIONID',
    673. 

  673. 				'amount' 				=> 'AMT'
    674. 

  674. 				),
    675. 

  675. 		'DoReauthorization' => array(
    676. 

  676. 				'authorization_id' 		=> 'AUTHORIZATIONID'
    677. 

  677. 				),
    678. 

  678. 		'DoVoid' => array(
    679. 

  679. 				'authorization_id' 		=> 'AUTHORIZATIONID'
    680. 

  680. 				),
    681. 

  681. 		'DoDirectPayment' => array(
    682. 

  682. 				'timestamp' 			=> 'TIMESTAMP',
    683. 

  683. 				'correlation_id' 		=> 'CORRELATIONID',
    684. 

  684. 				'ack' 					=> 'ACK',
    685. 

  685. 				'version' 				=> 'VERSION',
    686. 

  686. 				'build' 				=> 'BUILD',
    687. 

  687. 				'avs_code' 				=> 'AVSCODE',
    688. 

  688. 				'cvv2_match' 			=> 'CVV2MATCH',
    689. 

  689. 				'transaction_id' 		=> 'TRANSACTIONID',
    690. 

  690. 				'amount_total' 			=> 'AMT',
    691. 

  691. 				'currency_code'			=> 'CURRENCYCODE'
    692. 

  692. 				)
    693. 

  693. 		,
    694. 

  694. 		'SetExpressCheckout' => array(
    695. 

  695. 				'timestamp' 			=> 'TIMESTAMP',
    696. 

  696. 				'correlation_id' 		=> 'CORRELATIONID',
    697. 

  697. 				'ack' 					=> 'ACK',
    698. 

  698. 				'version' 				=> 'VERSION',
    699. 

  699. 				'build' 				=> 'BUILD',
    700. 

  700. 				'token' 				=> 'TOKEN'
    701. 

  701. 				)
    702. 

  702. 		,
    703. 

  703. 		'DoExpressCheckoutPayment' => array(
    704. 

  704. 				'timestamp' 			=> 'TIMESTAMP',
    705. 

  705. 				'correlation_id' 		=> 'CORRELATIONID',
    706. 

  706. 				'ack' 					=> 'ACK',
    707. 

  707. 				'version' 				=> 'VERSION',
    708. 

  708. 				'build' 				=> 'BUILD',
    709. 

  709. 				'token' 				=> 'TOKEN',
    710. 

  710. 				'transaction_id' 		=> 'TRANSACTIONID',
    711. 

  711. 				'transaction_type' 		=> 'TRANSACTIONTYPE',
    712. 

  712. 				'payment_type' 			=> 'PAYMENTTYPE',
    713. 

  713. 				'order_time' 			=> 'ORDERTIME',
    714. 

  714. 				'amount_total' 			=> 'AMT',
    715. 

  715. 				'currency_code' 		=> 'CURRENCYCODE',
    716. 

  716. 				'amount_fee' 			=> 'FEEAMT',
    717. 

  717. 				'amount_settle' 		=> 'SETTLEAMT',
    718. 

  718. 				'amount_tax' 			=> 'TAXAMT',
    719. 

  719. 				'exchange_rate'			=> 'EXCHANGERATE',
    720. 

  720. 				'payment_status' 		=> 'PAYMENTSTATUS',
    721. 

  721. 				'payment_pending_reason'=> 'PENDINGREASON',
    722. 

  722. 				'payment_reason_code' 	=> 'REASONCODE'
    723. 

  723. 				)
    724. 

  724. 		,
    725. 

  725. 		'GetExpressCheckoutDetails' => array(
    726. 

  726. 				'timestamp' 			=> 'TIMESTAMP',
    727. 

  727. 				'correlation_id' 		=> 'CORRELATIONID',
    728. 

  728. 				'ack' 					=> 'ACK',
    729. 

  729. 				'version' 				=> 'VERSION',
    730. 

  730. 				'build' 				=> 'BUILD',
    731. 

  731. 				'token' 				=> 'TOKEN',
    732. 

  732. 				'email' 				=> 'EMAIL',
    733. 

  733. 				'payer_id' 				=> 'PAYERID',
    734. 

  734. 				'payer_status' 			=> 'PAYERSTATUS',
    735. 

  735. 				'salutation' 			=> 'SALUTATION',
    736. 

  736. 				'first_name' 			=> 'FIRSTNAME',
    737. 

  737. 				'middle_name' 			=> 'MIDDLENAME',
    738. 

  738. 				'last_name' 			=> 'LASTNAME',
    739. 

  739. 				'suffix' 				=> 'SUFFIX',
    740. 

  740. 				'country_code' 			=> 'COUNTRYCODE',
    741. 

  741. 				'business' 				=> 'BUSINESS',
    742. 

  742. 				'shipping_name' 		=> 'SHIPTONAME',
    743. 

  743. 				'shipping_address1' 	=> 'SHIPTOSTREET',
    744. 

  744. 				'shipping_address2' 	=> 'SHIPTOSTREET2',
    745. 

  745. 				'shipping_city' 		=> 'SHIPTOCITY',
    746. 

  746. 				'shipping_state' 		=> 'SHIPTOSTATE',
    747. 

  747. 				'shipping_country_code' => 'SHIPTOCOUNTRYCODE',
    748. 

  748. 				'shipping_country_name' => 'SHIPTOCOUNTRYNAME',
    749. 

  749. 				'shipping_postal_code' 	=> 'SHIPTOZIP',
    750. 

  750. 				'address_id' 			=> 'ADDRESSID', // Is this a returned variable? Some docs say yes, some no
    751. 

  751. 				'address_status'		=> 'ADDRESSSTATUS',
    752. 

  752. 				'description' 			=> 'DESC',
    753. 

  753. 				'custom' 				=> 'CUSTOM',
    754. 

  754. 				'phone_number' 			=> 'PHONENUM'
    755. 

  755. 				)
    756. 

  756. 		,
    757. 

  757. 		'GetTransactionDetails' => array(
    758. 

  758. 				'timestamp' => 'TIMESTAMP',
    759. 

  759. 				'correlation_id' 		=> 'CORRELATIONID',
    760. 

  760. 				'ack'					=> 'ACK',
    761. 

  761. 				'version' 				=> 'VERSION',
    762. 

  762. 				'build' 				=> 'BUILD',
    763. 

  763. 				'receiver_business'		=> 'RECEIVERBUSINESS',
    764. 

  764. 				'receiver_email' 		=> 'RECEIVEREMAIL',
    765. 

  765. 				'receiver_id' 			=> 'RECEIVERID',
    766. 

  766. 				'email' 				=> 'EMAIL',
    767. 

  767. 				'payer_id' 				=> 'PAYERID',
    768. 

  768. 				'payer_status' 			=> 'PAYERSTATUS',
    769. 

  769. 				'salutation' 			=> 'SALUTATION',
    770. 

  770. 				'first_name' 			=> 'FIRSTNAME',
    771. 

  771. 				'last_name' 			=> 'LASTNAME',
    772. 

  772. 				'middle_name' 			=> 'MIDDLENAME',
    773. 

  773. 				'suffix' 				=> 'SUFFIX',
    774. 

  774. 				'payer_business' 		=> 'PAYERBUSINESS',
    775. 

  775. 				'country_code' 			=> 'COUNTRYCODE',
    776. 

  776. 				'business' 				=> 'BUSINESS',
    777. 

  777. 				'shipping_name' 		=> 'SHIPTONAME',
    778. 

  778. 				'shipping_address1' 	=> 'SHIPTOSTREET',
    779. 

  779. 				'shipping_address2' 	=> 'SHIPTOSTREET2',
    780. 

  780. 				'shipping_city' 		=> 'SHIPTOCITY',
    781. 

  781. 				'shipping_state' 		=> 'SHIPTOSTATE',
    782. 

  782. 				'shipping_country_code' => 'SHIPTOCOUNTRYCODE',
    783. 

  783. 				'shipping_country_name' => 'SHIPTOCOUNTRYNAME',
    784. 

  784. 				'shipping_postal_code'	=> 'SHIPTOZIP',
    785. 

  785. 				'address_id' 			=> 'ADDRESSID', // Is this a returned variable? Some docs say yes, some no
    786. 

  786. 				'address_status' 		=> 'ADDRESSSTATUS',
    787. 

  787. 				'address_owner' 		=> 'ADDRESSOWNER',
    788. 

  788. 				'parent_transaction_id' => 'PARENTTRANSACTIONID',
    789. 

  789. 				'transaction_id' 		=> 'TRANSACTIONID',
    790. 

  790. 				'receipt_id' 			=> 'RECEIPTID',
    791. 

  791. 				'transaction_type' 		=> 'TRANSACTIONTYPE',
    792. 

  792. 				'payment_type' 			=> 'PAYMENTTYPE',
    793. 

  793. 				'order_time' 			=> 'ORDERTIME',
    794. 

  794. 				'amount_total' 			=> 'AMT',
    795. 

  795. 				'currency_code' 		=> 'CURRENCYCODE',
    796. 

  796. 				'amount_fee' 			=> 'FEEAMT',
    797. 

  797. 				'amount_settle' 		=> 'SETTLEAMT',
    798. 

  798. 				'amount_tax' 			=> 'TAXAMT',
    799. 

  799. 				'exchange_rate' 		=> 'EXCHANGERATE',
    800. 

  800. 				'payment_status' 		=> 'PAYMENTSTATUS',
    801. 

  801. 				'payment_pending_reason' => 'PENDINGREASON',
    802. 

  802. 				'payment_reason_code' 	=> 'REASONCODE',
    803. 

  803. 				'amount_sales_tax' 		=> 'SALESTAX',
    804. 

  804. 				'invoice_number' 		=> 'INVNUM',
    805. 

  805. 				'note' 					=> 'NOTE',
    806. 

  806. 				'custom' 				=> 'CUSTOM',
    807. 

  807. 				'subscription_id' 		=> 'SUBSCRIPTIONID',
    808. 

  808. 				'subscription_date' 	=> 'SUBSCRIPTIONDATE',
    809. 

  809. 				'effective_date' 		=> 'EFFECTIVEDATE',
    810. 

  810. 				'retry_time' 			=> 'RETRYTIME',
    811. 

  811. 				'user_name' 			=> 'USERNAME',
    812. 

  812. 				'recurrences' 			=> 'RECURRENCES',
    813. 

  813. 				'reattempt' 			=> 'REATTEMPT',
    814. 

  814. 				'recurring' 			=> 'RECURRING',
    815. 

  815. 				'period' 				=> 'PERIOD',
    816. 

  816. 				'buyer_id' 				=> 'BUYERID',
    817. 

  817. 				'closing_date' 			=> 'CLOSINGDATE',
    818. 

  818. 				'multi_item' 			=> 'MULTIITEM'
    819. 

  819. 				)
    820. 

  820. 		,
    821. 

  821. 		'RefundTransaction' => array(
    822. 

  822. 				'refund_transaction_id' => 'REFUNDTRANSACTIONID',
    823. 

  823. 				'amount_refund_net' 	=> 'NETFUNDAMT',
    824. 

  824. 				'amount_refund_fee' 	=> 'FEEREFUNDAMT',
    825. 

  825. 				'amount_refund_total' 	=> 'GROSSREFUNDAMT'
    826. 

  826. 				),
    827. 

  827. 		'CreateRecurringPaymentsProfile' => array(
    828. 

  828. 				'profile_id' 			=> 'PROFILEID',
    829. 

  829. 				'status'				=> 'STATUS'
    830. 

  830. 				),
    831. 

  831. 		'UpdateRecurringPaymentsProfile' => array(
    832. 

  832. 				'profile_id' 			=> 'PROFILEID',
    833. 

  833. 				),
    834. 

  834. 		'GetRecurringPaymentsProfileDetails' => array(
    835. 

  835. 				'profile_id' 			=> 'PROFILEID',
    836. 

  836. 				'status' 				=> 'STATUS',
    837. 

  837. 				'auto_bill_out' 		=> 'AUTOBILLOUTAMT',
    838. 

  838. 				'description' 			=> 'DESC',
    839. 

  839. 				'max_failed_payments' 	=> 'MAXFAILEDPAYMENTS',
    840. 

  840. 				'subcriber_name' 		=> 'SUBSCRIBERNAME',
    841. 

  841. 				'profile_start_date' 	=> 'PROFILESTARTDATE',
    842. 

  842. 				'nest_billing_date' 	=> 'NEXTBILLINGDATE',
    843. 

  843. 				'num_cycles_completed' 	=> 'NUMCYCLESCOMPLETED',
    844. 

  844. 				'num_cycles_remaining' 	=> 'NUMCYCLESREMAINING',
    845. 

  845. 				'outstanding_balance' 	=> 'OUTSTANDINGBALANCE',
    846. 

  846. 				'failed_billing_account'=> 'FAILEDPAYMENTCOUNT',
    847. 

  847. 				'trial_amount_paid' 	=> 'TRIALAMTPAID',
    848. 

  848. 				'regular_amount_paid' 	=> 'REGULARAMTPAID',
    849. 

  849. 				'aggregate_amount'		=> 'AGGREGATEAMT',
    850. 

  850. 				'aggregate_option_amount' => 'AGGREGATEOPTIONALAMT',
    851. 

  851. 				'final_payment_due_date' => 'FINALPAYMENTDUEDATE',
    852. 

  852. 				'time_stamp' 			=> 'TIMESTAMP',
    853. 

  853. 				'correlation_id' 		=> 'CORRELATIONID',
    854. 

  854. 				'ack' 					=> 'ACK',
    855. 

  855. 				'version' 				=> 'VERSION',
    856. 

  856. 				'build' 				=> 'BUILD',
    857. 

  857. 				'ship_to_street' 		=> 'SHIPTOSTREET',
    858. 

  858. 				'ship_to_street2' 		=> 'SHIPTOSTREET2',
    859. 

  859. 				'ship_to_city' 			=> 'SHIPTOCITY',
    860. 

  860. 				'ship_to_province' 		=> 'SHIPTOSTATE',
    861. 

  861. 				'ship_to_postalcode' 	=> 'SHIPTOZIP',
    862. 

  862. 				'ship_to_country_code' 	=> 'SHIPTOCOUNTRYCODE',
    863. 

  863. 				'ship_to_country' 		=> 'SHIPTOCOUNTRY',
    864. 

  864. 				'ship_to_country_name' 	=> 'SHIPTOCOUNTRYNAME',
    865. 

  865. 				'ship_address_owner' 	=> 'SHIPADDRESSOWNER',
    866. 

  866. 				'ship_address_status' 	=> 'SHIPADDRESSSTATUS',
    867. 

  867. 				'billing_period' 		=> 'BILLINGPERIOD',
    868. 

  868. 				'billing_frequency' 	=> 'BILLINGFREQUENCY',
    869. 

  869. 				'total_biling_cycles' 	=> 'TOTALBILLINGCYCLES',
    870. 

  870. 				'currency' 				=> 'CURRENCYCODE',
    871. 

  871. 				'amount' 				=> 'AMT',
    872. 

  872. 				'shipping_amount' 		=> 'SHIPPINGAMT',
    873. 

  873. 				'tax_amount' 			=> 'TAXAMT',
    874. 

  874. 				'regualar_billing_period' => 'REGULARBILLINGPERIOD',
    875. 

  875. 				'regular_billing_frequency' => 'REGULARBILLINGFREQUENCY',
    876. 

  876. 				'regular_billing_cycles' => 'REGULARTOTALBILLINGCYCLES',
    877. 

  877. 				'regular_currency' 		=> 'REGULARCURRENCYCODE',
    878. 

  878. 				'regular_amount' 		=> 'REGULARAMT',
    879. 

  879. 				'regular_shipping_amount' => 'REGULARSHIPPINGAMT',
    880. 

  880. 				'regular_tax_amount' 	=> 'REGULARTAXAMT',
    881. 

  881. 				'credit_card_num' 		=> 'ACCT',
    882. 

  882. 				'credit_card_type' 		=> 'CREDITCARDTYPE',
    883. 

  883. 				'expiration_date' 		=> 'EXPDATE',
    884. 

  884. 				'email' 				=> 'EMAIL',
    885. 

  885. 				'first_name' 			=> 'FIRSTNAME',
    886. 

  886. 				'last_name' 			=> 'LASTNAME',
    887. 

  887. 				'street' 				=> 'STREET',
    888. 

  888. 				'street2' 				=> 'STREET2',
    889. 

  889. 				'city' 					=> 'CITY',
    890. 

  890. 				'state' 				=> 'STATE',
    891. 

  891. 				'postal_code' 			=> 'ZIP',
    892. 

  892. 				'country_code' 			=> 'COUNTRYCODE',
    893. 

  893. 				'country' 				=> 'COUNTRY',
    894. 

  894. 				'address_owner' 		=> 'ADDRESSOWNER',
    895. 

  895. 				'address_status' 		=> 'ADDRESSSTATUS',
    896. 

  896. 				'payer_status' 			=> 'PAYERSTATUS'
    897. 

  897. 				),
    898. 

  898. 		'DoReferenceTransaction' => array(
    899. 

  899. 				'avs_code' 				=> 'AVSCODE',
    900. 

  900. 				'cvv2_match' 			=> 'AVV2MATCH',
    901. 

  901. 				'billing_agreement_id'	=> 'BILLINGAGREEMENTID', // Should include filter IDs, but this will have to be done in the function level
    902. 

  902. 				'transaction_id'	 	=> 'TRANSACTIONID',
    903. 

  903. 				'transaction_type' 		=> 'TRANSACTIONTYPE',
    904. 

  904. 				'payment_type'		 	=> 'PAYMENTTYPE',
    905. 

  905. 				'order_time'		 	=> 'ORDERTIME',
    906. 

  906. 				'amount_total'		 	=> 'AMT',
    907. 

  907. 				'currency_code'			=> 'CURRENCYCODE',
    908. 

  908. 				'ammount_fee'			=> 'FEEAMT',
    909. 

  909. 				'amount_settle'			=> 'SETTLEAMT',
    910. 

  910. 				'amount_tax'			=> 'TAXAMT',
    911. 

  911. 				'exchange_rate'			=> 'EXCHANGERATE',
    912. 

  912. 				'payment_status'		=> 'PAYMENTSTATUS',
    913. 

  913. 				'pending_reason'		=> 'PENDINGREASON',
    914. 

  914. 				'reason_code'			=> 'REASONCODE',
    915. 

  915. 				'protection_eligibility'=> 'PROTECTIONELIGIBILITY',
    916. 

  916. 				'ebay_item_auction_transaction_id'	=> 'EBAYITEMAUCTIONTXNID',
    917. 

  917. 				'payment_error'			=> 'PAYMENTERROR'
    918. 

  918. 				)
    919. 

  919. 		);
    920. 

  920. 	
    921. 

  921. 	
    922. 

  922. 	
    923. 

  923. 		
    924. 

  924. 	
    925. 

  925. 	// CONSTRUCT
    926. 

  926. 	function __construct($sandbox=false)
    927. 

  927. 	{
    928. 

  928. 		
    929. 

  929. 		$this->sandbox = $sandbox;
    930. 

  930. 		if ($sandbox) $this->live = false;
    931. 

  931. 		else $this->live = true;
    932. 

  932. 		
    933. 

  933. 		// SANDBOX SETTINGS
    934. 

  934. 		if($this->sandbox):
    935. 

  935. 			
    936. 

  936. 			$this->API_USERNAME = 'sdk-three_api1.sdk.com';
    937. 

  937. 			$this->API_PASSWORD = 'QFZCWN5HZM8VBG7Q';
    938. 

  938. 			$this->API_SIGNATURE = 'A-IzJhZZjhg29XQ2qnhapuwxIDzyAZQ92FRP5dqBzVesOkzbdUONzmOU';
    939. 

  939. 			
    940. 

  940. 			$this->API_ENDPOINT = 'https://api-3t.sandbox.paypal.com/nvp';
    941. 

  941. 			
    942. 

  942. 			$this->USE_PROXY = FALSE;
    943. 

  943. 			$this->PROXY_HOST = '127.0.0.1';
    944. 

  944. 			$this->PROXY_PORT = '808';
    945. 

  945. 			
    946. 

  946. 			$this->PAYPAL_URL = 'https://www.sandbox.paypal.com/webscr&cmd=_express-checkout&token=';
    947. 

  947. 			
    948. 

  948. 			$this->return_url = '';
    949. 

  949. 			$this->cancel_url = '';
    950. 

  950. 		
    951. 

  951. 		// LIVE SETTINGS
    952. 

  952. 		elseif($this->live):
    953. 

  953. 			
    954. 

  954. 			$this->API_USERNAME = '';
    955. 

  955. 			$this->API_PASSWORD = '';
    956. 

  956. 			$this->API_SIGNATURE = '';
    957. 

  957. 			
    958. 

  958. 			$this->API_ENDPOINT = 'https://api-3t.paypal.com/nvp';
    959. 

  959. 			
    960. 

  960. 			$this->USE_PROXY = FALSE;
    961. 

  961. 			$this->PROXY_HOST = '127.0.0.1';
    962. 

  962. 			$this->PROXY_PORT = '8080';
    963. 

  963. 			
    964. 

  964. 			$this->PAYPAL_URL = 'https://www.paypal.com/webscr&cmd=_express-checkout&token=';
    965. 

  965. 			
    966. 

  966. 			$this->return_url = '';
    967. 

  967. 			$this->cancel_url = '';
    968. 

  968. 			
    969. 

  969. 			$this->VERSION = '3.0';
    970. 

  970. 			
    971. 

  971. 		endif;
    972. 

  972. 	}	
    973. 

  973. 	
    974. 

  974. 	
    975. 

  975. 	
    976. 

  976. 	
    977. 

  977. 	public function do_capture()
    978. 

  978. 	{
    979. 

  979. 		// urlencode the needed variables
    980. 

  980. 		$this->urlencodeVariables();
    981. 

  981. 		
    982. 

  982. 		/* Construct the request string that will be sent to PayPal.
    983. 

  983. 		   The variable $nvpstr contains all the variables and is a
    984. 

  984. 		   name value pair string with & as a delimiter */
    985. 

  985. 		$nvpstr = $this->generateNVPString('DoCapture');
    986. 

  986. 		
    987. 

  987. 		// decode the variables incase we still require access to them in our program
    988. 

  988. 		$this->urldecodeVariables();
    989. 

  989. 		
    990. 

  990. 		/* Make the API call to PayPal, using API signature.
    991. 

  991. 		   The API response is stored in an associative array called $this->Response */
    992. 

  992. 		$this->Response = $this->hash_call("DoCapture", $nvpstr);
    993. 

  993. 		
    994. 

  994. 		// TODO: Add error handling for the hash_call
    995. 

  995. 		
    996. 

  996. 		/*
    997. 

  997. 		*************
    998. 

  998. 		if NO SUCCESS
    999. 

  999. 		*************
    1000. 

  1000. 		*/
    1001. 

  1001. 		if(strtoupper($this->Response["ACK"]) != "SUCCESS" AND strtoupper($this->Response["ACK"]) != "SUCCESSWITHWARNING")
    1002. 

  1002. 		{
    1003. 

  1003. 			$this->Error['TIMESTAMP']		= @$this->Response['TIMESTAMP'];
    1004. 

  1004. 			$this->Error['CORRELATIONID']	= @$this->Response['CORRELATIONID'];
    1005. 

  1005. 			$this->Error['ACK']				= $this->Response['ACK'];
    1006. 

  1006. 			$this->Error['ERRORCODE']		= $this->Response['L_ERRORCODE0'];
    1007. 

  1007. 			$this->Error['SHORTMESSAGE']	= $this->Response['L_SHORTMESSAGE0'];
    1008. 

  1008. 			$this->Error['LONGMESSAGE']		= $this->Response['L_LONGMESSAGE0'];
    1009. 

  1009. 			$this->Error['SEVERITYCODE']	= $this->Response['L_SEVERITYCODE0'];
    1010. 

  1010. 			$this->Error['VERSION']			= @$this->Response['VERSION'];
    1011. 

  1011. 			$this->Error['BUILD']			= @$this->Response['BUILD'];
    1012. 

  1012. 			
    1013. 

  1013. 			// TODO: Error codes for AVSCODE and CVV@MATCH
    1014. 

  1014. 			
    1015. 

  1015. 			$this->_error				= true;
    1016. 

  1016. 			$this->_error_ack			= $this->Response['ACK'];
    1017. 

  1017. 			$this->ack					= 'Failure';
    1018. 

  1018. 			$this->_error_type			= 'paypal';
    1019. 

  1019. 			$this->_error_date			= $this->Response['TIMESTAMP'];
    1020. 

  1020. 			$this->_error_code			= $this->Response['L_ERRORCODE0'];
    1021. 

  1021. 			$this->_error_short_message	= $this->Response['L_SHORTMESSAGE0'];
    1022. 

  1022. 			$this->_error_long_message	= $this->Response['L_LONGMESSAGE0'];
    1023. 

  1023. 			$this->_error_severity_code	= $this->Response['L_SEVERITYCODE0'];
    1024. 

  1024. 			$this->_error_version		= @$this->Response['VERSION'];
    1025. 

  1025. 			$this->_error_build			= @$this->Response['BUILD']; 
    1026. 

  1026. 			
    1027. 

  1027. 			return false;
    1028. 

  1028. 		}
    1029. 

  1029. 		/*
    1030. 

  1030. 		*************
    1031. 

  1031. 		if SUCCESS
    1032. 

  1032. 		*************
    1033. 

  1033. 		*/
    1034. 

  1034. 		elseif(strtoupper($this->Response["ACK"]) == 'SUCCESS' OR strtoupper($this->Response["ACK"]) == 'SUCCESSWITHWARNING')
    1035. 

  1035. 		{
    1036. 

  1036. 			/* Take the response variables and put them into the local class variables */
    1037. 

  1037. 			foreach($this->ResponseFieldsArray['DoCapture'] as $key => $value)
    1038. 

  1038. 				$this->$key = $this->Response[$value];
    1039. 

  1039. 			
    1040. 

  1040. 			return true;
    1041. 

  1041. 		}
    1042. 

  1042. 	}
    1043. 

  1043. 	
    1044. 

  1044. 	
    1045. 

  1045. 	
    1046. 

  1046. 	
    1047. 

  1047. 	
    1048. 

  1048. 	public function do_authorization()
    1049. 

  1049. 	{
    1050. 

  1050. 		// urlencode the needed variables
    1051. 

  1051. 		$this->urlencodeVariables();
    1052. 

  1052. 		
    1053. 

  1053. 		/* Construct the request string that will be sent to PayPal.
    1054. 

  1054. 		   The variable $nvpstr contains all the variables and is a
    1055. 

  1055. 		   name value pair string with & as a delimiter */
    1056. 

  1056. 		$nvpstr = $this->generateNVPString('DoAuthorization');
    1057. 

  1057. 		
    1058. 

  1058. 		// decode the variables incase we still require access to them in our program
    1059. 

  1059. 		$this->urldecodeVariables();
    1060. 

  1060. 		
    1061. 

  1061. 		/* Make the API call to PayPal, using API signature.
    1062. 

  1062. 		   The API response is stored in an associative array called $this->Response */
    1063. 

  1063. 		$this->Response = $this->hash_call("DoAuthorization", $nvpstr);
    1064. 

  1064. 		
    1065. 

  1065. 		// TODO: Add error handling for the hash_call
    1066. 

  1066. 		
    1067. 

  1067. 		/*
    1068. 

  1068. 		*************
    1069. 

  1069. 		if NO SUCCESS
    1070. 

  1070. 		*************
    1071. 

  1071. 		*/
    1072. 

  1072. 		if(strtoupper($this->Response["ACK"]) != "SUCCESS" AND strtoupper($this->Response["ACK"]) != "SUCCESSWITHWARNING")
    1073. 

  1073. 		{
    1074. 

  1074. 			$this->Error['TIMESTAMP']		= @$this->Response['TIMESTAMP'];
    1075. 

  1075. 			$this->Error['CORRELATIONID']	= @$this->Response['CORRELATIONID'];
    1076. 

  1076. 			$this->Error['ACK']				= $this->Response['ACK'];
    1077. 

  1077. 			$this->Error['ERRORCODE']		= $this->Response['L_ERRORCODE0'];
    1078. 

  1078. 			$this->Error['SHORTMESSAGE']	= $this->Response['L_SHORTMESSAGE0'];
    1079. 

  1079. 			$this->Error['LONGMESSAGE']		= $this->Response['L_LONGMESSAGE0'];
    1080. 

  1080. 			$this->Error['SEVERITYCODE']	= $this->Response['L_SEVERITYCODE0'];
    1081. 

  1081. 			$this->Error['VERSION']			= @$this->Response['VERSION'];
    1082. 

  1082. 			$this->Error['BUILD']			= @$this->Response['BUILD'];
    1083. 

  1083. 			
    1084. 

  1084. 			// TODO: Error codes for AVSCODE and CVV@MATCH
    1085. 

  1085. 			
    1086. 

  1086. 			$this->_error				= true;
    1087. 

  1087. 			$this->_error_ack			= $this->Response['ACK'];
    1088. 

  1088. 			$this->ack					= 'Failure';
    1089. 

  1089. 			$this->_error_type			= 'paypal';
    1090. 

  1090. 			$this->_error_date			= $this->Response['TIMESTAMP'];
    1091. 

  1091. 			$this->_error_code			= $this->Response['L_ERRORCODE0'];
    1092. 

  1092. 			$this->_error_short_message	= $this->Response['L_SHORTMESSAGE0'];
    1093. 

  1093. 			$this->_error_long_message	= $this->Response['L_LONGMESSAGE0'];
    1094. 

  1094. 			$this->_error_severity_code	= $this->Response['L_SEVERITYCODE0'];
    1095. 

  1095. 			$this->_error_version		= @$this->Response['VERSION'];
    1096. 

  1096. 			$this->_error_build			= @$this->Response['BUILD']; 
    1097. 

  1097. 			
    1098. 

  1098. 			return false;
    1099. 

  1099. 		}
    1100. 

  1100. 		/*
    1101. 

  1101. 		*************
    1102. 

  1102. 		if SUCCESS
    1103. 

  1103. 		*************
    1104. 

  1104. 		*/
    1105. 

  1105. 		elseif(strtoupper($this->Response["ACK"]) == 'SUCCESS' OR strtoupper($this->Response["ACK"]) == 'SUCCESSWITHWARNING')
    1106. 

  1106. 		{
    1107. 

  1107. 			/* Take the response variables and put them into the local class variables */
    1108. 

  1108. 			foreach($this->ResponseFieldsArray['DoAuthorization'] as $key => $value)
    1109. 

  1109. 				$this->$key = $this->Response[$value];
    1110. 

  1110. 			
    1111. 

  1111. 			return true;
    1112. 

  1112. 		}
    1113. 

  1113. 	}
    1114. 

  1114. 

  1115. 

  1116. 

  1117. 

  1118. 

  1119. 	public function do_reauthorization()
    1120. 

  1120. 	{
    1121. 

  1121. 		// urlencode the needed variables
    1122. 

  1122. 		$this->urlencodeVariables();
    1123. 

  1123. 		
    1124. 

  1124. 		/* Construct the request string that will be sent to PayPal.
    1125. 

  1125. 		   The variable $nvpstr contains all the variables and is a
    1126. 

  1126. 		   name value pair string with & as a delimiter */
    1127. 

  1127. 		$nvpstr = $this->generateNVPString('DoReauthorization');
    1128. 

  1128. 		
    1129. 

  1129. 		// decode the variables incase we still require access to them in our program
    1130. 

  1130. 		$this->urldecodeVariables();
    1131. 

  1131. 		
    1132. 

  1132. 		/* Make the API call to PayPal, using API signature.
    1133. 

  1133. 		   The API response is stored in an associative array called $this->Response */
    1134. 

  1134. 		$this->Response = $this->hash_call("DoReauthorization", $nvpstr);
    1135. 

  1135. 		
    1136. 

  1136. 		// TODO: Add error handling for the hash_call
    1137. 

  1137. 		
    1138. 

  1138. 		/*
    1139. 

  1139. 		*************
    1140. 

  1140. 		if NO SUCCESS
    1141. 

  1141. 		*************
    1142. 

  1142. 		*/
    1143. 

  1143. 		if(strtoupper($this->Response["ACK"]) != "SUCCESS" AND strtoupper($this->Response["ACK"]) != "SUCCESSWITHWARNING")
    1144. 

  1144. 		{
    1145. 

  1145. 			$this->Error['TIMESTAMP']		= @$this->Response['TIMESTAMP'];
    1146. 

  1146. 			$this->Error['CORRELATIONID']	= @$this->Response['CORRELATIONID'];
    1147. 

  1147. 			$this->Error['ACK']				= $this->Response['ACK'];
    1148. 

  1148. 			$this->Error['ERRORCODE']		= $this->Response['L_ERRORCODE0'];
    1149. 

  1149. 			$this->Error['SHORTMESSAGE']	= $this->Response['L_SHORTMESSAGE0'];
    1150. 

  1150. 			$this->Error['LONGMESSAGE']		= $this->Response['L_LONGMESSAGE0'];
    1151. 

  1151. 			$this->Error['SEVERITYCODE']	= $this->Response['L_SEVERITYCODE0'];
    1152. 

  1152. 			$this->Error['VERSION']			= @$this->Response['VERSION'];
    1153. 

  1153. 			$this->Error['BUILD']			= @$this->Response['BUILD'];
    1154. 

  1154. 			
    1155. 

  1155. 			// TODO: Error codes for AVSCODE and CVV@MATCH
    1156. 

  1156. 			
    1157. 

  1157. 			$this->_error				= true;
    1158. 

  1158. 			$this->_error_ack			= $this->Response['ACK'];
    1159. 

  1159. 			$this->ack					= 'Failure';
    1160. 

  1160. 			$this->_error_type			= 'paypal';
    1161. 

  1161. 			$this->_error_date			= $this->Response['TIMESTAMP'];
    1162. 

  1162. 			$this->_error_code			= $this->Response['L_ERRORCODE0'];
    1163. 

  1163. 			$this->_error_short_message	= $this->Response['L_SHORTMESSAGE0'];
    1164. 

  1164. 			$this->_error_long_message	= $this->Response['L_LONGMESSAGE0'];
    1165. 

  1165. 			$this->_error_severity_code	= $this->Response['L_SEVERITYCODE0'];
    1166. 

  1166. 			$this->_error_version		= @$this->Response['VERSION'];
    1167. 

  1167. 			$this->_error_build			= @$this->Response['BUILD']; 
    1168. 

  1168. 			
    1169. 

  1169. 			return false;
    1170. 

  1170. 		}
    1171. 

  1171. 		/*
    1172. 

  1172. 		*************
    1173. 

  1173. 		if SUCCESS
    1174. 

  1174. 		*************
    1175. 

  1175. 		*/
    1176. 

  1176. 		elseif(strtoupper($this->Response["ACK"]) == 'SUCCESS' OR strtoupper($this->Response["ACK"]) == 'SUCCESSWITHWARNING')
    1177. 

  1177. 		{
    1178. 

  1178. 			/* Take the response variables and put them into the local class variables */
    1179. 

  1179. 			foreach($this->ResponseFieldsArray['DoReauthorization'] as $key => $value)
    1180. 

  1180. 				$this->$key = $this->Response[$value];
    1181. 

  1181. 			
    1182. 

  1182. 			return true;
    1183. 

  1183. 		}
    1184. 

  1184. 	}
    1185. 

  1185. 

  1186. 

  1187. 

  1188. 

  1189. 

  1190. 	public function do_void()
    1191. 

  1191. 	{
    1192. 

  1192. 		// urlencode the needed variables
    1193. 

  1193. 		$this->urlencodeVariables();
    1194. 

  1194. 		
    1195. 

  1195. 		/* Construct the request string that will be sent to PayPal.
    1196. 

  1196. 		   The variable $nvpstr contains all the variables and is a
    1197. 

  1197. 		   name value pair string with & as a delimiter */
    1198. 

  1198. 		$nvpstr = $this->generateNVPString('DoVoid');
    1199. 

  1199. 		
    1200. 

  1200. 		// decode the variables incase we still require access to them in our program
    1201. 

  1201. 		$this->urldecodeVariables();
    1202. 

  1202. 		
    1203. 

  1203. 		/* Make the API call to PayPal, using API signature.
    1204. 

  1204. 		   The API response is stored in an associative array called $this->Response */
    1205. 

  1205. 		$this->Response = $this->hash_call("DoVoid", $nvpstr);
    1206. 

  1206. 		
    1207. 

  1207. 		// TODO: Add error handling for the hash_call
    1208. 

  1208. 		
    1209. 

  1209. 		/*
    1210. 

  1210. 		*************
    1211. 

  1211. 		if NO SUCCESS
    1212. 

  1212. 		*************
    1213. 

  1213. 		*/
    1214. 

  1214. 		if(strtoupper($this->Response["ACK"]) != "SUCCESS" AND strtoupper($this->Response["ACK"]) != "SUCCESSWITHWARNING")
    1215. 

  1215. 		{
    1216. 

  1216. 			$this->Error['TIMESTAMP']		= @$this->Response['TIMESTAMP'];
    1217. 

  1217. 			$this->Error['CORRELATIONID']	= @$this->Response['CORRELATIONID'];
    1218. 

  1218. 			$this->Error['ACK']				= $this->Response['ACK'];
    1219. 

  1219. 			$this->Error['ERRORCODE']		= $this->Response['L_ERRORCODE0'];
    1220. 

  1220. 			$this->Error['SHORTMESSAGE']	= $this->Response['L_SHORTMESSAGE0'];
    1221. 

  1221. 			$this->Error['LONGMESSAGE']		= $this->Response['L_LONGMESSAGE0'];
    1222. 

  1222. 			$this->Error['SEVERITYCODE']	= $this->Response['L_SEVERITYCODE0'];
    1223. 

  1223. 			$this->Error['VERSION']			= @$this->Response['VERSION'];
    1224. 

  1224. 			$this->Error['BUILD']			= @$this->Response['BUILD'];
    1225. 

  1225. 			
    1226. 

  1226. 			// TODO: Error codes for AVSCODE and CVV@MATCH
    1227. 

  1227. 			
    1228. 

  1228. 			$this->_error				= true;
    1229. 

  1229. 			$this->_error_ack			= $this->Response['ACK'];
    1230. 

  1230. 			$this->ack					= 'Failure';
    1231. 

  1231. 			$this->_error_type			= 'paypal';
    1232. 

  1232. 			$this->_error_date			= $this->Response['TIMESTAMP'];
    1233. 

  1233. 			$this->_error_code			= $this->Response['L_ERRORCODE0'];
    1234. 

  1234. 			$this->_error_short_message	= $this->Response['L_SHORTMESSAGE0'];
    1235. 

  1235. 			$this->_error_long_message	= $this->Response['L_LONGMESSAGE0'];
    1236. 

  1236. 			$this->_error_severity_code	= $this->Response['L_SEVERITYCODE0'];
    1237. 

  1237. 			$this->_error_version		= @$this->Response['VERSION'];
    1238. 

  1238. 			$this->_error_build			= @$this->Response['BUILD']; 
    1239. 

  1239. 			
    1240. 

  1240. 			return false;
    1241. 

  1241. 		}
    1242. 

  1242. 		/*
    1243. 

  1243. 		*************
    1244. 

  1244. 		if SUCCESS
    1245. 

  1245. 		*************
    1246. 

  1246. 		*/
    1247. 

  1247. 		elseif(strtoupper($this->Response["ACK"]) == 'SUCCESS' OR strtoupper($this->Response["ACK"]) == 'SUCCESSWITHWARNING')
    1248. 

  1248. 		{
    1249. 

  1249. 			/* Take the response variables and put them into the local class variables */
    1250. 

  1250. 			foreach($this->ResponseFieldsArray['DoVoid'] as $key => $value)
    1251. 

  1251. 				$this->$key = $this->Response[$value];
    1252. 

  1252. 			
    1253. 

  1253. 			return true;
    1254. 

  1254. 		}
    1255. 

  1255. 	}
    1256. 

  1256. 

  1257. 	
    1258. 

  1258. 	
    1259. 

  1259. 	
    1260. 

  1260. 	
    1261. 

  1261. 	
    1262. 

  1262. 	public function do_direct_payment()
    1263. 

  1263. 	{
    1264. 

  1264. 		// urlencode the needed variables
    1265. 

  1265. 		$this->urlencodeVariables();
    1266. 

  1266. 		
    1267. 

  1267. 		/* Construct the request string that will be sent to PayPal.
    1268. 

  1268. 		   The variable $nvpstr contains all the variables and is a
    1269. 

  1269. 		   name value pair string with & as a delimiter */
    1270. 

  1270. 		$nvpstr = $this->generateNVPString('DoDirectPayment');
    1271. 

  1271. 		
    1272. 

  1272. 		/* Construct and add any items found in this instance */
    1273. 

  1273. 		if(!empty($this->ItemsArray))
    1274. 

  1274. 		{
    1275. 

  1275. 			// Counter for the total of all the items put together
    1276. 

  1276. 			$total_items_amount = 0;
    1277. 

  1277. 			$total_items_tax_amount = 0;
    1278. 

  1278. 			// Go through the items array
    1279. 

  1279. 			foreach($this->ItemsArray as $key => $value)
    1280. 

  1280. 			{
    1281. 

  1281. 				// Get the array of the current item from the main array
    1282. 

  1282. 				$current_item = $this->ItemsArray[$key];
    1283. 

  1283. 				// Add it to the request string
    1284. 

  1284. 				$nvpstr .= "&L_NAME".$key."=".$current_item['name'].
    1285. 

  1285. 							"&L_NUMBER".$key."=".$current_item['number'].
    1286. 

  1286. 							"&L_QTY".$key."=".$current_item['quantity'].
    1287. 

  1287. 							"&L_TAXAMT".$key."=".$current_item['amount_tax'].
    1288. 

  1288. 							"&L_AMT".$key."=".$current_item['amount'];
    1289. 

  1289. 				// Add this item's amount to the total current count
    1290. 

  1290. 				$total_items_amount += ($current_item['amount'] * $current_item['quantity']);
    1291. 

  1291. 				$total_items_tax_amount += ($current_item['amount_tax'] * $current_item['quantity']);
    1292. 

  1292. 			}
    1293. 

  1293. 			// Set the amount_items for this instance and ITEMAMT added to the request string
    1294. 

  1294. 			$this->amount_items = $total_items_amount;
    1295. 

  1295. 			// Add this to our NVP string
    1296. 

  1296. 			$nvpstr .= "&ITEMAMT=".urlencode($total_items_amount);
    1297. 

  1297. 			// If our entire tax amount is not set, we will automatically set it based on the items tax amount
    1298. 

  1298. 			if($this->amount_tax == 0 OR empty($this->amount_tax))
    1299. 

  1299. 				$nvpstr .= "&TAXAMT=".urlencode($total_items_tax_amount);
    1300. 

  1300. 		}
    1301. 

  1301. 		
    1302. 

  1302. 		// decode the variables incase we still require access to them in our program
    1303. 

  1303. 		$this->urldecodeVariables();
    1304. 

  1304. 		
    1305. 

  1305. 		/* Make the API call to PayPal, using API signature.
    1306. 

  1306. 		   The API response is stored in an associative array called $this->Response */
    1307. 

  1307. 		$this->Response = $this->hash_call("DoDirectPayment", $nvpstr);
    1308. 

  1308. 		
    1309. 

  1309. 		// TODO: Add error handling for the hash_call
    1310. 

  1310. 		
    1311. 

  1311. 		/*
    1312. 

  1312. 		*************
    1313. 

  1313. 		if NO SUCCESS
    1314. 

  1314. 		*************
    1315. 

  1315. 		*/
    1316. 

  1316. 		if(strtoupper($this->Response["ACK"]) != "SUCCESS" AND strtoupper($this->Response["ACK"]) != "SUCCESSWITHWARNING")
    1317. 

  1317. 		{
    1318. 

  1318. 			$this->Error['TIMESTAMP']		= @$this->Response['TIMESTAMP'];
    1319. 

  1319. 			$this->Error['CORRELATIONID']	= @$this->Response['CORRELATIONID'];
    1320. 

  1320. 			$this->Error['ACK']				= $this->Response['ACK'];
    1321. 

  1321. 			$this->Error['ERRORCODE']		= $this->Response['L_ERRORCODE0'];
    1322. 

  1322. 			$this->Error['SHORTMESSAGE']	= $this->Response['L_SHORTMESSAGE0'];
    1323. 

  1323. 			$this->Error['LONGMESSAGE']		= $this->Response['L_LONGMESSAGE0'];
    1324. 

  1324. 			$this->Error['SEVERITYCODE']	= $this->Response['L_SEVERITYCODE0'];
    1325. 

  1325. 			$this->Error['VERSION']			= @$this->Response['VERSION'];
    1326. 

  1326. 			$this->Error['BUILD']			= @$this->Response['BUILD'];
    1327. 

  1327. 			
    1328. 

  1328. 			// TODO: Error codes for AVSCODE and CVV@MATCH
    1329. 

  1329. 			
    1330. 

  1330. 			$this->_error				= true;
    1331. 

  1331. 			$this->_error_ack			= $this->Response['ACK'];
    1332. 

  1332. 			$this->ack					= 'Failure';
    1333. 

  1333. 			$this->_error_type			= 'paypal';
    1334. 

  1334. 			$this->_error_date			= $this->Response['TIMESTAMP'];
    1335. 

  1335. 			$this->_error_code			= $this->Response['L_ERRORCODE0'];
    1336. 

  1336. 			$this->_error_short_message	= $this->Response['L_SHORTMESSAGE0'];
    1337. 

  1337. 			$this->_error_long_message	= $this->Response['L_LONGMESSAGE0'];
    1338. 

  1338. 			$this->_error_severity_code	= $this->Response['L_SEVERITYCODE0'];
    1339. 

  1339. 			$this->_error_version		= @$this->Response['VERSION'];
    1340. 

  1340. 			$this->_error_build			= @$this->Response['BUILD']; 
    1341. 

  1341. 			
    1342. 

  1342. 			return false;
    1343. 

  1343. 		}
    1344. 

  1344. 		/*
    1345. 

  1345. 		*************
    1346. 

  1346. 		if SUCCESS
    1347. 

  1347. 		*************
    1348. 

  1348. 		*/
    1349. 

  1349. 		elseif(strtoupper($this->Response["ACK"]) == 'SUCCESS' OR strtoupper($this->Response["ACK"]) == 'SUCCESSWITHWARNING')
    1350. 

  1350. 		{
    1351. 

  1351. 			/* Take the response variables and put them into the local class variables */
    1352. 

  1352. 			foreach($this->ResponseFieldsArray['DoDirectPayment'] as $key => $value)
    1353. 

  1353. 				$this->$key = $this->Response[$value];
    1354. 

  1354. 			
    1355. 

  1355. 			return true;
    1356. 

  1356. 		}
    1357. 

  1357. 	}
    1358. 

  1358. 	
    1359. 

  1359. 	
    1360. 

  1360. 	
    1361. 

  1361. 	
    1362. 

  1362. 	
    1363. 

  1363. 	function set_express_checkout()
    1364. 

  1364. 	{
    1365. 

  1365. 		// TODO: Add error handling prior to trying to make PayPal calls. ie: missing amount_total or RETURN_URL
    1366. 

  1366. 		
    1367. 

  1367. 		// urlencode the needed variables
    1368. 

  1368. 		$this->urlencodeVariables();
    1369. 

  1369. 		
    1370. 

  1370. 		/* Construct the parameter string that describes the PayPal payment
    1371. 

  1371. 			the varialbes were set in the web form, and the resulting string
    1372. 

  1372. 			is stored in $nvpstr
    1373. 

  1373. 			*/
    1374. 

  1374. 		$nvpstr = $this->generateNVPString('SetExpressCheckout');
    1375. 

  1375. 				
    1376. 

  1376. 		// decode the variables incase we still require access to them in our program
    1377. 

  1377. 		$this->urldecodeVariables();
    1378. 

  1378. 		
    1379. 

  1379. 		/* Make the call to PayPal to set the Express Checkout token
    1380. 

  1380. 			If the API call succeded, then redirect the buyer to PayPal
    1381. 

  1381. 			to begin to authorize payment.  If an error occured, show the
    1382. 

  1382. 			resulting errors
    1383. 

  1383. 			*/
    1384. 

  1384. 		$this->Response = $this->hash_call("SetExpressCheckout", $nvpstr);
    1385. 

  1385. 		
    1386. 

  1386. 		/* Display the API response back to the browser.
    1387. 

  1387. 		   If the response from PayPal was a success, display the response parameters'
    1388. 

  1388. 		   If the response was an error, display the errors received using APIError.php.
    1389. 

  1389. 		   */		
    1390. 

  1390. 		/*
    1391. 

  1391. 		*************
    1392. 

  1392. 		if NO SUCCESS
    1393. 

  1393. 		*************
    1394. 

  1394. 		*/
    1395. 

  1395. 		if(strtoupper($this->Response["ACK"]) != "SUCCESS")
    1396. 

  1396. 		{
    1397. 

  1397. 			$this->Error['TIMESTAMP']		= @$this->Response['TIMESTAMP'];
    1398. 

  1398. 			$this->Error['CORRELATIONID']	= @$this->Response['CORRELATIONID'];
    1399. 

  1399. 			$this->Error['ACK']				= $this->Response['ACK'];
    1400. 

  1400. 			$this->Error['ERRORCODE']		= $this->Response['L_ERRORCODE0'];
    1401. 

  1401. 			$this->Error['SHORTMESSAGE']	= $this->Response['L_SHORTMESSAGE0'];
    1402. 

  1402. 			$this->Error['LONGMESSAGE']		= $this->Response['L_LONGMESSAGE0'];
    1403. 

  1403. 			$this->Error['SEVERITYCODE']	= $this->Response['L_SEVERITYCODE0'];
    1404. 

  1404. 			$this->Error['VERSION']			= @$this->Response['VERSION'];
    1405. 

  1405. 			$this->Error['BUILD']			= @$this->Response['BUILD'];
    1406. 

  1406. 			
    1407. 

  1407. 			$this->_error				= true;
    1408. 

  1408. 			$this->_error_ack			= $this->Response['ACK'];
    1409. 

  1409. 			$this->ack					= 'Failure';
    1410. 

  1410. 			$this->_error_type			= 'paypal';
    1411. 

  1411. 			$this->_error_date			= $this->Response['TIMESTAMP'];
    1412. 

  1412. 			$this->_error_code			= $this->Response['L_ERRORCODE0'];
    1413. 

  1413. 			$this->_error_short_message	= $this->Response['L_SHORTMESSAGE0'];
    1414. 

  1414. 			$this->_error_long_message	= $this->Response['L_LONGMESSAGE0'];
    1415. 

  1415. 			$this->_error_severity_code	= $this->Response['L_SEVERITYCODE0'];
    1416. 

  1416. 			$this->_error_version		= @$this->Response['VERSION'];
    1417. 

  1417. 			$this->_error_build			= @$this->Response['BUILD']; 
    1418. 

  1418. 			
    1419. 

  1419. 			return false;
    1420. 

  1420. 			/*
    1421. 

  1421. 			$_SESSION['reshash']=$this->Response;
    1422. 

  1422. 			$location = "APIError.php";
    1423. 

  1423. 			header("Location: $location");
    1424. 

  1424. 			*/
    1425. 

  1425. 		}
    1426. 

  1426. 		/*
    1427. 

  1427. 		*************
    1428. 

  1428. 		if SUCCESS
    1429. 

  1429. 		*************
    1430. 

  1430. 		*/
    1431. 

  1431. 		elseif(strtoupper($this->Response["ACK"]) == 'SUCCESS')
    1432. 

  1432. 		{
    1433. 

  1433. 			/* Take the response variables and put them into the local class variables */
    1434. 

  1434. 			foreach($this->ResponseFieldsArray['SetExpressCheckout'] as $key => $value)
    1435. 

  1435. 				$this->$key = $this->Response[$value];
    1436. 

  1436. 			
    1437. 

  1437. 			return true;
    1438. 

  1438. 		}
    1439. 

  1439. 	}
    1440. 

  1440. 	
    1441. 

  1441. 	function set_express_checkout_successful_redirect()
    1442. 

  1442. 	{
    1443. 

  1443. 		// Redirect to paypal.com here
    1444. 

  1444. 		$token = urlencode($this->Response["TOKEN"]);
    1445. 

  1445. 		$paypal_url = $this->PAYPAL_URL.$token;
    1446. 

  1446. 		header("Location: ".$paypal_url);
    1447. 

  1447. 	}
    1448. 

  1448. 	
    1449. 

  1449. 	
    1450. 

  1450. 	
    1451. 

  1451. 	
    1452. 

  1452. 	function get_express_checkout_details()
    1453. 

  1453. 	{
    1454. 

  1454. 		// TODO: Add error handling prior to PayPal calls. ie: missing TOKEN
    1455. 

  1455. 		
    1456. 

  1456. 		/* At this point, the buyer has completed in authorizing payment
    1457. 

  1457. 			at PayPal.  The script will now call PayPal with the details
    1458. 

  1458. 			of the authorization, incuding any shipping information of the
    1459. 

  1459. 			buyer.  Remember, the authorization is not a completed transaction
    1460. 

  1460. 			at this state - the buyer still needs an additional step to finalize
    1461. 

  1461. 			the transaction
    1462. 

  1462. 			*/
    1463. 

  1463. 

  1464. 		 /* Build a second API request to PayPal, using the token as the
    1465. 

  1465. 			ID to get the details on the payment authorization
    1466. 

  1466. 			*/
    1467. 

  1467. 		/* Construct the parameter string that describes the PayPal payment
    1468. 

  1468. 			the varialbes were set in the web form, and the resulting string
    1469. 

  1469. 			is stored in $nvpstr
    1470. 

  1470. 			*/
    1471. 

  1471. 		$nvpstr = $this->generateNVPString('GetExpressCheckoutDetails');
    1472. 

  1472. 

  1473. 		 /* Make the API call and store the results in an array.  If the
    1474. 

  1474. 			call was a success, show the authorization details, and provide
    1475. 

  1475. 			an action to complete the payment.  If failed, show the error
    1476. 

  1476. 			*/
    1477. 

  1477. 		$this->Response = $this->hash_call("GetExpressCheckoutDetails", $nvpstr);
    1478. 

  1478. 		
    1479. 

  1479. 		/*
    1480. 

  1480. 		*************
    1481. 

  1481. 		if NO SUCCESS
    1482. 

  1482. 		*************
    1483. 

  1483. 		*/
    1484. 

  1484. 		if(strtoupper($this->Response["ACK"]) != "SUCCESS")
    1485. 

  1485. 		{
    1486. 

  1486. 			$this->Error['TIMESTAMP']		= @$this->Response['TIMESTAMP'];
    1487. 

  1487. 			$this->Error['CORRELATIONID']	= @$this->Response['CORRELATIONID'];
    1488. 

  1488. 			$this->Error['ACK']				= $this->Response['ACK'];
    1489. 

  1489. 			$this->Error['ERRORCODE']		= $this->Response['L_ERRORCODE0'];
    1490. 

  1490. 			$this->Error['SHORTMESSAGE']	= $this->Response['L_SHORTMESSAGE0'];
    1491. 

  1491. 			$this->Error['LONGMESSAGE']		= $this->Response['L_LONGMESSAGE0'];
    1492. 

  1492. 			$this->Error['SEVERITYCODE']	= $this->Response['L_SEVERITYCODE0'];
    1493. 

  1493. 			$this->Error['VERSION']			= @$this->Response['VERSION'];
    1494. 

  1494. 			$this->Error['BUILD']			= @$this->Response['BUILD'];
    1495. 

  1495. 			
    1496. 

  1496. 			$this->_error				= true;
    1497. 

  1497. 			$this->_error_ack			= $this->Response['ACK'];
    1498. 

  1498. 			$this->ack					= 'Failure';
    1499. 

  1499. 			$this->_error_type			= 'paypal';
    1500. 

  1500. 			$this->_error_date			= $this->Response['TIMESTAMP'];
    1501. 

  1501. 			$this->_error_code			= $this->Response['L_ERRORCODE0'];
    1502. 

  1502. 			$this->_error_short_message	= $this->Response['L_SHORTMESSAGE0'];
    1503. 

  1503. 			$this->_error_long_message	= $this->Response['L_LONGMESSAGE0'];
    1504. 

  1504. 			$this->_error_severity_code	= $this->Response['L_SEVERITYCODE0'];
    1505. 

  1505. 

  1506. 			$this->_error_version		= @$this->Response['VERSION'];
    1507. 

  1507. 			$this->_error_build			= @$this->Response['BUILD']; 
    1508. 

  1508. 			
    1509. 

  1509. 			return false;
    1510. 

  1510. 		}
    1511. 

  1511. 		/*
    1512. 

  1512. 		***********
    1513. 

  1513. 		if SUCCESS
    1514. 

  1514. 		***********
    1515. 

  1515. 		*/
    1516. 

  1516. 		elseif(strtoupper($this->Response["ACK"]) == 'SUCCESS')
    1517. 

  1517. 		{
    1518. 

  1518. 			/*
    1519. 

  1519. 			Take the response variables and put them into the local class variables
    1520. 

  1520. 			*/
    1521. 

  1521. 			foreach($this->ResponseFieldsArray['GetExpressCheckoutDetails'] as $key => $value)
    1522. 

  1522. 				$this->$key = @$this->Response[$value];
    1523. 

  1523. 			
    1524. 

  1524. 			return true;
    1525. 

  1525. 		}
    1526. 

  1526. 		
    1527. 

  1527. 	}
    1528. 

  1528. 	
    1529. 

  1529. 	
    1530. 

  1530. 	
    1531. 

  1531. 	
    1532. 

  1532. 	function do_express_checkout_payment()
    1533. 

  1533. 	{
    1534. 

  1534. 		// TODO: Error checking. ie: we require a token and payer_id here
    1535. 

  1535. 		
    1536. 

  1536. 		// urlencode the needed variables
    1537. 

  1537. 		$this->urlencodeVariables();
    1538. 

  1538. 		
    1539. 

  1539. 		/* Construct the parameter string that describes the PayPal payment
    1540. 

  1540. 			the varialbes were set in the web form, and the resulting string
    1541. 

  1541. 			is stored in $nvpstr
    1542. 

  1542. 			*/
    1543. 

  1543. 		$nvpstr = $this->generateNVPString('DoExpressCheckoutPayment');
    1544. 

  1544. 		
    1545. 

  1545. 		/* Construct and add any items found in this instance */
    1546. 

  1546. 		if(!empty($this->ItemsArray))
    1547. 

  1547. 		{
    1548. 

  1548. 			// Counter for the total of all the items put together
    1549. 

  1549. 			$total_items_amount = 0;
    1550. 

  1550. 			// Go through the items array
    1551. 

  1551. 			foreach($this->ItemsArray as $key => $value)
    1552. 

  1552. 			{
    1553. 

  1553. 				// Get the array of the current item from the main array
    1554. 

  1554. 				$current_item = $this->ItemsArray[$key];
    1555. 

  1555. 				// Add it to the request string
    1556. 

  1556. 				$nvpstr .= "&L_NAME".$key."=".$current_item['name'].
    1557. 

  1557. 							"&L_NUMBER".$key."=".$current_item['number'].
    1558. 

  1558. 							"&L_QTY".$key."=".$current_item['quantity'].
    1559. 

  1559. 							"&L_TAXAMT".$key."=".$current_item['amount_tax'].
    1560. 

  1560. 							"&L_AMT".$key."=".$current_item['amount'];
    1561. 

  1561. 				// Add this item's amount to the total current count
    1562. 

  1562. 				$total_items_amount += ($current_item['amount'] * $current_item['quantity']);
    1563. 

  1563. 			}
    1564. 

  1564. 			// Set the amount_items for this instance and ITEMAMT added to the request string
    1565. 

  1565. 			$this->amount_items = $total_items_amount;
    1566. 

  1566. 			$nvpstr .= "&ITEMAMT=".$total_items_amount;
    1567. 

  1567. 		}
    1568. 

  1568. 

  1569. 		 /* Make the call to PayPal to finalize payment
    1570. 

  1570. 			If an error occured, show the resulting errors
    1571. 

  1571. 			*/
    1572. 

  1572. 		$this->Response = $this->hash_call("DoExpressCheckoutPayment", $nvpstr);
    1573. 

  1573. 		
    1574. 

  1574. 		// decode the variables incase we still require access to them in our program
    1575. 

  1575. 		$this->urldecodeVariables();
    1576. 

  1576. 		
    1577. 

  1577. 		/*
    1578. 

  1578. 			*************
    1579. 

  1579. 			if NO SUCCESS
    1580. 

  1580. 			*************
    1581. 

  1581. 			*/
    1582. 

  1582. 		if(strtoupper($this->Response["ACK"]) != "SUCCESS")
    1583. 

  1583. 		{
    1584. 

  1584. 			$this->Error['TIMESTAMP']		= @$this->Response['TIMESTAMP'];
    1585. 

  1585. 			$this->Error['CORRELATIONID']	= @$this->Response['CORRELATIONID'];
    1586. 

  1586. 			$this->Error['ACK']				= $this->Response['ACK'];
    1587. 

  1587. 			$this->Error['ERRORCODE']		= $this->Response['L_ERRORCODE0'];
    1588. 

  1588. 			$this->Error['SHORTMESSAGE']	= $this->Response['L_SHORTMESSAGE0'];
    1589. 

  1589. 			$this->Error['LONGMESSAGE']		= $this->Response['L_LONGMESSAGE0'];
    1590. 

  1590. 			$this->Error['SEVERITYCODE']	= $this->Response['L_SEVERITYCODE0'];
    1591. 

  1591. 			$this->Error['VERSION']			= @$this->Response['VERSION'];
    1592. 

  1592. 			$this->Error['BUILD']			= @$this->Response['BUILD'];
    1593. 

  1593. 			
    1594. 

  1594. 			$this->_error				= true;
    1595. 

  1595. 			$this->_error_ack			= $this->Response['ACK'];
    1596. 

  1596. 			$this->ack					= 'Failure';
    1597. 

  1597. 			$this->_error_type			= 'paypal';
    1598. 

  1598. 			$this->_error_date			= $this->Response['TIMESTAMP'];
    1599. 

  1599. 			$this->_error_code			= $this->Response['L_ERRORCODE0'];
    1600. 

  1600. 			$this->_error_short_message	= $this->Response['L_SHORTMESSAGE0'];
    1601. 

  1601. 			$this->_error_long_message	= $this->Response['L_LONGMESSAGE0'];
    1602. 

  1602. 			$this->_error_severity_code	= $this->Response['L_SEVERITYCODE0'];
    1603. 

  1603. 			$this->_error_version		= @$this->Response['VERSION'];
    1604. 

  1604. 			$this->_error_build			= @$this->Response['BUILD']; 
    1605. 

  1605. 			
    1606. 

  1606. 			return false;
    1607. 

  1607. 		}
    1608. 

  1608. 		/*
    1609. 

  1609. 			*************
    1610. 

  1610. 			if SUCCESS
    1611. 

  1611. 			*************
    1612. 

  1612. 			*/
    1613. 

  1613. 		elseif(strtoupper($this->Response["ACK"]) == 'SUCCESS')
    1614. 

  1614. 		{
    1615. 

  1615. 			/*
    1616. 

  1616. 			Take the response variables and put them into the local class variables
    1617. 

  1617. 			*/
    1618. 

  1618. 			foreach($this->ResponseFieldsArray['DoExpressCheckoutPayment'] as $key => $value)
    1619. 

  1619. 				$this->$key = @$this->Response[$value];
    1620. 

  1620. 			
    1621. 

  1621. 			return true;
    1622. 

  1622. 		}
    1623. 

  1623. 	}
    1624. 

  1624. 	
    1625. 

  1625. 	
    1626. 

  1626. 	
    1627. 

  1627. 	
    1628. 

  1628. 	function get_transaction_details()
    1629. 

  1629. 	{
    1630. 

  1630. 		/* Construct the parameter string that describes the PayPal payment
    1631. 

  1631. 			the varialbes were set in the web form, and the resulting string
    1632. 

  1632. 			is stored in $nvpstr
    1633. 

  1633. 			*/
    1634. 

  1634. 		$nvpstr = $this->generateNVPString('GetTransactionDetails');
    1635. 

  1635. 		
    1636. 

  1636. 		/* Make the API call to PayPal, using API signature.
    1637. 

  1637. 		   The API response is stored in an associative array called $resArray */
    1638. 

  1638. 		$this->Response = $this->hash_call("GetTransactionDetails", $nvpstr);
    1639. 

  1639. 		
    1640. 

  1640. 		/* Next, collect the API request in the associative array $reqArray
    1641. 

  1641. 		   as well to display back to the browser.
    1642. 

  1642. 		   Normally you wouldnt not need to do this, but its shown for testing */
    1643. 

  1643. 		
    1644. 

  1644. 		/*
    1645. 

  1645. 			*************
    1646. 

  1646. 			if NO SUCCESS
    1647. 

  1647. 			*************
    1648. 

  1648. 			*/
    1649. 

  1649. 		if(strtoupper($this->Response["ACK"]) != "SUCCESS")
    1650. 

  1650. 		{
    1651. 

  1651. 			$this->Error['TIMESTAMP']		= @$this->Response['TIMESTAMP'];
    1652. 

  1652. 			$this->Error['CORRELATIONID']	= @$this->Response['CORRELATIONID'];
    1653. 

  1653. 			$this->Error['ACK']				= $this->Response['ACK'];
    1654. 

  1654. 			$this->Error['ERRORCODE']		= $this->Response['L_ERRORCODE0'];
    1655. 

  1655. 			$this->Error['SHORTMESSAGE']	= $this->Response['L_SHORTMESSAGE0'];
    1656. 

  1656. 			$this->Error['LONGMESSAGE']		= $this->Response['L_LONGMESSAGE0'];
    1657. 

  1657. 			$this->Error['SEVERITYCODE']	= $this->Response['L_SEVERITYCODE0'];
    1658. 

  1658. 			$this->Error['VERSION']			= @$this->Response['VERSION'];
    1659. 

  1659. 			$this->Error['BUILD']			= @$this->Response['BUILD'];
    1660. 

  1660. 			
    1661. 

  1661. 			$this->_error				= true;
    1662. 

  1662. 			$this->_error_ack			= $this->Response['ACK'];
    1663. 

  1663. 			$this->ack					= 'Failure';
    1664. 

  1664. 			$this->_error_type			= 'paypal';
    1665. 

  1665. 			$this->_error_date			= $this->Response['TIMESTAMP'];
    1666. 

  1666. 			$this->_error_code			= $this->Response['L_ERRORCODE0'];
    1667. 

  1667. 			$this->_error_short_message	= $this->Response['L_SHORTMESSAGE0'];
    1668. 

  1668. 			$this->_error_long_message	= $this->Response['L_LONGMESSAGE0'];
    1669. 

  1669. 			$this->_error_severity_code	= $this->Response['L_SEVERITYCODE0'];
    1670. 

  1670. 			$this->_error_version		= @$this->Response['VERSION'];
    1671. 

  1671. 			$this->_error_build			= @$this->Response['BUILD']; 
    1672. 

  1672. 			
    1673. 

  1673. 			return false;
    1674. 

  1674. 		}
    1675. 

  1675. 			/*
    1676. 

  1676. 			*************
    1677. 

  1677. 			if SUCCESS
    1678. 

  1678. 			*************
    1679. 

  1679. 			*/
    1680. 

  1680. 		elseif(strtoupper($this->Response["ACK"]) == 'SUCCESS')
    1681. 

  1681. 		{
    1682. 

  1682. 			/* Take the response variables and put them into the local class variables */
    1683. 

  1683. 			foreach($this->ResponseFieldsArray['GetTransactionDetails'] as $key => $value)
    1684. 

  1684. 				$this->$key = $this->Response[$value];
    1685. 

  1685. 			
    1686. 

  1686. 			$this->getItems($this->Response);
    1687. 

  1687. 			
    1688. 

  1688. 			return true;
    1689. 

  1689. 		}
    1690. 

  1690. 	}
    1691. 

  1691. 	
    1692. 

  1692. 	
    1693. 

  1693. 	
    1694. 

  1694. 	
    1695. 

  1695. 	function refund_transaction()
    1696. 

  1696. 	{
    1697. 

  1697. 		/* Construct the parameter string that describes the PayPal payment
    1698. 

  1698. 			the varialbes were set in the web form, and the resulting string
    1699. 

  1699. 			is stored in $nvpstr
    1700. 

  1700. 			*/
    1701. 

  1701. 		$nvpstr = $this->generateNVPString('RefundTransaction');
    1702. 

  1702. 		
    1703. 

  1703. 		/* Make the API call to PayPal, using API signature.
    1704. 

  1704. 		   The API response is stored in an associative array called $resArray */
    1705. 

  1705. 		$this->Response = $this->hash_call("RefundTransaction", $nvpstr);
    1706. 

  1706. 		
    1707. 

  1707. 		/* Next, collect the API request in the associative array $reqArray
    1708. 

  1708. 		   as well to display back to the browser.
    1709. 

  1709. 		   Normally you wouldnt not need to do this, but its shown for testing */
    1710. 

  1710. 		
    1711. 

  1711. 		/*
    1712. 

  1712. 			*************
    1713. 

  1713. 			if NO SUCCESS
    1714. 

  1714. 			*************
    1715. 

  1715. 			*/
    1716. 

  1716. 		if(strtoupper($this->Response["ACK"]) != "SUCCESS")
    1717. 

  1717. 		{
    1718. 

  1718. 			$this->Error['TIMESTAMP']		= @$this->Response['TIMESTAMP'];
    1719. 

  1719. 			$this->Error['CORRELATIONID']	= @$this->Response['CORRELATIONID'];
    1720. 

  1720. 			$this->Error['ACK']				= $this->Response['ACK'];
    1721. 

  1721. 			$this->Error['ERRORCODE']		= $this->Response['L_ERRORCODE0'];
    1722. 

  1722. 			$this->Error['SHORTMESSAGE']	= $this->Response['L_SHORTMESSAGE0'];
    1723. 

  1723. 			$this->Error['LONGMESSAGE']		= $this->Response['L_LONGMESSAGE0'];
    1724. 

  1724. 			$this->Error['SEVERITYCODE']	= $this->Response['L_SEVERITYCODE0'];
    1725. 

  1725. 			$this->Error['VERSION']			= @$this->Response['VERSION'];
    1726. 

  1726. 			$this->Error['BUILD']			= @$this->Response['BUILD'];
    1727. 

  1727. 			
    1728. 

  1728. 			$this->_error				= true;
    1729. 

  1729. 			$this->_error_ack			= $this->Response['ACK'];
    1730. 

  1730. 			$this->ack					= 'Failure';
    1731. 

  1731. 			$this->_error_type			= 'paypal';
    1732. 

  1732. 			$this->_error_date			= $this->Response['TIMESTAMP'];
    1733. 

  1733. 			$this->_error_code			= $this->Response['L_ERRORCODE0'];
    1734. 

  1734. 			$this->_error_short_message	= $this->Response['L_SHORTMESSAGE0'];
    1735. 

  1735. 			$this->_error_long_message	= $this->Response['L_LONGMESSAGE0'];
    1736. 

  1736. 			$this->_error_severity_code	= $this->Response['L_SEVERITYCODE0'];
    1737. 

  1737. 			$this->_error_version		= @$this->Response['VERSION'];
    1738. 

  1738. 			$this->_error_build			= @$this->Response['BUILD']; 
    1739. 

  1739. 			
    1740. 

  1740. 			return false;
    1741. 

  1741. 		}
    1742. 

  1742. 		/*
    1743. 

  1743. 			*************
    1744. 

  1744. 			if SUCCESS
    1745. 

  1745. 			*************
    1746. 

  1746. 			*/
    1747. 

  1747. 		elseif(strtoupper($this->Response["ACK"]) == 'SUCCESS')
    1748. 

  1748. 		{
    1749. 

  1749. 			/* Take the response variables and put them into the local class variables */
    1750. 

  1750. 			foreach($this->ResponseFieldsArray['RefundTransaction'] as $key => $value)
    1751. 

  1751. 				$this->$key = $this->Response[$value];
    1752. 

  1752. 			
    1753. 

  1753. 			$this->getItems($this->Response);
    1754. 

  1754. 			
    1755. 

  1755. 			return true;
    1756. 

  1756. 		}
    1757. 

  1757. 	}
    1758. 

  1758. 	
    1759. 

  1759. 	
    1760. 

  1760. 	
    1761. 

  1761. 	function create_recurring_payments_profile()
    1762. 

  1762. 	{
    1763. 

  1763. 

  1764. 		$this->urlencodeVariables();
    1765. 

  1765. 

  1766. 		$nvpstr = $this->generateNVPString('CreateRecurringPaymentsProfile');
    1767. 

  1767. 

  1768. 		$this->Response = $this->hash_call("CreateRecurringPaymentsProfile", $nvpstr);
    1769. 

  1769. 

  1770. 		$this->urldecodeVariables();
    1771. 

  1771. 

  1772. 		if(strtoupper($this->Response["ACK"]) != "SUCCESS")
    1773. 

  1773. 		{
    1774. 

  1774. 			$this->Error['TIMESTAMP']		= @$this->Response['TIMESTAMP'];
    1775. 

  1775. 			$this->Error['CORRELATIONID']	= @$this->Response['CORRELATIONID'];
    1776. 

  1776. 			$this->Error['ACK']				= $this->Response['ACK'];
    1777. 

  1777. 			$this->Error['ERRORCODE']		= $this->Response['L_ERRORCODE0'];
    1778. 

  1778. 			$this->Error['SHORTMESSAGE']	= $this->Response['L_SHORTMESSAGE0'];
    1779. 

  1779. 			$this->Error['LONGMESSAGE']		= $this->Response['L_LONGMESSAGE0'];
    1780. 

  1780. 			$this->Error['SEVERITYCODE']	= $this->Response['L_SEVERITYCODE0'];
    1781. 

  1781. 			$this->Error['VERSION']			= @$this->Response['VERSION'];
    1782. 

  1782. 			$this->Error['BUILD']			= @$this->Response['BUILD'];
    1783. 

  1783. 			
    1784. 

  1784. 			$this->_error				= true;
    1785. 

  1785. 			$this->_error_ack			= $this->Response['ACK'];
    1786. 

  1786. 			$this->ack					= 'Failure';
    1787. 

  1787. 			$this->_error_type			= 'paypal';
    1788. 

  1788. 			$this->_error_date			= $this->Response['TIMESTAMP'];
    1789. 

  1789. 			$this->_error_code			= $this->Response['L_ERRORCODE0'];
    1790. 

  1790. 			$this->_error_short_message	= $this->Response['L_SHORTMESSAGE0'];
    1791. 

  1791. 			$this->_error_long_message	= $this->Response['L_LONGMESSAGE0'];
    1792. 

  1792. 			$this->_error_severity_code	= $this->Response['L_SEVERITYCODE0'];
    1793. 

  1793. 			$this->_error_version		= @$this->Response['VERSION'];
    1794. 

  1794. 			$this->_error_build			= @$this->Response['BUILD']; 
    1795. 

  1795. 			
    1796. 

  1796. 			return false;
    1797. 

  1797. 	
    1798. 

  1798. 		}
    1799. 

  1799. 	
    1800. 

  1800. 		elseif(strtoupper($this->Response["ACK"]) == 'SUCCESS')
    1801. 

  1801. 		{
    1802. 

  1802. 			/*
    1803. 

  1803. 			Take the response variables and put them into the local class variables
    1804. 

  1804. 			*/
    1805. 

  1805. 			foreach($this->ResponseFieldsArray['CreateRecurringPaymentsProfile'] as $key => $value)
    1806. 

  1806. 				$this->$key = $this->Response[$value];
    1807. 

  1807. 			
    1808. 

  1808. 			return true;
    1809. 

  1809. 		}
    1810. 

  1810. 	}
    1811. 

  1811. 	
    1812. 

  1812. 	
    1813. 

  1813. 	
    1814. 

  1814. 	function get_recurring_payments_profile_details()
    1815. 

  1815. 	{
    1816. 

  1816. 

  1817. 		$nvpstr = $this->generateNVPString('GetRecurringPaymentsProfileDetails');
    1818. 

  1818. 

  1819. 		$this->Response = $this->hash_call("GetRecurringPaymentsProfileDetails", $nvpstr);
    1820. 

  1820. 

  1821. 		if(strtoupper($this->Response["ACK"]) != "SUCCESS")
    1822. 

  1822. 		{
    1823. 

  1823. 			$this->Error['TIMESTAMP']		= @$this->Response['TIMESTAMP'];
    1824. 

  1824. 			$this->Error['CORRELATIONID']	= @$this->Response['CORRELATIONID'];
    1825. 

  1825. 			$this->Error['ACK']				= $this->Response['ACK'];
    1826. 

  1826. 			$this->Error['ERRORCODE']		= $this->Response['L_ERRORCODE0'];
    1827. 

  1827. 			$this->Error['SHORTMESSAGE']	= $this->Response['L_SHORTMESSAGE0'];
    1828. 

  1828. 			$this->Error['LONGMESSAGE']		= $this->Response['L_LONGMESSAGE0'];
    1829. 

  1829. 			$this->Error['SEVERITYCODE']	= $this->Response['L_SEVERITYCODE0'];
    1830. 

  1830. 			$this->Error['VERSION']			= @$this->Response['VERSION'];
    1831. 

  1831. 			$this->Error['BUILD']			= @$this->Response['BUILD'];
    1832. 

  1832. 			
    1833. 

  1833. 			$this->_error				= true;
    1834. 

  1834. 			$this->_error_ack			= $this->Response['ACK'];
    1835. 

  1835. 			$this->ack					= 'Failure';
    1836. 

  1836. 			$this->_error_type			= 'paypal';
    1837. 

  1837. 			$this->_error_date			= $this->Response['TIMESTAMP'];
    1838. 

  1838. 			$this->_error_code			= $this->Response['L_ERRORCODE0'];
    1839. 

  1839. 			$this->_error_short_message	= $this->Response['L_SHORTMESSAGE0'];
    1840. 

  1840. 			$this->_error_long_message	= $this->Response['L_LONGMESSAGE0'];
    1841. 

  1841. 			$this->_error_severity_code	= $this->Response['L_SEVERITYCODE0'];
    1842. 

  1842. 			$this->_error_version		= @$this->Response['VERSION'];
    1843. 

  1843. 			$this->_error_build			= @$this->Response['BUILD']; 
    1844. 

  1844. 			
    1845. 

  1845. 			return false;
    1846. 

  1846. 

  1847. 		}
    1848. 

  1848. 

  1849. 		elseif(strtoupper($this->Response["ACK"]) == 'SUCCESS')
    1850. 

  1850. 		{
    1851. 

  1851. 

  1852. 			foreach($this->ResponseFieldsArray['GetRecurringPaymentsProfileDetails'] as $key => $value)
    1853. 

  1853. 				$this->$key = $this->Response[$value];
    1854. 

  1854. 			
    1855. 

  1855. 			$this->getItems($this->Response);
    1856. 

  1856. 			
    1857. 

  1857. 			return true;
    1858. 

  1858. 		}
    1859. 

  1859. 	}
    1860. 

  1860. 	
    1861. 

  1861. 	
    1862. 

  1862. 	
    1863. 

  1863. 	function update_recurring_payments_profile()
    1864. 

  1864. 	{
    1865. 

  1865. 		$this->urlencodeVariables();
    1866. 

  1866. 

  1867. 		$nvpstr = $this->generateNVPString('UpdateRecurringPaymentsProfile');
    1868. 

  1868. 

  1869. 		$this->urldecodeVariables();
    1870. 

  1870. 

  1871. 		$this->Response = $this->hash_call("UpdateRecurringPaymentsProfile", $nvpstr);
    1872. 

  1872. 

  1873. 		if(strtoupper($this->Response["ACK"]) != "SUCCESS")
    1874. 

  1874. 		{
    1875. 

  1875. 			$this->Error['TIMESTAMP']		= @$this->Response['TIMESTAMP'];
    1876. 

  1876. 			$this->Error['CORRELATIONID']	= @$this->Response['CORRELATIONID'];
    1877. 

  1877. 			$this->Error['ACK']				= $this->Response['ACK'];
    1878. 

  1878. 			$this->Error['ERRORCODE']		= $this->Response['L_ERRORCODE0'];
    1879. 

  1879. 			$this->Error['SHORTMESSAGE']	= $this->Response['L_SHORTMESSAGE0'];
    1880. 

  1880. 			$this->Error['LONGMESSAGE']		= $this->Response['L_LONGMESSAGE0'];
    1881. 

  1881. 			$this->Error['SEVERITYCODE']	= $this->Response['L_SEVERITYCODE0'];
    1882. 

  1882. 			$this->Error['VERSION']			= @$this->Response['VERSION'];
    1883. 

  1883. 			$this->Error['BUILD']			= @$this->Response['BUILD'];
    1884. 

  1884. 			
    1885. 

  1885. 			$this->_error				= true;
    1886. 

  1886. 			$this->_error_ack			= $this->Response['ACK'];
    1887. 

  1887. 			$this->ack					= 'Failure';
    1888. 

  1888. 			$this->_error_type			= 'paypal';
    1889. 

  1889. 			$this->_error_date			= $this->Response['TIMESTAMP'];
    1890. 

  1890. 			$this->_error_code			= $this->Response['L_ERRORCODE0'];
    1891. 

  1891. 			$this->_error_short_message	= $this->Response['L_SHORTMESSAGE0'];
    1892. 

  1892. 			$this->_error_long_message	= $this->Response['L_LONGMESSAGE0'];
    1893. 

  1893. 			$this->_error_severity_code	= $this->Response['L_SEVERITYCODE0'];
    1894. 

  1894. 			$this->_error_version		= @$this->Response['VERSION'];
    1895. 

  1895. 			$this->_error_build			= @$this->Response['BUILD']; 
    1896. 

  1896. 			
    1897. 

  1897. 			return false;
    1898. 

  1898. 		}
    1899. 

  1899. 		elseif(strtoupper($this->Response["ACK"]) == 'SUCCESS')
    1900. 

  1900. 		{
    1901. 

  1901. 

  1902. 			foreach($this->ResponseFieldsArray['UpdateRecurringPaymentsProfile'] as $key => $value)
    1903. 

  1903. 				$this->$key = $this->Response[$value];
    1904. 

  1904. 			
    1905. 

  1905. 			return true;
    1906. 

  1906. 		}
    1907. 

  1907. 	}
    1908. 

  1908. 	
    1909. 

  1909. 	public function do_reference_transaction()
    1910. 

  1910. 	{
    1911. 

  1911. 		// urlencode the needed variables
    1912. 

  1912. 		$this->urlencodeVariables();
    1913. 

  1913. 		
    1914. 

  1914. 		/* Construct the request string that will be sent to PayPal.
    1915. 

  1915. 		   The variable $nvpstr contains all the variables and is a
    1916. 

  1916. 		   name value pair string with & as a delimiter */
    1917. 

  1917. 		$nvpstr = $this->generateNVPString('DoReferenceTransaction');
    1918. 

  1918. 		
    1919. 

  1919. 		/* Construct and add any items found in this instance */
    1920. 

  1920. 		if(!empty($this->ItemsArray))
    1921. 

  1921. 		{
    1922. 

  1922. 			// Counter for the total of all the items put together
    1923. 

  1923. 			$total_items_amount = 0;
    1924. 

  1924. 			$total_items_tax_amount = 0;
    1925. 

  1925. 			// Go through the items array
    1926. 

  1926. 			foreach($this->ItemsArray as $key => $value)
    1927. 

  1927. 			{
    1928. 

  1928. 				// Get the array of the current item from the main array
    1929. 

  1929. 				$current_item = $this->ItemsArray[$key];
    1930. 

  1930. 				// Add it to the request string
    1931. 

  1931. 				$nvpstr .= "&L_NAME".$key."=".$current_item['name'].
    1932. 

  1932. 							"&L_NUMBER".$key."=".$current_item['number'].
    1933. 

  1933. 							"&L_QTY".$key."=".$current_item['quantity'].
    1934. 

  1934. 							"&L_TAXAMT".$key."=".$current_item['amount_tax'].
    1935. 

  1935. 							"&L_AMT".$key."=".$current_item['amount'];
    1936. 

  1936. 				// Add this item's amount to the total current count
    1937. 

  1937. 				$total_items_amount += ($current_item['amount'] * $current_item['quantity']);
    1938. 

  1938. 				$total_items_tax_amount += ($current_item['amount_tax'] * $current_item['quantity']);
    1939. 

  1939. 			}
    1940. 

  1940. 			// Set the amount_items for this instance and ITEMAMT added to the request string
    1941. 

  1941. 			$this->amount_items = $total_items_amount;
    1942. 

  1942. 			// Add this to our NVP string
    1943. 

  1943. 			$nvpstr .= "&ITEMAMT=".urlencode($total_items_amount);
    1944. 

  1944. 			// If our entire tax amount is not set, we will automatically set it based on the items tax amount
    1945. 

  1945. 			if($this->amount_tax == 0 OR empty($this->amount_tax))
    1946. 

  1946. 				$nvpstr .= "&TAXAMT=".urlencode($total_items_tax_amount);
    1947. 

  1947. 		}
    1948. 

  1948. 		
    1949. 

  1949. 		// decode the variables incase we still require access to them in our program
    1950. 

  1950. 		$this->urldecodeVariables();
    1951. 

  1951. 		
    1952. 

  1952. 		/* Make the API call to PayPal, using API signature.
    1953. 

  1953. 		   The API response is stored in an associative array called $this->Response */
    1954. 

  1954. 		$this->Response = $this->hash_call("DoReferenceTransaction", $nvpstr);
    1955. 

  1955. 		
    1956. 

  1956. 		// TODO: Add error handling for the hash_call
    1957. 

  1957. 		
    1958. 

  1958. 		/*
    1959. 

  1959. 		*************
    1960. 

  1960. 		if NO SUCCESS
    1961. 

  1961. 		*************
    1962. 

  1962. 		*/
    1963. 

  1963. 		if(strtoupper($this->Response["ACK"]) != "SUCCESS" AND strtoupper($this->Response["ACK"]) != "SUCCESSWITHWARNING")
    1964. 

  1964. 		{
    1965. 

  1965. 			$this->Error['TIMESTAMP']		= @$this->Response['TIMESTAMP'];
    1966. 

  1966. 			$this->Error['CORRELATIONID']	= @$this->Response['CORRELATIONID'];
    1967. 

  1967. 			$this->Error['ACK']				= $this->Response['ACK'];
    1968. 

  1968. 			$this->Error['ERRORCODE']		= $this->Response['L_ERRORCODE0'];
    1969. 

  1969. 			$this->Error['SHORTMESSAGE']	= $this->Response['L_SHORTMESSAGE0'];
    1970. 

  1970. 			$this->Error['LONGMESSAGE']		= $this->Response['L_LONGMESSAGE0'];
    1971. 

  1971. 			$this->Error['SEVERITYCODE']	= $this->Response['L_SEVERITYCODE0'];
    1972. 

  1972. 			$this->Error['VERSION']			= @$this->Response['VERSION'];
    1973. 

  1973. 			$this->Error['BUILD']			= @$this->Response['BUILD'];
    1974. 

  1974. 			
    1975. 

  1975. 			// TODO: Error codes for AVSCODE and CVV@MATCH
    1976. 

  1976. 			
    1977. 

  1977. 			$this->_error				= true;
    1978. 

  1978. 			$this->_error_ack			= $this->Response['ACK'];
    1979. 

  1979. 			$this->ack					= 'Failure';
    1980. 

  1980. 			$this->_error_type			= 'paypal';
    1981. 

  1981. 			$this->_error_date			= $this->Response['TIMESTAMP'];
    1982. 

  1982. 			$this->_error_code			= $this->Response['L_ERRORCODE0'];
    1983. 

  1983. 			$this->_error_short_message	= $this->Response['L_SHORTMESSAGE0'];
    1984. 

  1984. 			$this->_error_long_message	= $this->Response['L_LONGMESSAGE0'];
    1985. 

  1985. 			$this->_error_severity_code	= $this->Response['L_SEVERITYCODE0'];
    1986. 

  1986. 			$this->_error_version		= @$this->Response['VERSION'];
    1987. 

  1987. 			$this->_error_build			= @$this->Response['BUILD']; 
    1988. 

  1988. 			
    1989. 

  1989. 			return false;
    1990. 

  1990. 		}
    1991. 

  1991. 		/*
    1992. 

  1992. 		*************
    1993. 

  1993. 		if SUCCESS
    1994. 

  1994. 		*************
    1995. 

  1995. 		*/
    1996. 

  1996. 		elseif(strtoupper($this->Response["ACK"]) == 'SUCCESS' OR strtoupper($this->Response["ACK"]) == 'SUCCESSWITHWARNING')
    1997. 

  1997. 		{
    1998. 

  1998. 			/* Take the response variables and put them into the local class variables */
    1999. 

  1999. 			foreach($this->ResponseFieldsArray['DoReferenceTransaction'] as $key => $value)
    2000. 

  2000. 				$this->$key = $this->Response[$value];
    2001. 

  2001. 			
    2002. 

  2002. 			return true;
    2003. 

  2003. 		}
    2004. 

  2004. 	}
    2005. 

  2005. 	
    2006. 

  2006. 

  2007. 	
    2008. 

  2008. 		
    2009. 

  2009. 	/**
    2010. 

  2010. 	  * hash_call: Function to perform the API call to PayPal using API signature
    2011. 

  2011. 	  * @methodName is name of API  method.
    2012. 

  2012. 	  * @nvpStr is nvp string.
    2013. 

  2013. 	  * returns an associtive array containing the response from the server.
    2014. 

  2014. 	*/
    2015. 

  2015. 	private function hash_call($methodName, $nvpStr)
    2016. 

  2016. 	{
    2017. 

  2017. 		//setting the curl parameters.
    2018. 

  2018. 		$ch = curl_init();
    2019. 

  2019. 		curl_setopt($ch, CURLOPT_URL,$this->API_ENDPOINT);
    2020. 

  2020. 		curl_setopt($ch, CURLOPT_VERBOSE, 1);
    2021. 

  2021. 	
    2022. 

  2022. 		//turning off the server and peer verification(TrustManager Concept).
    2023. 

  2023. 		curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
    2024. 

  2024. 		curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
    2025. 

  2025. 	
    2026. 

  2026. 		curl_setopt($ch, CURLOPT_RETURNTRANSFER,1);
    2027. 

  2027. 		curl_setopt($ch, CURLOPT_POST, 1);
    2028. 

  2028. 		//if USE_PROXY constant set to TRUE in Constants.php, then only proxy will be enabled.
    2029. 

  2029. 	   //Set proxy name to PROXY_HOST and port number to PROXY_PORT in constants.php 
    2030. 

  2030. 		if($this->USE_PROXY)
    2031. 

  2031. 			curl_setopt ($ch, CURLOPT_PROXY, $this->PROXY_HOST.":".$this->PROXY_PORT); 
    2032. 

  2032. 	
    2033. 

  2033. 		//NVPRequest for submitting to server
    2034. 

  2034. 		$nvpreq = "METHOD=".urlencode($methodName)."&VERSION=".urlencode($this->VERSION)."&PWD=".urlencode($this->API_PASSWORD).
    2035. 

  2035. 				"&USER=".urlencode($this->API_USERNAME)."&SIGNATURE=".urlencode($this->API_SIGNATURE).$nvpStr;
    2036. 

  2036. 		
    2037. 

  2037. 		//setting the nvpreq as POST FIELD to curl
    2038. 

  2038. 		curl_setopt($ch,CURLOPT_POSTFIELDS,$nvpreq);
    2039. 

  2039. 	
    2040. 

  2040. 		//getting response from server
    2041. 

  2041. 		$response = curl_exec($ch);
    2042. 

  2042. 	
    2043. 

  2043. 		//convrting NVPResponse to an Associative Array
    2044. 

  2044. 		$nvpResArray = $this->deformatNVP($response);
    2045. 

  2045. 		$nvpReqArray = $this->deformatNVP($nvpreq);
    2046. 

  2046. 		$_SESSION['nvpReqArray'] = $nvpReqArray;
    2047. 

  2047. 		
    2048. 

  2048. 		/*
    2049. 

  2049. 			*************
    2050. 

  2050. 			if NO SUCCESS
    2051. 

  2051. 			*************
    2052. 

  2052. 			*/
    2053. 

  2053. 		if (curl_errno($ch)) 
    2054. 

  2054. 		{
    2055. 

  2055. 			// moving to display page to display curl errors
    2056. 

  2056. 

  2057. 			$_SESSION['curl_error_no'] = curl_errno($ch) ;
    2058. 

  2058. 			$_SESSION['curl_error_msg'] = curl_error($ch);
    2059. 

  2059. 			
    2060. 

  2060. 			$this->_error				= true;
    2061. 

  2061. 			$this->ack					= 'Failure';
    2062. 

  2062. 			$this->_error_type			= 'curl';
    2063. 

  2063. 			$this->_error_date			= date("Y-m-d H:i:s");
    2064. 

  2064. 			$this->_error_code			= curl_errno($ch);
    2065. 

  2065. 			$this->_error_short_message	= 'There was an error trying to contact the PayPal servers. (curl error) See long message for details.';
    2066. 

  2066. 			$this->_error_long_message	= curl_error($ch);
    2067. 

  2067. 			
    2068. 

  2068. 			return false;
    2069. 

  2069. 		} 
    2070. 

  2070. 		/*
    2071. 

  2071. 			*************
    2072. 

  2072. 			if SUCCESS
    2073. 

  2073. 			*************
    2074. 

  2074. 			*/
    2075. 

  2075. 		else 
    2076. 

  2076. 		{
    2077. 

  2077. 			//closing the curl
    2078. 

  2078. 			curl_close($ch);
    2079. 

  2079. 		}
    2080. 

  2080. 		
    2081. 

  2081. 		return $nvpResArray;
    2082. 

  2082. 	}
    2083. 

  2083. 		
    2084. 

  2084. 		
    2085. 

  2085. 		
    2086. 

  2086. 	/** This function will take NVPString and convert it to an Associative Array and it will decode the response.
    2087. 

  2087. 	  * It is usefull to search for a particular key and displaying arrays.
    2088. 

  2088. 	  * @nvpstr is NVPString.
    2089. 

  2089. 	  * @nvpArray is an Associative Array.
    2090. 

  2090. 	  */
    2091. 

  2091. 	private function deformatNVP($nvpstr)
    2092. 

  2092. 	{
    2093. 

  2093. 		$intial=0;
    2094. 

  2094. 		$nvpArray = array();
    2095. 

  2095. 		
    2096. 

  2096. 		while(strlen($nvpstr))
    2097. 

  2097. 		{
    2098. 

  2098. 			//postion of Key
    2099. 

  2099. 			$keypos= strpos($nvpstr,'=');
    2100. 

  2100. 			//position of value
    2101. 

  2101. 			$valuepos = strpos($nvpstr,'&') ? strpos($nvpstr,'&'): strlen($nvpstr);
    2102. 

  2102. 	
    2103. 

  2103. 			/*getting the Key and Value values and storing in a Associative Array*/
    2104. 

  2104. 			$keyval=substr($nvpstr,$intial,$keypos);
    2105. 

  2105. 			$valval=substr($nvpstr,$keypos+1,$valuepos-$keypos-1);
    2106. 

  2106. 			//decoding the respose
    2107. 

  2107. 			$nvpArray[urldecode($keyval)] =urldecode( $valval);
    2108. 

  2108. 			$nvpstr=substr($nvpstr,$valuepos+1,strlen($nvpstr));
    2109. 

  2109. 		}
    2110. 

  2110. 			
    2111. 

  2111. 		return $nvpArray;
    2112. 

  2112. 	}
    2113. 

  2113. 		
    2114. 

  2114. 		
    2115. 

  2115. 		
    2116. 

  2116. 		
    2117. 

  2117. 	/* This function will add an item to the itemArray for use in doDirectPayment and doExpressCheckoutPayment */
    2118. 

  2118. 	public function addItem($name, $number, $quantity, $amount_tax, $amount)
    2119. 

  2119. 	{
    2120. 

  2120. 		$new_item =  array(
    2121. 

  2121. 				'name' => $name, 
    2122. 

  2122. 				'number' => $number, 
    2123. 

  2123. 				'quantity' => $quantity, 
    2124. 

  2124. 				'amount_tax' => $amount_tax, 
    2125. 

  2125. 				'amount' => $amount);
    2126. 

  2126. 		
    2127. 

  2127. 		$this->ItemsArray[] = $new_item;
    2128. 

  2128. 		
    2129. 

  2129. 		// TODO: Should recalculate and set $this->amount_items after every new item is added. Or is this done on each request?
    2130. 

  2130. 	}
    2131. 

  2131. 	
    2132. 

  2132. 	
    2133. 

  2133. 	
    2134. 

  2134. 	private function getItems($passed_response)
    2135. 

  2135. 	{
    2136. 

  2136. 		// Clear any current items
    2137. 

  2137. 		$this->ItemsArray = '';
    2138. 

  2138. 		
    2139. 

  2139. 		// Get the items if there are any
    2140. 

  2140. 		// Start this off by checking for a first item
    2141. 

  2141. 		if(!empty($passed_response['L_NAME0']) OR !empty($passed_response['L_NUMBER0']) OR !empty($passed_response['L_QTY0']))
    2142. 

  2142. 		{
    2143. 

  2143. 			$i = 0;
    2144. 

  2144. 			// Start a loop to get all the items (up to 200)
    2145. 

  2145. 			// We'll break out of it if we stop finding items
    2146. 

  2146. 			while($i < 200)
    2147. 

  2147. 			{
    2148. 

  2148. 				// One of the Name, Number, and Qty fields may be empty, so check all of them
    2149. 

  2149. 				//   and if any of them are filled, then we have an item
    2150. 

  2150. 				if(!empty($passed_response['L_NAME'.$i]) OR !empty($passed_response['L_NUMBER'.$i]) OR !empty($passed_response['L_QTY'.$i]))
    2151. 

  2151. 				{
    2152. 

  2152. 					$new_item =  array(
    2153. 

  2153. 							'name' => $passed_response['L_NAME'.$i], 
    2154. 

  2154. 							'number' => $passed_response['L_NUMBER'.$i], 
    2155. 

  2155. 							'quantity' => $passed_response['L_QTY'.$i], 
    2156. 

  2156. 							'amount_tax' => $passed_response['L_TAXAMT'.$i], 
    2157. 

  2157. 							'amount' => $passed_response['L_AMT'.$i]);
    2158. 

  2158. 					
    2159. 

  2159. 					$this->ItemsArray[] = $new_item;
    2160. 

  2160. 					$i++;
    2161. 

  2161. 				}
    2162. 

  2162. 				else
    2163. 

  2163. 					break;
    2164. 

  2164. 			} // end while
    2165. 

  2165. 		} // end if
    2166. 

  2166. 	} // end function
    2167. 

  2167. 	
    2168. 

  2168. 	
    2169. 

  2169. 	
    2170. 

  2170. 	private function generateNVPString($type)
    2171. 

  2171. 	{
    2172. 

  2172. 		$temp_nvp_str = '';
    2173. 

  2173. 		// Go through the selected RequestFieldsArray and create the request string based on whether the field is required or filled
    2174. 

  2174. 		// TODO: return error if required field is empty?
    2175. 

  2175. 		foreach($this->RequestFieldsArray[$type] as $key => $value)
    2176. 

  2176. 		{
    2177. 

  2177. 			if($value['required'] == 'yes')
    2178. 

  2178. 				$temp_nvp_str .= '&'.$value['name'].'='.$this->$key;
    2179. 

  2179. 			elseif(!empty($this->$key))
    2180. 

  2180. 				$temp_nvp_str .= '&'.$value['name'].'='.$this->$key;
    2181. 

  2181. 		}
    2182. 

  2182. 		return $temp_nvp_str;
    2183. 

  2183. 	}
    2184. 

  2184. 	
    2185. 

  2185. 	
    2186. 

  2186. 	
    2187. 

  2187. 	/* This function encodes all applicable variables for transport to PayPal */
    2188. 

  2188. 	private function urlencodeVariables()
    2189. 

  2189. 	{
    2190. 

  2190. 		// Decode all specified variables
    2191. 

  2191. 		$this->payment_type			= urlencode($this->payment_type);
    2192. 

  2192. 		
    2193. 

  2193. 		$this->email				= urlencode($this->email);
    2194. 

  2194. 		$this->first_name			= urlencode($this->first_name);
    2195. 

  2195. 		$this->last_name			= urlencode($this->last_name);
    2196. 

  2196. 		$this->credit_card_type		= urlencode($this->credit_card_type);
    2197. 

  2197. 		$this->credit_card_number	= urlencode($this->credit_card_number);
    2198. 

  2198. 		
    2199. 

  2199. 		// Month must be padded with leading zero
    2200. 

  2200. 		$this->expire_date			= urlencode(str_pad($this->expire_date, 6, '0', STR_PAD_LEFT));
    2201. 

  2201. 		
    2202. 

  2202. 		$this->cvv2_code		= urlencode($this->cvv2_code);
    2203. 

  2203. 		$this->address1			= urlencode($this->address1);
    2204. 

  2204. 		$this->address2			= urlencode($this->address2);
    2205. 

  2205. 		$this->city				= urlencode($this->city);
    2206. 

  2206. 		$this->state			= urlencode($this->state);
    2207. 

  2207. 		$this->postal_code		= urlencode($this->postal_code);
    2208. 

  2208. 		$this->country_code		= urlencode($this->country_code);
    2209. 

  2209. 		
    2210. 

  2210. 		$this->currency_code	= urlencode($this->currency_code);
    2211. 

  2211. 		$this->ip_address		= urlencode($this->ip_address);
    2212. 

  2212. 		
    2213. 

  2213. 		$this->shipping_name			= urlencode($this->shipping_name);
    2214. 

  2214. 		$this->shipping_address1		= urlencode($this->shipping_address1);
    2215. 

  2215. 		$this->shipping_address2		= urlencode($this->shipping_address2);
    2216. 

  2216. 		$this->shipping_city			= urlencode($this->shipping_city);
    2217. 

  2217. 		$this->shipping_state			= urlencode($this->shipping_state);
    2218. 

  2218. 		$this->shipping_postal_code		= urlencode($this->shipping_postal_code);
    2219. 

  2219. 		$this->shipping_country_code	= urlencode($this->shipping_country_code);
    2220. 

  2220. 		$this->shipping_phone_number	= urlencode($this->shipping_phone_number);
    2221. 

  2221. 		
    2222. 

  2222. 		$this->amount_total		= urlencode($this->amount_total);
    2223. 

  2223. 		$this->amount_shipping	= urlencode($this->amount_shipping);
    2224. 

  2224. 		$this->amount_tax		= urlencode($this->amount_tax);
    2225. 

  2225. 		$this->amount_handling	= urlencode($this->amount_handling);
    2226. 

  2226. 		$this->amount_items		= urlencode($this->amount_items);
    2227. 

  2227. 		
    2228. 

  2228. 		$this->token		= urlencode($this->token);
    2229. 

  2229. 		$this->payer_id		= urlencode($this->payer_id);
    2230. 

  2230. 		
    2231. 

  2231. 

  2232. 		if(!empty($this->ItemsArray))
    2233. 

  2233. 		{
    2234. 

  2234. 			// Go through the items array
    2235. 

  2235. 			foreach($this->ItemsArray as $key => $value)
    2236. 

  2236. 			{
    2237. 

  2237. 				// Get the array of the current item from the main array
    2238. 

  2238. 				$current_item = $this->ItemsArray[$key];
    2239. 

  2239. 				// Encode everything
    2240. 

  2240. 				// TODO: use a foreach loop instead
    2241. 

  2241. 				$current_item['name'] = urlencode($current_item['name']);
    2242. 

  2242. 				$current_item['number'] = urlencode($current_item['number']);
    2243. 

  2243. 				$current_item['quantity'] = urlencode($current_item['quantity']);
    2244. 

  2244. 				$current_item['amount_tax'] = urlencode($current_item['amount_tax']);
    2245. 

  2245. 				$current_item['amount'] = urlencode($current_item['amount']);
    2246. 

  2246. 				// Put the encoded array back in the item array (replaces previous array)
    2247. 

  2247. 				$this->ItemsArray[$key] = $current_item;
    2248. 

  2248. 			}
    2249. 

  2249. 		}
    2250. 

  2250. 	}
    2251. 

  2251. 	
    2252. 

  2252. 	/* This function Decodes all applicable variables for use in application/database */
    2253. 

  2253. 	private function urldecodeVariables()
    2254. 

  2254. 	{
    2255. 

  2255. 		// Decode all specified variables
    2256. 

  2256. 		$this->payment_type			= urldecode($this->payment_type);
    2257. 

  2257. 		
    2258. 

  2258. 		$this->email				= urldecode($this->email);
    2259. 

  2259. 		$this->first_name			= urldecode($this->first_name);
    2260. 

  2260. 		$this->last_name			= urldecode($this->last_name);
    2261. 

  2261. 		$this->credit_card_type		= urldecode($this->credit_card_type);
    2262. 

  2262. 		$this->credit_card_number	= urldecode($this->credit_card_number);
    2263. 

  2263. 		
    2264. 

  2264. 		// Month must be padded with leading zero
    2265. 

  2265. 		$this->expire_date			= urldecode(str_pad($this->expire_date, 6, '0', STR_PAD_LEFT));
    2266. 

  2266. 		
    2267. 

  2267. 		$this->cvv2_code		= urldecode($this->cvv2_code);
    2268. 

  2268. 		$this->address1			= urldecode($this->address1);
    2269. 

  2269. 		$this->address2			= urldecode($this->address2);
    2270. 

  2270. 		$this->city				= urldecode($this->city);
    2271. 

  2271. 		$this->state			= urldecode($this->state);
    2272. 

  2272. 		$this->postal_code		= urldecode($this->postal_code);
    2273. 

  2273. 		$this->country_code		= urldecode($this->country_code);
    2274. 

  2274. 		
    2275. 

  2275. 		$this->currency_code	= urldecode($this->currency_code);
    2276. 

  2276. 		$this->ip_address		= urldecode($this->ip_address);
    2277. 

  2277. 		
    2278. 

  2278. 		$this->shipping_name				= urldecode($this->shipping_name);
    2279. 

  2279. 		$this->shipping_address1			= urldecode($this->shipping_address1);
    2280. 

  2280. 		$this->shipping_address2			= urldecode($this->shipping_address2);
    2281. 

  2281. 		$this->shipping_city				= urldecode($this->shipping_city);
    2282. 

  2282. 		$this->shipping_state				= urldecode($this->shipping_state);
    2283. 

  2283. 		$this->shipping_postal_code			= urldecode($this->shipping_postal_code);
    2284. 

  2284. 		$this->shipping_country_code		= urldecode($this->shipping_country_code);
    2285. 

  2285. 		$this->shipping_phone_number		= urldecode($this->shipping_phone_number);
    2286. 

  2286. 		
    2287. 

  2287. 		$this->amount_total		= urldecode($this->amount_total);
    2288. 

  2288. 		$this->amount_shipping	= urldecode($this->amount_shipping);
    2289. 

  2289. 		$this->amount_tax		= urldecode($this->amount_tax);
    2290. 

  2290. 		$this->amount_handling	= urldecode($this->amount_handling);
    2291. 

  2291. 		$this->amount_items		= urldecode($this->amount_items);
    2292. 

  2292. 		
    2293. 

  2293. 		$this->token		= urldecode($this->token);
    2294. 

  2294. 		$this->payer_id		= urldecode($this->payer_id);
    2295. 

  2295. 		
    2296. 

  2296. 		
    2297. 

  2297. 		if(!empty($this->ItemsArray))
    2298. 

  2298. 		{
    2299. 

  2299. 			// Go through the items array
    2300. 

  2300. 			foreach($this->ItemsArray as $key => $value)
    2301. 

  2301. 			{
    2302. 

  2302. 				// Get the array of the current item from the main array
    2303. 

  2303. 				$current_item = $this->ItemsArray[$key];
    2304. 

  2304. 				// Decode everything
    2305. 

  2305. 				// TODO: use a foreach loop instead
    2306. 

  2306. 				$current_item['name'] = urldecode($current_item['name']);
    2307. 

  2307. 				$current_item['number'] = urldecode($current_item['number']);
    2308. 

  2308. 				$current_item['quantity'] = urldecode($current_item['quantity']);
    2309. 

  2309. 				$current_item['amount_tax'] = urldecode($current_item['amount_tax']);
    2310. 

  2310. 				$current_item['amount'] = urldecode($current_item['amount']);
    2311. 

  2311. 				// Put the decoded array back in the item array (replaces previous array)
    2312. 

  2312. 				$this->ItemsArray[$key] = $current_item;
    2313. 

  2313. 			}
    2314. 

  2314. 		}
    2315. 

  2315. 	}
    2316. 

  2316. 

  2317. 

  2318. }  // END CLASS
    2319. 

  2319. 

  2320.