Open whatafunc opened 6 years ago
Mark-H
commented
6 years ago Note from https://github.com/modmore/SimpleCart_PayPal/issues/3#issuecomment-375499876
You'll probably need to add it to both the authorization request (before the redirect) and the checkout call in the verify method for it to work.
whatafunc
commented
6 years ago Hi Mark,
can you please revise if that's added
/ core / components / simplecart_paypal / lib / paypal.class.php
`<?php
/* Created by Drew Johnston, 2007, drewjoh.com
Please give credit where credit is due. :)
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Initial code for Get, Create and Update Recurring Payment Profiles methods available thanks to Bill Joslin (billjoslin.com).*/
class phpPayPal {
private $sandbox = true;
private $live = false;
private $API_ENDPOINT = null;
private $PAYPAL_URL = null;
public $API_USERNAME = null;
public $API_PASSWORD = null;
public $API_SIGNATURE = null;
public $USE_PROXY = null;
public $PROXY_HOST = null;
public $PROXY_PORT = null;
public $return_url = null;
public $cancel_url = null;
public $VERSION = '53.0';
// ----------------------------
// PUBLIC VARIABLES
// ----------------------------
// Array of the response variables from PayPal requests
public $Response;
/* -------------------
ERROR VARIABLES
-------------------
- $Error = an array of PayPal's response to any paypal errors
- All $_error's = are filled for any error that occurs, including PayPal errors
- If a method returns false, the $_error's should be filled with error information
*/
// Array of the error response from PayPal - [TIMESTAMP] [CORRELATIONID] [ACK] [L_ERRORCODE0] [L_SHORTMESSAGE0] [L_LONGMESSAGE0] [L_SEVERITYCODE0] [VERSION] [BUILD]
public $Error;
public $_error = false;
public $_error_ack;
public $_error_type;
public $_error_date;
public $_error_code;
public $_error_short_message;
public $_error_long_message;
public $_error_corrective_action;
public $_error_severity_code;
public $_error_version;
public $_error_build;
public $_error_display_message;
/* ----------------------
REQUEST VARIABLES
----------------------
- All values found in a Request
- Format is $our_variable_name; // PAYPALS_VARIABLE_NAME
*/
public $payment_type = 'Sale'; // PAYMENTTYPE
public $email; // EMAIL
public $salutation; // SALUTATION
public $first_name; // FIRSTNAME
public $middle_name; // MIDDLENAME
public $last_name; // LASTNAME
public $suffix; // SUFFIX
public $credit_card_type; // CREDITCARDTYPE --- Visa, MasterCard, Discover, Amex, Switch, Solo
public $credit_card_number; // ACCT
public $expire_date; // EXPDATE - MMYYYY
public $cvv2_code; // CVV2
public $address1; // STREET
public $address2; // STREET2
public $city; // CITY
public $state; // STATE
public $postal_code; // ZIP
public $phone_number; // PHONENUM
public $country_code; // COUNTRYCODE
public $currency_code = "USD"; // CURRENCYCODE
public $ip_address; //IPADDRESS
public $amount_total; // AMT
public $amount_shipping; // SHIPPINGAMT
public $amount_handling; // HANDLINGAMT
public $amount_tax; // TAXAMT
public $amount_sales_tax; // SALESTAX - This is apparently only used with getTransactionDetails, and appears to be the same as amount_tax
public $amount_items; // ITEMAMT
public $amount_max; // MAXAMT
public $amount_fee; // FEEAMT
public $amount_settle; // SETTLEAMT
public $amount_refund_net; // NETREFUNDAMT
public $amount_refund_fee; // FEEREFUNDAMT
public $amount_refund_total; // GROSSREFUNDAMT
public $billing_type;
public $billing_agreement;
public $shipping_name; // SHIPTONAME
public $shipping_address1; // SHIPTOSTREET
public $shipping_address2; // SHIPTOSTREET2
public $shipping_city; // SHIPTOCITY
public $shipping_state; // SHIPTOSTATE
public $shipping_postal_code; // SHIPTOZIP
public $shipping_country_code; // SHIPTOCOUNTRYCODE
public $shipping_country_name;
public $shipping_phone_number; // SHIPTOPHONENUM
public $description; // DESC
public $custom; // CUSTOM
public $invoice_number; // INVNUM
public $note; // NOTE
public $notify_url; // NOTIFYURL
public $require_confirmed_shipping_address; // REQCONFIRMSHIPPING
public $no_shipping; // NOSHIPPING
public $address_override; // ADDROVERRIDE
public $local_code; // LOCALECODE
public $page_style; // PAGESTYLE
public $hdr_image; // HDRIMG
public $hdr_border_color; //HDRBORDERCOLOR
public $hdr_back_color; // HDRBACKCOLOR
public $payflow_color; // PAYFLOWCOLOR
public $channel_type; // CHANNELTYPE
public $solution_type; // SOLUTIONTYPE
public $user_action; // USERACTION
public $return_fmf_details = 0; // RETURNFMFDETAILS - 0 by default
// Variables found in Authorize and Capture
public $authorization_id; // AUTHORIZATIONID
public $complete_type; // COMPLETETYPE
public $soft_descriptor; // SOFTDESCRIPTOR
public $transaction_entity; // TRANSACTIONENTITY
// Recurring Payments
public $profile_start_date;
public $billing_period;
public $billing_frequency;
public $billing_amount;
// Variables that are returned to us
public $ack;
public $token; // TOKEN
public $payer_id; // PAYERID
public $payer_status; // PAYERSTATUS
public $payer_business; // PAYERBUSINESS
public $address_owner; // ADDRESSOWNER
public $address_status; // ADDRESSSTATUS
public $address_id;
public $business; // BUSINESS
public $avs_code;
public $cvv2_match;
public $transaction_id; // TRANSACTIONID
public $parent_transaction_id; // PARENTTRANSACTIONID
public $refund_transaction_id; // REFUNDTRANSACTIONID
public $transaction_type; // TRANSACTIONTYPE
public $payment_status; // PAYMENTSTATUS
public $payment_pending_reason; // PENDINGREASON
public $payment_reason_code; // REASONCODE
public $order_time; // ORDERTIME
public $timestamp;
public $exchange_rate; // EXCHANGERATE
public $receipt_id; // RECEIPTID
public $receiver_business; // RECEIVERBUSINESS
public $receiver_email; // RECEIVEREMAIL
public $receiver_id; // RECEIVERID
public $subscription_id; // SUBSCRIPTIONID
public $subscription_date; // SUBSCRIPTIONDATE
public $effective_date; // EFFECTIVEDATE
public $retry_time; // RETRYTIME
public $user_name; // USERNAME
public $password; // PASSWORD
public $recurrences; // RECURRENCES
public $reattempt; // REATTEMPT
public $recurring; // RECURRING
public $period; // PERIOD
public $buyer_id; // BUYERID
public $closing_date; // CLOSINGDATE
public $multi_item; // MULTIITEM
public $refund_type; // REFUNDTYPE
// Other
public $build;
public $version;
public $correlation_id;
/*
This is the Items array, contains KEY => VALUE pairs for NAME => VALUE of items where NAME = name of item variable
Names include: name, number, quantity, amount_tax, amount_total
*/
public $ItemsArray;
/* -----------------------
COUNTRY NAMES & CODES
-----------------------
- This is an array of country names and their country codes
- Organized in CODE => NAME format ($countries[COUNTRY_CODE] = COUNTRY_NAME)
- This is purely for informational purposes, the class itself doesn't use these.
- PayPal does use the country CODES when sending address information; can come in very handy then.
- List should include all countries that PayPal accepts payments from.
*/
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");
/* --------------------
STATES
--------------------
- States for certain countries, many of these are required formats for PayPal
- Multidimensional array
- $states[COUNTRY_CODE][STATE_CODE] = STATE_NAME
*/
public $states = array(
'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",
"IA"=>"IA","ID"=>"ID","IL"=>"IL","IN"=>"IN","KS"=>"KS","KY"=>"KY","LA"=>"LA","MA"=>"MA","MD"=>"MD","ME"=>"ME","MI"=>"MI","MN"=>"MN",
"MO"=>"MO","MS"=>"MS","MT"=>"MT","NC"=>"NC","ND"=>"ND","NE"=>"NE","NH"=>"NH","NJ"=>"NJ","NM"=>"NM","NV"=>"NV","NY"=>"NY","OH"=>"OH",
"OK"=>"OK","OR"=>"OR","PA"=>"PA","RI"=>"RI","SC"=>"SC","SD"=>"SD","TN"=>"TN","TX"=>"TX","UT"=>"UT","VA"=>"VA","VT"=>"VT","WA"=>"WA",
"WI"=>"WI","WV"=>"WV","WY"=>"WY","AA"=>"AA","AE"=>"AE","AP"=>"AP","AS"=>"AS","FM"=>"FM","GU"=>"GU","MH"=>"MH","MP"=>"MP","PR"=>"PR",
"PW"=>"PW","VI"=>"VI")
,
'CA' => array ("AB"=>"Alberta", "BC"=>"British Columbia", "MB"=>"Manitoba", "NB"=>"New Brunswick", "NL"=>"Newfoundland", "NS"=>"Nova Scotia",
"NU"=>"Nunavut", "NT"=>"Northwest Territories", "ON"=>"Ontario", "PE"=>"Prince Edward Island", "QC"=>"Quebec", "SK"=>"Saskatchewan",
"YT"=>"Yukon")
,
'AU' => array ("Australian Capital Territory"=>"Australian Capital Territory","New South Wales"=>"New South Wales","Northern Territory"=>"Northern Territory",
"Queensland"=>"Queensland","South Australia"=>"South Australia","Tasmania"=>"Tasmania","Victoria"=>"Victoria","Western Australia"=>"Western Australia")
,
'GB' => array ("Aberdeen City"=>"Aberdeen City","Aberdeenshire"=>"Aberdeenshire","Angus"=>"Angus","Antrim"=>"Antrim","Argyll and Bute"=>"Argyll and Bute",
"Armagh"=>"Armagh","Avon"=>"Avon","Bedfordshire"=>"Bedfordshire","Berkshire"=>"Berkshire","Blaenau Gwent"=>"Blaenau Gwent","Borders"=>"Borders",
"Bridgend"=>"Bridgend","Bristol"=>"Bristol","Buckinghamshire"=>"Buckinghamshire","Caerphilly"=>"Caerphilly","Cambridgeshire"=>"Cambridgeshire",
"Cardiff"=>"Cardiff","Carmarthenshire"=>"Carmarthenshire","Ceredigion"=>"Ceredigion","Channel Islands"=>"Channel Islands","Cheshire"=>"Cheshire",
"Clackmannan"=>"Clackmannan","Cleveland"=>"Cleveland","Conwy"=>"Conwy","Cornwall"=>"Cornwall","Cumbria"=>"Cumbria","Denbighshire"=>"Denbighshire",
"Derbyshire"=>"Derbyshire","Devon"=>"Devon","Dorset"=>"Dorset","Down"=>"Down","Dumfries and Galloway"=>"Dumfries and Galloway","Durham"=>"Durham",
"East Ayrshire"=>"East Ayrshire","East Dunbartonshire"=>"East Dunbartonshire","East Lothian"=>"East Lothian","East Renfrewshire"=>"East Renfrewshire",
"East Riding of Yorkshire"=>"East Riding of Yorkshire","East Sussex"=>"East Sussex","Edinburgh City"=>"Edinburgh City","Essex"=>"Essex",
"Falkirk"=>"Falkirk","Fermanagh"=>"Fermanagh","Fife"=>"Fife","Flintshire"=>"Flintshire","Glasgow"=>"Glasgow","Gloucestershire"=>"Gloucestershire",
"Greater Manchester"=>"Greater Manchester","Gwynedd"=>"Gwynedd","Hampshire"=>"Hampshire","Herefordshire"=>"Herefordshire",
"Hertfordshire"=>"Hertfordshire","Highland"=>"Highland","Humberside"=>"Humberside","Inverclyde"=>"Inverclyde","Isle of Anglesey"=>"Isle of Anglesey",
"Isle of Man"=>"Isle of Man","Isle of Wight"=>"Isle of Wight","Isles of Scilly"=>"Isles of Scilly","Kent"=>"Kent","Lancashire"=>"Lancashire",
"Leicestershire"=>"Leicestershire","Lincolnshire"=>"Lincolnshire","London"=>"London","Londonderry"=>"Londonderry","Merseyside"=>"Merseyside",
"Merthyr Tydfil"=>"Merthyr Tydfil","Middlesex"=>"Middlesex","Midlothian"=>"Midlothian","Monmouthshire"=>"Monmouthshire","Moray"=>"Moray",
"Neath Port Talbot"=>"Neath Port Talbot","Newport"=>"Newport","Norfolk"=>"Norfolk","North Ayrshire"=>"North Ayrshire",
"North Lanarkshire"=>"North Lanarkshire","North Yorkshire"=>"North Yorkshire","Northamptonshire"=>"Northamptonshire","Northumberland"=>"Northumberland",
"Nottinghamshire"=>"Nottinghamshire","Orkney"=>"Orkney","Oxfordshire"=>"Oxfordshire","Pembrokeshire"=>"Pembrokeshire",
"Perthshire and Kinross"=>"Perthshire and Kinross","Powys"=>"Powys","Renfrewshire"=>"Renfrewshire","Rhondda Cynon Taff"=>"Rhondda Cynon Taff",
"Rutland"=>"Rutland","Shetland"=>"Shetland","Shropshire"=>"Shropshire","Somerset"=>"Somerset","South Ayrshire"=>"South Ayrshire",
"South Lanarkshire"=>"South Lanarkshire","South Yorkshire"=>"South Yorkshire","Staffordshire"=>"Staffordshire","Stirling"=>"Stirling",
"Suffolk"=>"Suffolk","Surrey"=>"Surrey","Swansea"=>"Swansea","The Vale of Glamorgan"=>"The Vale of Glamorgan","Tofaen"=>"Tofaen",
"Tyne and Wear"=>"Tyne and Wear","Tyrone"=>"Tyrone","Warwickshire"=>"Warwickshire","West Dunbartonshire"=>"West Dunbartonshire",
"West Lothian"=>"West Lothian","West Midlands"=>"West Midlands","West Sussex"=>"West Sussex","West Yorkshire"=>"West Yorkshire",
"Western Isles"=>"Western Isles","Wiltshire"=>"Wiltshire","Worcestershire"=>"Worcestershire","Wrexham"=>"Wrexham")
,
'ES' => array ("Alava" => "Alava", "Albacete" => "Albacete", "Alicante" => "Alicante", "Almeria" => "Almeria", "Asturias" => "Asturias",
"Avila" => "Avila", "Badajoz" => "Badajoz", "Barcelona" => "Barcelona", "Burgos" => "Burgos", "Caceres" => "Caceres",
"Cadiz" => "Cadiz", "Cantabria" => "Cantabria", "Castellon" => "Castellon", "Ceuta" => "Ceuta", "Ciudad Real" => "Ciudad Real",
"Cordoba" => "Cordoba", "Cuenca" => "Cuenca", "Guadalajara" => "Guadalajara", "Gerona" => "Gerona", "Granada" => "Granada",
"Guipuzcoa" => "Guipuzcoa", "Huelva" => "Huelva", "Huesca" => "Huesca", "Islas Baleares" => "Islas Baleares", "Jaen" => "Jaen",
"La Coruna" => "La Coruna", "Las Palmas" => "Las Palmas", "La Rioja" => "La Rioja", "Leon" => "Leon", "Lerida" => "Lerida",
"Lugo" => "Lugo", "Madrid" => "Madrid", "Malaga" => "Malaga", "Melilla" => "Melilla", "Murcia" => "Murcia", "Navarra" => "Navarra",
"Orense" => "Orense", "Palencia" => "Palencia", "Pontevedra" => "Pontevedra", "Salamanca" => "Salamanca",
"Santa Cruz de Tenerife" => "Santa Cruz de Tenerife", "Segovia" => "Segovia", "Sevilla" => "Sevilla", "Soria" => "Soria",
"Tarragona" => "Tarragona", "Teruel" => "Teruel", "Toledo" => "Toledo", "Valencia" => "Valencia", "Valladolid" => "Valladolid",
"Vizcaya" => "Vizcaya", "Zamora" => "Zamora", "Zaragoza" => "Zaragoza")
);
// ----------------------------
// Internal Use Varibles
// ----------------------------
/* -----------------------------------------
AVS Response Code Values and Meanings
-----------------------------------------
- $AvsResponseCodesArray[CODE][MESSAGE]
- $AvsResponseCodesArray[CODE][DETAILS]
*/
public $AvsResponseCodesArray = array (
'A' => array('message' => 'Address', 'details' => 'Address Only (no ZIP)'),
'B' => array('message' => 'International "A"', 'details' => 'Address Only (no ZIP)'),
'C' => array('message' => 'International "N"', 'details' => 'None - The transaction is declined.'),
'D' => array('message' => 'International "X"', 'details' => 'Address and Postal Code'),
'E' => array('message' => 'Not Allowed for MOTO (Internet/Phone) transactions', 'details' => 'Not applicable - The transaction is declined.'),
'F' => array('message' => 'UK-Specific "X"', 'details' => 'Address and Postal Code'),
'G' => array('message' => 'Global Unavailable', 'details' => 'Not applicable'),
'I' => array('message' => 'International Unavailable', 'details' => 'Not applicable'),
'N' => array('message' => 'No', 'details' => 'None - The transaction is declined.'),
'P' => array('message' => 'Postal (International "Z")', 'details' => 'Postal Code only (no Address)'),
'R' => array('message' => 'Retry', 'details' => 'Not Applicable'),
'S' => array('message' => 'Service Not Supported', 'details' => 'Not Applicable'),
'U' => array('message' => 'Unavailable', 'details' => 'Not Applicable'),
'W' => array('message' => 'Whole ZIP', 'details' => 'Nine-digit ZIP code (no Address)'),
'X' => array('message' => 'Exact Match', 'details' => 'Address and nine-digit ZIP code'),
'Y' => array('message' => 'Yes', 'details' => 'Address and five-digit ZIP'),
'Z' => array('message' => 'ZIP', 'details' => 'Five-digit ZIP code (no Address)'),
'' => array('message' => 'Error', 'details' => 'Not Applicable')
);
/* ---------------------------------------
CVV Rsponse Code Values and Meanings
---------------------------------------
- $CvvResponseCodesArray[CODE][MESSAGE]
- $CvvResponseCodesArray[CODE][DETAILS]
*/
public $CvvResponseCodesArray = array (
'M' => array('message' => 'Match', 'details' => 'CVV2'),
'N' => array('message' => 'No Match', 'details' => 'None'),
'P' => array('message' => 'Not Processed', 'details' => 'Not Applicable'),
'S' => array('message' => 'Service not supported', 'details' => 'Not Applicable'),
'U' => array('message' => 'Service not available', 'details' => 'Not Applicable'),
'X' => array('message' => 'No response', 'details' => 'Not Applicable')
);
/* ---------------------------------------
CVV Rsponse Code Values and Meanings for Switch and Solo cards
---------------------------------------
- TODO: ??
*/
/* --------------------------------------------
REQUEST FIELDS ARRAYS
--------------------------------------------
*/
public $RequestFieldsArray = array(
'DoCapture' => array(
'authorization_id' => array('name' =>'AUTHORIZATIONID', 'required' => 'yes'),
'amount' => array('name' =>'AMT', 'required' => 'yes'),
'currency_code' => array('name' =>'CURRENCYCODE', 'required' => 'no'),
'complete_type' => array('name' =>'COMPLETETYPE', 'required' => 'yes'),
'invoice_number' => array('name' =>'INVNUM', 'required' => 'no'),
'note' => array('name' =>'NOTE', 'required' => 'no'),
'soft_descriptor' => array('name' =>'SOFTDESCRIPTOR', 'required' => 'no')
),
'DoAuthorization' => array(
'transaction_id' => array('name' =>'TRANSACTIONID', 'required' => 'yes'),
'amount' => array('name' =>'AMT', 'required' => 'yes'),
'transaction_entity' => array('name' =>'TRANSACTIONENTITY', 'required' => 'no'),
'currency_code' => array('name' =>'CURRENCYCODE', 'required' => 'no')
),
'DoReauthorization' => array(
'authorization_id' => array('name' =>'AUTHORIZATIONID', 'required' => 'yes'),
'amount' => array('name' =>'AMT', 'required' => 'yes')
),
'DoVoid' => array(
'authorization_id' => array('name' =>'AUTHORIZATIONID', 'required' => 'yes'),
'note' => array('name' =>'NOTE', 'required' => 'no')
),
'DoDirectPayment' => array(
'payment_type' => array('name' => 'PAYMENTACTION', 'required' => 'yes'),
'ip_address' => array('name' => 'IPADDRESS', 'required' => 'yes'),
'return_fmf_details' => array('name' => 'RETURNFMFDETAILS', 'required' => 'no'),
'amount_total' => array('name' => 'AMT', 'required' => 'yes'),
'credit_card_type' => array('name' => 'CREDITCARDTYPE', 'required' => 'yes'),
'credit_card_number' => array('name' => 'ACCT', 'required' => 'yes'),
'expire_date' => array('name' => 'EXPDATE', 'required' => 'yes'),
'first_name' => array('name' => 'FIRSTNAME', 'required' => 'yes'),
'last_name' => array('name' => 'LASTNAME', 'required' => 'yes'),
'address1' => array('name' => 'STREET', 'required' => 'no'),
'address2' => array('name' => 'STREET2', 'required' => 'no'),
'city' => array('name' => 'CITY', 'required' => 'no'),
'state' => array('name' => 'STATE', 'required' => 'no'),
'country_code' => array('name' => 'COUNTRYCODE', 'required' => 'no'),
'postal_code' => array('name' => 'ZIP', 'required' => 'no'),
'notify_url' => array('name' => 'NOTIFYURL', 'required' => 'no'),
'currency_code' => array('name' => 'CURRENCYCODE', 'required' => 'no'),
'amount_items' => array('name' => 'ITEMAMT', 'required' => 'no'),
'amount_shipping' => array('name' => 'SHIPPINGAMT', 'required' => 'no'),
'amount_handling' => array('name' => 'HANDLINGAMT', 'required' => 'no'),
'amount_tax' => array('name' => 'TAXAMT', 'required' => 'no'),
'description' => array('name' => 'DESC', 'required' => 'no'),
'custom' => array('name' => 'CUSTOM', 'required' => 'no'),
'invoice_number' => array('name' => 'INVNUM', 'required' => 'no'),
'cvv2_code' => array('name' => 'CVV2', 'required' => 'yes'),
'start_date' => array('name' => 'STARTDATE', 'required' => 'no'), // For Maestro/Solo cards
'issue_number' => array('name' => 'ISSUENUMBER', 'required' => 'no'), // For maestro/Solo Cards
'email' => array('name' => 'EMAIL', 'required' => 'no'),
'phone_number' => array('name' => 'PHONENUM', 'required' => 'no'),
'shipping_name' => array('name' => 'SHIPTONAME', 'required' => 'no'),
'shipping_address1' => array('name' => 'SHIPTOSTREET', 'required' => 'no'),
'shipping_address2' => array('name' => 'SHIPTOSTREET2', 'required' => 'no'),
'shipping_city' => array('name' => 'SHIPTOCITY', 'required' => 'no'),
'shipping_state' => array('name' => 'SHIPTOSTATE', 'required' => 'no'),
'shipping_postal_code' => array('name' => 'SHIPTOZIP', 'required' => 'no'),
'shipping_country_code' => array('name' => 'SHIPTOCOUNTRYCODE', 'required' => 'no'),
'shipping_phone_number' => array('name' => 'SHIPTOPHONENUM', 'required' => 'no')
),
'SetExpressCheckout' => array(
'return_url' => array('name' => 'RETURNURL', 'required' => 'yes'),
'cancel_url' => array('name' => 'CANCELURL', 'required' => 'yes'),
'amount_total' => array('name' => 'AMT', 'required' => 'yes'),
'currency_code' => array('name' => 'CURRENCYCODE', 'required' => 'no'),
'amount_max' => array('name' => 'MAXAMT', 'required' => 'no'),
'payment_type' => array('name' => 'PAYMENTACTION', 'required' => 'no'),
'email' => array('name' => 'EMAIL', 'required' => 'no'),
'description' => array('name' => 'DESC', 'required' => 'no'),
'custom' => array('name' => 'CUSTOM', 'required' => 'no'),
'invoice_number' => array('name' => 'INVNUM', 'required' => 'no'),
'phone_number' => array('name' => 'PHONENUM', 'required' => 'no'),
'shipping_name' => array('name' => 'SHIPTONAME', 'required' => 'no'),
'shipping_address1' => array('name' => 'SHIPTOSTREET', 'required' => 'no'),
'shipping_address2' => array('name' => 'SHIPTOSTREET2', 'required' => 'no'),
'shipping_city' => array('name' => 'SHIPTOCITY', 'required' => 'no'),
'shipping_state' => array('name' => 'SHIPTOSTATE', 'required' => 'no'),
'shipping_postal_code' => array('name' => 'SHIPTOZIP', 'required' => 'no'),
'shipping_country_code' => array('name' => 'SHIPTOCOUNTRYCODE', 'required' => 'no'),
'shipping_phone_number' => array('name' => 'SHIPTOPHONENUM', 'required' => 'no'),
'require_confirmed_shipping_address' => array('name' => 'REQCONFIRMSHIPPING', 'required' => 'no'),
'no_shipping' => array('name' => 'NOSHIPPING', 'required' => 'no'),
'address_override' => array('name' => 'ADDROVERRIDE', 'required' => 'no'),
'token' => array('name' => 'TOKEN', 'required' => 'no'),
'locale_code' => array('name' => 'LOCALECODE', 'required' => 'no'),
'page_style' => array('name' => 'PAGESTYLE', 'required' => 'no'),
'hdr_img' => array('name' => 'HDRIMG', 'required' => 'no'),
'hdr_border_color' => array('name' => 'HDRBORDERCOLOR', 'required' => 'no'),
'hdr_background_color' => array('name' => 'HDRBACKCOLOR', 'required' => 'no'),
'payflow_color' => array('name' => 'PAYFLOWCOLOR', 'required' => 'no'),
'user_action' => array('name' => 'USERACTION', 'required' => 'no'),
'channel_type' => array('name' => 'CHANNELTYPE', 'required' => 'no'),
'solution_type' => array('name' => 'SOLUTIONTYPE', 'required' => 'no') ,
'billing_type' => array('name' => 'L_BILLINGTYPE0', 'required' => 'no'),
'billing_agreement' => array('name' => 'L_BILLINGAGREEMENTDESCRIPTION0', 'required' => 'no')
),
'GetExpressCheckoutDetails' => array(
'token' => array('name' => 'TOKEN', 'required' => 'yes')
),
'DoExpressCheckoutPayment' => array(
'token' => array('name' => 'TOKEN', 'required' => 'yes'),
'payment_type' => array('name' => 'PAYMENTACTION', 'required' => 'yes'),
'payer_id' => array('name' => 'PAYERID', 'required' => 'yes'),
'amount_total' => array('name' => 'AMT', 'required' => 'yes'),
'description' => array('name' => 'DESC', 'required' => 'no'),
'custom' => array('name' => 'CUSTOM', 'required' => 'no'),
'invoice_number' => array('name' => 'INVNUM', 'required' => 'no'),
'notify_url' => array('name' => 'NOTIFYURL', 'required' => 'no'),
'amount_items' => array('name' => 'ITEMAMT', 'required' => 'no'),
'amount_shipping' => array('name' => 'SHIPPINGAMT', 'required' => 'no'),
'amount_handling' => array('name' => 'HANDLINGAMT', 'required' => 'no'),
'amount_tax' => array('name' => 'TAXAMT', 'required' => 'no'),
'currency_code' => array('name' => 'CURRENCYCODE', 'required' => 'no'),
'shipping_name' => array('name' => 'SHIPTONAME', 'required' => 'no'),
'shipping_address1' => array('name' => 'SHIPTOSTREET', 'required' => 'no'),
'shipping_address2' => array('name' => 'SHIPTOSTREET2', 'required' => 'no'),
'shipping_city' => array('name' => 'SHIPTOCITY', 'required' => 'no'),
'shipping_state' => array('name' => 'SHIPTOSTATE', 'required' => 'no'),
'shipping_postal_code' => array('name' => 'SHIPTOZIP', 'required' => 'no'),
'shipping_country_code' => array('name' => 'SHIPTOCOUNTRYCODE', 'required' => 'no'),
'shipping_phone_number' => array('name' => 'SHIPTOPHONENUM', 'required' => 'no')
),
'GetTransactionDetails' => array(
'transaction_id' => array('name' => 'TRANSACTIONID', 'required' => 'yes')
),
'RefundTransaction' => array(
'transaction_id' => array('name' => 'TRANSACTIONID', 'required' => 'yes'),
'refund_type' => array('name' => 'REFUNDTYPE', 'required' => 'yes'),
'amount_total' => array('name' => 'AMT', 'required' => 'no'),
'note' => array('name' => 'NOTE', 'required' => 'no'),
),
'CreateRecurringPaymentsProfile' => array(
'token' => array('name' => 'TOKEN', 'required' => 'no'),
'payer_id' => array('name' => 'PAYERID', 'required' => 'no'),
'email' => array('name' => 'EMAIL', 'required' => 'no'),
'country_code' => array('name' => 'COUNTRYCODE', 'required' => 'no'),
'business' => array('name' => 'BUSINESS', 'required' => 'no'),
'payer_status' => array('name' => 'PAYERSTATUS', 'required' => 'no'),
'subscriber_name' => array('name' => 'SUBSCRIBERNAME', 'required' => 'no'),
'profile_reference' => array('name' => 'PROFILEREFERENCE', 'required' => 'no'),
'credit_card_type' => array('name' => 'CREDITCARDTYPE', 'required' => 'yes'),
'credit_card_number' => array('name' => 'ACCT', 'required' => 'yes'),
'expire_date' => array('name' => 'EXPDATE', 'required' => 'yes'),
'first_name' => array('name' => 'FIRSTNAME', 'required' => 'yes'),
'last_name' => array('name' => 'LASTNAME', 'required' => 'yes'),
'address1' => array('name' => 'STREET', 'required' => 'no'),
'address2' => array('name' => 'STREET2', 'required' => 'no'),
'city' => array('name' => 'CITY', 'required' => 'no'),
'state' => array('name' => 'STATE', 'required' => 'no'),
'country_code' => array('name' => 'COUNTRYCODE', 'required' => 'no'),
'postal_code' => array('name' => 'ZIP', 'required' => 'no'),
'shipping_name' => array('name' => 'SHIPTONAME', 'required' => 'no'),
'shipping_address1' => array('name' => 'SHIPTOSTREET', 'required' => 'no'),
'shipping_address2' => array('name' => 'SHIPTOSTREET2', 'required' => 'no'),
'shipping_city' => array('name' => 'SHIPTOCITY', 'required' => 'no'),
'shipping_state' => array('name' => 'SHIPTOSTATE', 'required' => 'no'),
'shipping_postal_code' => array('name' => 'SHIPTOZIP', 'required' => 'no'),
'shipping_country_code' => array('name' => 'SHIPTOCOUNTRYCODE', 'required' => 'no'),
'shipping_phone_number' => array('name' => 'SHIPTOPHONENUM', 'required' => 'no'),
'description' => array('name' => 'DESC', 'required' => 'no'), // You must match the billing agreement var in set Express checkout
'currency' => array('name' => 'CURRENCYCODE', 'required' => 'no'),
'payment_type' => array('name' => 'PAYMENTACTION', 'required' => 'no'),
'billing_type' => array('name' => 'L_BILLINGTYPE0', 'required' => 'no'),
'billing_agreement' => array('name' => 'L_BILLINGAGREEMENTDESCRIPTION0', 'required' => 'no'),
'profile_start_date' => array('name' => 'PROFILESTARTDATE', 'required' => 'yes'),
'billing_period' => array('name' => 'BILLINGPERIOD', 'required' => 'yes'), // Day Week Month SemiMonth Year
'billing_frequency' => array('name' => 'BILLINGFREQUENCY', 'required' => 'yes'),
'amount' => array('name' => 'AMT', 'required' => 'yes'),
'tax_amount' => array('name' => 'TAXAMT', 'required' => 'no'),
'ship_amount' => array('name' => 'SHIPPINGAMT', 'required' => 'no'),
'initial_amount' => array('name' => 'INITAMT', 'required' => 'no'),
'failed_inital_amount' => array('name' => 'FAILEDINITAMTACTION', 'required' => 'no'),
'billing_total_cycles' => array('name' => 'TOTALBILLINGCYCLES', 'required' => 'no'),
'trial_billing_period' => array('name' => 'TRIALBILLINGPERIOD', 'required' => 'no'),
'trial_billing_frequency' => array('name' => 'TRIALBILLINGFREQUENCY', 'required' => 'no'),
'trial_amount' => array('name' => 'TRIALAMT', 'required' => 'no'),
'trial_billing_cycle' => array('name' => 'TRIALTOTALBILLINGCYCLES', 'required' => 'no'),
'max_failed_attempts' => array('name' => 'MAXFAILEDPAYMENTS', 'required' => 'no'),
'auto_bill_amount' => array('name' => 'AUTOBILLOUTAMT', 'required' => 'no')
),
'UpdateRecurringPaymentsProfile' => array(
'profile_id' => array('name' => 'PROFILEID', 'required' => 'yes'),
'note' => array('name' => 'NOTE', 'required' => 'no'),
'description' => array('name' => 'DESC', 'required' => 'no'),
'subscriber_name' => array('name' => 'SUBSCRIBERNAME', 'required' => 'no'),
'profile_reference' => array('name' => 'PROFILEREFERENCE', 'required' => 'no'),
'additional_billing_cycles' => array('name' => 'ADDITIONALBILLINGCYCLES', 'required' => 'no'),
'amount' => array('name' => 'AMT', 'required' => 'yes'),
'shipping_amount' => array('name' => 'SHIPPINGAMT', 'required' => 'no'),
'tax_amount' => array('name' => 'TAXAMT', 'required' => 'no'),
'outstanding_amount' => array('name' => 'OUTSTANDINGAMT', 'required' => 'no'),
'auto_bill_out' => array('name' => 'AUTOBILLOUTAMT', 'required' => 'no'),
'max_failed_payments' => array('name' => 'MAXFAILEDPAYMENTS', 'required' => 'no'),
'profile_start_date' => array('name' => 'PROFILESTARTDATE' , 'required' => 'no'),
'ship_to_name' => array('name' => 'SHIPTONAME', 'required' => 'no'),
'ship_to_street' => array('name' => 'SHIPTOSTREET', 'required' => 'no'),
'ship_to_street_2' => array('name' => 'SHIPTOSTREET2', 'required' => 'no'),
'ship_to_city' => array('name' => 'SHIPTOCITY', 'required' => 'no'),
'ship_to_province' => array('name' => 'SHIPTOSTATE', 'required' => 'no'),
'ship_to_postal_code' => array('name' => 'SHIPTOZIP', 'required' => 'no'),
'ship_to_country' => array('name' => 'SHIPTOCOUNTRY', 'required' => 'no'),
'ship_to_phone_number' => array('name' => 'SHIPTOPHONENUM', 'required' => 'no'),
'billing_period' => array('name' => 'BILLINGPERIOD', 'required' => 'yes'),
'billing_frequency' => array('name' => 'BILLINGFREQUENCY', 'required' => 'yes'),
'total_billing_cycles' => array('name' => 'TOTALBILLINGCYCLES', 'required' => 'no'),
'trial_billing_period' => array('name' => 'TRIALBILLINGPERIOD', 'required' => 'no'),
'trial_billing_frequnecy' => array('name' => 'TRIALBILLINGFREQUENCY', 'required' => 'no'),
'trial_total_cycles' => array('name' => 'TRIALTOTALBILLINGCYCLES', 'required' => 'no'),
'trial_amount' => array('name' => 'TRIALAMT', 'required' => 'no'),
'currency' => array('name' => 'CURRENCYCODE', 'required' => 'yes'),
'shipping_amount' => array('name' => 'SHIPPINGAMT', 'required' => 'no'),
'tax_amount' => array('name' => 'TAXAMT', 'required' => 'no'),
'credit_card_type' => array('name' => 'CREDITCARDTYPE', 'required' => 'no'),
'credit_card_number' => array('name' => 'ACCT', 'required' => 'no'),
'expiration_date' => array('name' => 'EXPDATE', 'required' => 'no'),
'cvv2' => array('name' => 'CVV2', 'required' => 'no'),
'start_date' => array('name' => 'STARTDATE', 'required' => 'no'),
'email' => array('name' => 'EMAIL', 'required' => 'no'),
'first_name' => array('name' => 'FIRSTNAME', 'required' => 'no'),
'last_name' => array('name' => 'LASTNAME', 'required' => 'no'),
'street' => array('name' => 'STREET', 'required' => 'yes'),
'street2' => array('name' => 'STREET2', 'required' => 'no'),
'city' => array('name' => 'CITY', 'required' => 'yes'),
'province' => array('name' => 'STATE', 'required' => 'yes'),
'country_code' => array('name' => 'COUNTRYCODE', 'required' => 'yes'),
'postal_code' => array('name' => 'ZIP', 'required' => 'yes'),
'phone_number' => array('name' => 'PHONENUM', 'required' => 'no')
),
'GetRecurringPaymentsProfileDetails' => array(
'profile_id' => array('name' => 'PROFILEID', 'required' => 'yes')
),
'ManageRecurringPaymentsProfileStatus' => array(
'profile_id' => array('name' => 'PROFILEID', 'required' => 'yes'),
'action' => array('name' => 'ACTION', 'required' => 'yes'),
'note' => array('name' => 'NOTE', 'required' => 'no')
),
'DoReferenceTransaction' => array(
'reference_id' => array('name' => 'REFERENCEID', 'required' => 'yes'),
'payment_type' => array('name' => 'PAYMENTACTION', 'required' => 'yes'),
'return_fmf_details' => array('name' => 'RETURNFMFDETAILS', 'required' => 'no'),
'soft_descriptor' => array('name' => 'SOFTDESCRIPTOR', 'required' => 'no'),
'ship_to_name' => array('name' => 'SHIPTONAME', 'required' => 'no'),
'ship_to_street' => array('name' => 'SHIPTOSTREET', 'required' => 'no'),
'ship_to_street_2' => array('name' => 'SHIPTOSTREET2', 'required' => 'no'),
'ship_to_city' => array('name' => 'SHIPTOCITY', 'required' => 'no'),
'ship_to_province' => array('name' => 'SHIPTOSTATE', 'required' => 'no'),
'ship_to_postal_code' => array('name' => 'SHIPTOZIP', 'required' => 'no'),
'ship_to_country' => array('name' => 'SHIPTOCOUNTRY', 'required' => 'no'),
'ship_to_phone_number' => array('name' => 'SHIPTOPHONENUM', 'required' => 'no'),
'billing_period' => array('name' => 'BILLINGPERIOD', 'required' => 'yes'),
'billing_frequency' => array('name' => 'BILLINGFREQUENCY', 'required' => 'yes'),
'phone_number' => array('name' => 'PHONENUM', 'required' => 'no'),
'amount' => array('name' => 'AMT', 'required' => 'yes'),
'currency_code' => array('name' => 'CURRENCYCODE', 'required' => 'no'),
'amount_items' => array('name' => 'ITEMAMT', 'required' => 'no'),
'amount_shipping' => array('name' => 'SHIPPINGAMT', 'required' => 'no'),
'amount_handling' => array('name' => 'HANDLINGAMT', 'required' => 'no'),
'amount_tax' => array('name' => 'TAXAMT', 'required' => 'no'),
'description' => array('name' => 'DESC', 'required' => 'no'),
'custom' => array('name' => 'CUSTOM', 'required' => 'no'),
'invoice_number' => array('name' => 'INVNUM', 'required' => 'no'),
'button_source' => array('name' => 'BUTTONSOURCE', 'required' => 'no'),
'notify_url' => array('name' => 'NOTIFYURL', 'required' => 'no'),
'credit_card_type' => array('name' => 'CREDITCARDTYPE', 'required' => 'no'),
'credit_card_number' => array('name' => 'ACCT', 'required' => 'no'),
'cvv2_code' => array('name' => 'CVV2', 'required' => 'yes'),
'expire_date' => array('name' => 'EXPDATE', 'required' => 'no'),
'start_date' => array('name' => 'STARTDATE', 'required' => 'no'), // For Maestro/Solo cards
'issue_number' => array('name' => 'ISSUENUMBER', 'required' => 'no'), // For maestro/Solo Cards
'email' => array('name' => 'EMAIL', 'required' => 'no'),
'first_name' => array('name' => 'FIRSTNAME', 'required' => 'no'),
'last_name' => array('name' => 'LASTNAME', 'required' => 'no'),
'address1' => array('name' => 'STREET', 'required' => 'no'),
'address2' => array('name' => 'STREET2', 'required' => 'no'),
'city' => array('name' => 'CITY', 'required' => 'no'),
'state' => array('name' => 'STATE', 'required' => 'no'),
'country_code' => array('name' => 'COUNTRYCODE', 'required' => 'no'),
'postal_code' => array('name' => 'ZIP', 'required' => 'no')
)
);
public $ResponseFieldsArray = array(
'DoCapture' => array(
'authorization_id' => 'AUTHORIZATIONID',
'email' => 'EMAIL',
'payer_id' => 'PAYERID',
'payer_status' => 'PAYERSTATUS',
'country_code' => 'COUNTRYCODE',
'business' => 'BUSINESS',
'address_status' => 'ADDRESSSTATUS',
'shipping_name' => 'SHIPTONAME',
'shipping_address1' => 'SHIPTOSTREET',
'shipping_address2' => 'SHIPTOSTREET2',
'shipping_city' => 'SHIPTOCITY',
'shipping_state' => 'SHIPTOSTATE',
'shipping_postal_code' => 'SHIPTOZIP',
'shipping_country_code' => 'SHIPTOCOUNTRYCODE',
'salutation' => 'SALUTATION',
'first_name' => 'FIRSTNAME',
'middle_name' => 'MIDDLENAME',
'last_name' => 'LASTNAME',
'suffix' => 'SUFFIX'
),
'DoAuthorization' => array(
'transaction_id' => 'TRANSACTIONID',
'amount' => 'AMT'
),
'DoReauthorization' => array(
'authorization_id' => 'AUTHORIZATIONID'
),
'DoVoid' => array(
'authorization_id' => 'AUTHORIZATIONID'
),
'DoDirectPayment' => array(
'timestamp' => 'TIMESTAMP',
'correlation_id' => 'CORRELATIONID',
'ack' => 'ACK',
'version' => 'VERSION',
'build' => 'BUILD',
'avs_code' => 'AVSCODE',
'cvv2_match' => 'CVV2MATCH',
'transaction_id' => 'TRANSACTIONID',
'amount_total' => 'AMT',
'currency_code' => 'CURRENCYCODE'
)
,
'SetExpressCheckout' => array(
'timestamp' => 'TIMESTAMP',
'correlation_id' => 'CORRELATIONID',
'ack' => 'ACK',
'version' => 'VERSION',
'build' => 'BUILD',
'token' => 'TOKEN'
)
,
'DoExpressCheckoutPayment' => array(
'timestamp' => 'TIMESTAMP',
'correlation_id' => 'CORRELATIONID',
'ack' => 'ACK',
'version' => 'VERSION',
'build' => 'BUILD',
'token' => 'TOKEN',
'transaction_id' => 'TRANSACTIONID',
'transaction_type' => 'TRANSACTIONTYPE',
'payment_type' => 'PAYMENTTYPE',
'order_time' => 'ORDERTIME',
'amount_total' => 'AMT',
'currency_code' => 'CURRENCYCODE',
'amount_fee' => 'FEEAMT',
'amount_settle' => 'SETTLEAMT',
'amount_tax' => 'TAXAMT',
'exchange_rate' => 'EXCHANGERATE',
'payment_status' => 'PAYMENTSTATUS',
'payment_pending_reason'=> 'PENDINGREASON',
'payment_reason_code' => 'REASONCODE'
)
,
'GetExpressCheckoutDetails' => array(
'timestamp' => 'TIMESTAMP',
'correlation_id' => 'CORRELATIONID',
'ack' => 'ACK',
'version' => 'VERSION',
'build' => 'BUILD',
'token' => 'TOKEN',
'email' => 'EMAIL',
'payer_id' => 'PAYERID',
'payer_status' => 'PAYERSTATUS',
'salutation' => 'SALUTATION',
'first_name' => 'FIRSTNAME',
'middle_name' => 'MIDDLENAME',
'last_name' => 'LASTNAME',
'suffix' => 'SUFFIX',
'country_code' => 'COUNTRYCODE',
'business' => 'BUSINESS',
'shipping_name' => 'SHIPTONAME',
'shipping_address1' => 'SHIPTOSTREET',
'shipping_address2' => 'SHIPTOSTREET2',
'shipping_city' => 'SHIPTOCITY',
'shipping_state' => 'SHIPTOSTATE',
'shipping_country_code' => 'SHIPTOCOUNTRYCODE',
'shipping_country_name' => 'SHIPTOCOUNTRYNAME',
'shipping_postal_code' => 'SHIPTOZIP',
'address_id' => 'ADDRESSID', // Is this a returned variable? Some docs say yes, some no
'address_status' => 'ADDRESSSTATUS',
'description' => 'DESC',
'custom' => 'CUSTOM',
'phone_number' => 'PHONENUM'
)
,
'GetTransactionDetails' => array(
'timestamp' => 'TIMESTAMP',
'correlation_id' => 'CORRELATIONID',
'ack' => 'ACK',
'version' => 'VERSION',
'build' => 'BUILD',
'receiver_business' => 'RECEIVERBUSINESS',
'receiver_email' => 'RECEIVEREMAIL',
'receiver_id' => 'RECEIVERID',
'email' => 'EMAIL',
'payer_id' => 'PAYERID',
'payer_status' => 'PAYERSTATUS',
'salutation' => 'SALUTATION',
'first_name' => 'FIRSTNAME',
'last_name' => 'LASTNAME',
'middle_name' => 'MIDDLENAME',
'suffix' => 'SUFFIX',
'payer_business' => 'PAYERBUSINESS',
'country_code' => 'COUNTRYCODE',
'business' => 'BUSINESS',
'shipping_name' => 'SHIPTONAME',
'shipping_address1' => 'SHIPTOSTREET',
'shipping_address2' => 'SHIPTOSTREET2',
'shipping_city' => 'SHIPTOCITY',
'shipping_state' => 'SHIPTOSTATE',
'shipping_country_code' => 'SHIPTOCOUNTRYCODE',
'shipping_country_name' => 'SHIPTOCOUNTRYNAME',
'shipping_postal_code' => 'SHIPTOZIP',
'address_id' => 'ADDRESSID', // Is this a returned variable? Some docs say yes, some no
'address_status' => 'ADDRESSSTATUS',
'address_owner' => 'ADDRESSOWNER',
'parent_transaction_id' => 'PARENTTRANSACTIONID',
'transaction_id' => 'TRANSACTIONID',
'receipt_id' => 'RECEIPTID',
'transaction_type' => 'TRANSACTIONTYPE',
'payment_type' => 'PAYMENTTYPE',
'order_time' => 'ORDERTIME',
'amount_total' => 'AMT',
'currency_code' => 'CURRENCYCODE',
'amount_fee' => 'FEEAMT',
'amount_settle' => 'SETTLEAMT',
'amount_tax' => 'TAXAMT',
'exchange_rate' => 'EXCHANGERATE',
'payment_status' => 'PAYMENTSTATUS',
'payment_pending_reason' => 'PENDINGREASON',
'payment_reason_code' => 'REASONCODE',
'amount_sales_tax' => 'SALESTAX',
'invoice_number' => 'INVNUM',
'note' => 'NOTE',
'custom' => 'CUSTOM',
'subscription_id' => 'SUBSCRIPTIONID',
'subscription_date' => 'SUBSCRIPTIONDATE',
'effective_date' => 'EFFECTIVEDATE',
'retry_time' => 'RETRYTIME',
'user_name' => 'USERNAME',
'recurrences' => 'RECURRENCES',
'reattempt' => 'REATTEMPT',
'recurring' => 'RECURRING',
'period' => 'PERIOD',
'buyer_id' => 'BUYERID',
'closing_date' => 'CLOSINGDATE',
'multi_item' => 'MULTIITEM'
)
,
'RefundTransaction' => array(
'refund_transaction_id' => 'REFUNDTRANSACTIONID',
'amount_refund_net' => 'NETFUNDAMT',
'amount_refund_fee' => 'FEEREFUNDAMT',
'amount_refund_total' => 'GROSSREFUNDAMT'
),
'CreateRecurringPaymentsProfile' => array(
'profile_id' => 'PROFILEID',
'status' => 'STATUS'
),
'UpdateRecurringPaymentsProfile' => array(
'profile_id' => 'PROFILEID',
),
'GetRecurringPaymentsProfileDetails' => array(
'profile_id' => 'PROFILEID',
'status' => 'STATUS',
'auto_bill_out' => 'AUTOBILLOUTAMT',
'description' => 'DESC',
'max_failed_payments' => 'MAXFAILEDPAYMENTS',
'subcriber_name' => 'SUBSCRIBERNAME',
'profile_start_date' => 'PROFILESTARTDATE',
'nest_billing_date' => 'NEXTBILLINGDATE',
'num_cycles_completed' => 'NUMCYCLESCOMPLETED',
'num_cycles_remaining' => 'NUMCYCLESREMAINING',
'outstanding_balance' => 'OUTSTANDINGBALANCE',
'failed_billing_account'=> 'FAILEDPAYMENTCOUNT',
'trial_amount_paid' => 'TRIALAMTPAID',
'regular_amount_paid' => 'REGULARAMTPAID',
'aggregate_amount' => 'AGGREGATEAMT',
'aggregate_option_amount' => 'AGGREGATEOPTIONALAMT',
'final_payment_due_date' => 'FINALPAYMENTDUEDATE',
'time_stamp' => 'TIMESTAMP',
'correlation_id' => 'CORRELATIONID',
'ack' => 'ACK',
'version' => 'VERSION',
'build' => 'BUILD',
'ship_to_street' => 'SHIPTOSTREET',
'ship_to_street2' => 'SHIPTOSTREET2',
'ship_to_city' => 'SHIPTOCITY',
'ship_to_province' => 'SHIPTOSTATE',
'ship_to_postalcode' => 'SHIPTOZIP',
'ship_to_country_code' => 'SHIPTOCOUNTRYCODE',
'ship_to_country' => 'SHIPTOCOUNTRY',
'ship_to_country_name' => 'SHIPTOCOUNTRYNAME',
'ship_address_owner' => 'SHIPADDRESSOWNER',
'ship_address_status' => 'SHIPADDRESSSTATUS',
'billing_period' => 'BILLINGPERIOD',
'billing_frequency' => 'BILLINGFREQUENCY',
'total_biling_cycles' => 'TOTALBILLINGCYCLES',
'currency' => 'CURRENCYCODE',
'amount' => 'AMT',
'shipping_amount' => 'SHIPPINGAMT',
'tax_amount' => 'TAXAMT',
'regualar_billing_period' => 'REGULARBILLINGPERIOD',
'regular_billing_frequency' => 'REGULARBILLINGFREQUENCY',
'regular_billing_cycles' => 'REGULARTOTALBILLINGCYCLES',
'regular_currency' => 'REGULARCURRENCYCODE',
'regular_amount' => 'REGULARAMT',
'regular_shipping_amount' => 'REGULARSHIPPINGAMT',
'regular_tax_amount' => 'REGULARTAXAMT',
'credit_card_num' => 'ACCT',
'credit_card_type' => 'CREDITCARDTYPE',
'expiration_date' => 'EXPDATE',
'email' => 'EMAIL',
'first_name' => 'FIRSTNAME',
'last_name' => 'LASTNAME',
'street' => 'STREET',
'street2' => 'STREET2',
'city' => 'CITY',
'state' => 'STATE',
'postal_code' => 'ZIP',
'country_code' => 'COUNTRYCODE',
'country' => 'COUNTRY',
'address_owner' => 'ADDRESSOWNER',
'address_status' => 'ADDRESSSTATUS',
'payer_status' => 'PAYERSTATUS'
),
'ManageRecurringPaymentsProfileStatus' => array(
'profile_id' => 'PROFILEID',
),
'DoReferenceTransaction' => array(
'avs_code' => 'AVSCODE',
'cvv2_match' => 'AVV2MATCH',
'billing_agreement_id' => 'BILLINGAGREEMENTID', // Should include filter IDs, but this will have to be done in the function level
'transaction_id' => 'TRANSACTIONID',
'transaction_type' => 'TRANSACTIONTYPE',
'payment_type' => 'PAYMENTTYPE',
'order_time' => 'ORDERTIME',
'amount_total' => 'AMT',
'currency_code' => 'CURRENCYCODE',
'ammount_fee' => 'FEEAMT',
'amount_settle' => 'SETTLEAMT',
'amount_tax' => 'TAXAMT',
'exchange_rate' => 'EXCHANGERATE',
'payment_status' => 'PAYMENTSTATUS',
'pending_reason' => 'PENDINGREASON',
'reason_code' => 'REASONCODE',
'protection_eligibility'=> 'PROTECTIONELIGIBILITY',
'ebay_item_auction_transaction_id' => 'EBAYITEMAUCTIONTXNID',
'payment_error' => 'PAYMENTERROR'
)
);
// CONSTRUCT
function __construct($config, $sandbox = false)
{
// Determine our API endpoint
if ($sandbox) {
$this->API_ENDPOINT = 'https://api-3t.sandbox.paypal.com/nvp';
$this->PAYPAL_URL = 'https://www.sandbox.paypal.com/webscr&cmd=_express-checkout&token=';
}
else {
$this->API_ENDPOINT = 'https://api-3t.paypal.com/nvp';
$this->PAYPAL_URL = 'https://www.paypal.com/webscr&cmd=_express-checkout&token=';
}
$this->API_USERNAME = $config['api_username'];
$this->API_PASSWORD = $config['api_password'];
$this->API_SIGNATURE = $config['api_signature'];
$this->USE_PROXY = $config['use_proxy'];
$this->PROXY_HOST = $config['proxy_host'];
$this->PROXY_PORT = $config['proxy_port'];
$this->return_url = $config['return_url'];
$this->cancel_url = $config['cancel_url'];
}
public function do_capture()
{
// urlencode the needed variables
$this->urlencodeVariables();
/* Construct the request string that will be sent to PayPal.
The variable $nvpstr contains all the variables and is a
name value pair string with & as a delimiter */
$nvpstr = $this->generateNVPString('DoCapture');
// decode the variables incase we still require access to them in our program
$this->urldecodeVariables();
/* Make the API call to PayPal, using API signature.
The API response is stored in an associative array called $this->Response */
$this->Response = $this->hash_call("DoCapture", $nvpstr);
// Format our response and return the outcome
return $this->format_response();
}
public function do_authorization()
{
// urlencode the needed variables
$this->urlencodeVariables();
/* Construct the request string that will be sent to PayPal.
The variable $nvpstr contains all the variables and is a
name value pair string with & as a delimiter */
$nvpstr = $this->generateNVPString('DoAuthorization');
// decode the variables incase we still require access to them in our program
$this->urldecodeVariables();
/* Make the API call to PayPal, using API signature.
The API response is stored in an associative array called $this->Response */
$this->Response = $this->hash_call("DoAuthorization", $nvpstr);
// Format our response and return the outcome
return $this->format_response();
}
public function do_reauthorization()
{
// urlencode the needed variables
$this->urlencodeVariables();
/* Construct the request string that will be sent to PayPal.
The variable $nvpstr contains all the variables and is a
name value pair string with & as a delimiter */
$nvpstr = $this->generateNVPString('DoReauthorization');
// decode the variables incase we still require access to them in our program
$this->urldecodeVariables();
/* Make the API call to PayPal, using API signature.
The API response is stored in an associative array called $this->Response */
$this->Response = $this->hash_call("DoReauthorization", $nvpstr);
// Format our response and return the outcome
return $this->format_response();
}
public function do_void()
{
// urlencode the needed variables
$this->urlencodeVariables();
/* Construct the request string that will be sent to PayPal.
The variable $nvpstr contains all the variables and is a
name value pair string with & as a delimiter */
$nvpstr = $this->generateNVPString('DoVoid');
// decode the variables incase we still require access to them in our program
$this->urldecodeVariables();
/* Make the API call to PayPal, using API signature.
The API response is stored in an associative array called $this->Response */
$this->Response = $this->hash_call("DoVoid", $nvpstr);
// Format our response and return the outcome
return $this->format_response();
}
public function do_direct_payment()
{
// urlencode the needed variables
$this->urlencodeVariables();
/* Construct the request string that will be sent to PayPal.
The variable $nvpstr contains all the variables and is a
name value pair string with & as a delimiter */
$nvpstr = $this->generateNVPString('DoDirectPayment');
/* Construct and add any items found in this instance */
if(!empty($this->ItemsArray))
{
// Counter for the total of all the items put together
$total_items_amount = 0;
$total_items_tax_amount = 0;
// Go through the items array
foreach($this->ItemsArray as $key => $value)
{
// Get the array of the current item from the main array
$current_item = $this->ItemsArray[$key];
// Add it to the request string
$nvpstr .= "&L_NAME".$key."=".$current_item['name'].
"&L_NUMBER".$key."=".$current_item['number'].
"&L_QTY".$key."=".$current_item['quantity'].
"&L_TAXAMT".$key."=".$current_item['amount_tax'].
"&L_AMT".$key."=".$current_item['amount'];
// Add this item's amount to the total current count
$total_items_amount += ($current_item['amount'] * $current_item['quantity']);
$total_items_tax_amount += ($current_item['amount_tax'] * $current_item['quantity']);
}
// Set the amount_items for this instance and ITEMAMT added to the request string
$this->amount_items = $total_items_amount;
// Add this to our NVP string
$nvpstr .= "&ITEMAMT=".urlencode($total_items_amount);
// If our entire tax amount is not set, we will automatically set it based on the items tax amount
if($this->amount_tax == 0 OR empty($this->amount_tax))
$nvpstr .= "&TAXAMT=".urlencode($total_items_tax_amount);
}
// decode the variables incase we still require access to them in our program
$this->urldecodeVariables();
/* Make the API call to PayPal, using API signature.
The API response is stored in an associative array called $this->Response */
$this->Response = $this->hash_call("DoDirectPayment", $nvpstr);
// Format our response and return the outcome
return $this->format_response();
}
public function set_express_checkout()
{
// TODO: Add error handling prior to trying to make PayPal calls. ie: missing amount_total or RETURN_URL
// urlencode the needed variables
$this->urlencodeVariables();
/* Construct the parameter string that describes the PayPal payment
the varialbes were set in the web form, and the resulting string
is stored in $nvpstr
*/
$nvpstr = $this->generateNVPString('SetExpressCheckout');
/* Construct and add any items found in this instance */
if(!empty($this->ItemsArray))
{
// Counter for the total of all the items put together
$total_items_amount = 0;
$total_items_tax_amount = 0;
// Go through the items array//$nvpstr = str_replace("Sale", "Authorization", $nvpstr ); foreach($this->ItemsArray as $key => $value) { // Get the array of the current item from the main array $current_item = $this->ItemsArray[$key]; // Add it to the request string
#$nvpstr .= "&L_NAME".$key."=".'test'."&L_PAYMENTREQUEST_0_NAME0=test00".
"&L_NUMBER".$key."=".$current_item['number'].
"&L_QTY".$key."=".$current_item['quantity'].
"&L_TAXAMT".$key."=". number_format($current_item['amount_tax'], 2, '.', ',').
"&L_AMT".$key."=". number_format($current_item['amount'], 2, '.', ',');
$nvpstr .= "&PAYMENTREQUEST_0_AMT=".number_format($current_item['amount'], 2, '.', ',');
//$nvpstr .= "&PAYMENTACTION = Authorization";
$nvpstr .= "&L_PAYMENTREQUEST_0_NAME0=testos".$current_item['name'];
$nvpstr .= "&L_PAYMENTREQUEST_0_AMT0=".number_format($current_item['amount'], 2, '.', ',');
$nvpstr .= "&L_PAYMENTREQUEST_0_QTY0=".$current_item['quantity'];
// Add this item's amount to the total current count
$total_items_amount += ($current_item['amount'] * $current_item['quantity']);
$total_items_tax_amount += ($current_item['amount_tax'] * $current_item['quantity']);
} // Set the amount_items for this instance and ITEMAMT added to the request string
$this->amount_items = $total_items_amount;
// Add this to our NVP string
#$nvpstr .= "&ITEMAMT=".number_format($total_items_amount, 2, '.', ',');
// If our entire tax amount is not set, we will automatically set it based on the items tax amount
#if($this->amount_tax == 0 OR empty($this->amount_tax))
#$nvpstr .= "&TAXAMT=".number_format($total_items_tax_amount, 2, '.', ',');
} // decode the variables incase we still require access to them in our program
$this->urldecodeVariables();
/* Make the call to PayPal to set the Express Checkout token
If the API call succeded, then redirect the buyer to PayPal
to begin to authorize payment. If an error occured, show the
resulting errors
*/
$this->Response = $this->hash_call("SetExpressCheckout", $nvpstr);
// Format our response and return the outcome
return $this->format_response();
}
public function set_express_checkout_successful_redirect()
{
// Redirect to paypal.com here
$token = urlencode($this->Response["TOKEN"]);
$paypal_url = $this->PAYPAL_URL.$token;
header("Location: ".$paypal_url);
}
public function get_express_checkout_details()
{
// TODO: Add error handling prior to PayPal calls. ie: missing TOKEN
/* At this point, the buyer has completed in authorizing payment
at PayPal. The script will now call PayPal with the details
of the authorization, incuding any shipping information of the
buyer. Remember, the authorization is not a completed transaction
at this state - the buyer still needs an additional step to finalize
the transaction
*/
/* Build a second API request to PayPal, using the token as the
ID to get the details on the payment authorization
*/
/* Construct the parameter string that describes the PayPal payment
the varialbes were set in the web form, and the resulting string
is stored in $nvpstr
*/
$nvpstr = $this->generateNVPString('GetExpressCheckoutDetails');
/* Make the API call and store the results in an array. If the
call was a success, show the authorization details, and provide
an action to complete the payment. If failed, show the error
*/
$this->Response = $this->hash_call("GetExpressCheckoutDetails", $nvpstr);
// Format our response and return the outcome
return $this->format_response();
}
public function do_express_checkout_payment()
{
// urlencode the needed variables
$this->urlencodeVariables();
/* Construct the parameter string that describes the PayPal payment
the varialbes were set in the web form, and the resulting string
is stored in $nvpstr
*/
$nvpstr = $this->generateNVPString('DoExpressCheckoutPayment');
///$nvpstr = str_replace("Sale", "Authorization", $nvpstr );
/* Construct and add any items found in this instance */
if(!empty($this->ItemsArray))
{
// Counter for the total of all the items put together
$total_items_amount = 0;
// Go through the items array
foreach($this->ItemsArray as $key => $value)
{
// Get the array of the current item from the main array
$current_item = $this->ItemsArray[$key];
// Add it to the request string
#$nvpstr .= "&L_NAME".$key."=".$current_item['name'].
"&L_NUMBER".$key."=".$current_item['number'].
"&L_QTY".$key."=".$current_item['quantity'].
"&L_TAXAMT".$key."=".$current_item['amount_tax'].
"&L_AMT".$key."=".$current_item['amount'];
$nvpstr .= "&PAYMENTREQUEST_0_AMT=".number_format($current_item['amount'], 2, '.', ',');
//$nvpstr .= "&PAYMENTACTION = Authorization";
$nvpstr .= "&L_PAYMENTREQUEST_0_NAME0=testos".$current_item['name'];
$nvpstr .= "&L_PAYMENTREQUEST_0_AMT0=".number_format($current_item['amount'], 2, '.', ',');
$nvpstr .= "&L_PAYMENTREQUEST_0_QTY0=".$current_item['quantity'];
// Add this item's amount to the total current count
$total_items_amount += ($current_item['amount'] * $current_item['quantity']);
}
// Set the amount_items for this instance and ITEMAMT added to the request string
$this->amount_items = $total_items_amount;
$nvpstr .= "&ITEMAMT=".$total_items_amount;
}//echo ' ---- nvpstr = '.$nvpstr; die; / Make the call to PayPal to finalize payment If an error occured, show the resulting errors / $this->Response = $this->hash_call("DoExpressCheckoutPayment", $nvpstr);
// decode the variables incase we still require access to them in our program
$this->urldecodeVariables();
// Format our response and return the outcome
return $this->format_response();
}
public function get_transaction_details()
{
/* Construct the parameter string that describes the PayPal payment
the varialbes were set in the web form, and the resulting string
is stored in $nvpstr
*/
$nvpstr = $this->generateNVPString('GetTransactionDetails');
/* Make the API call to PayPal, using API signature.
The API response is stored in an associative array called $resArray */
$this->Response = $this->hash_call("GetTransactionDetails", $nvpstr);
// Format our response and return the outcome
return $this->format_response();
}
public function refund_transaction()
{
/* Construct the parameter string that describes the PayPal payment
the varialbes were set in the web form, and the resulting string
is stored in $nvpstr
*/
$nvpstr = $this->generateNVPString('RefundTransaction');
/* Make the API call to PayPal, using API signature.
The API response is stored in an associative array called $resArray */
$this->Response = $this->hash_call("RefundTransaction", $nvpstr);
// Format our response and return the outcome
return $this->format_response();
}
public function create_recurring_payments_profile()
{
$this->urlencodeVariables();
$nvpstr = $this->generateNVPString('CreateRecurringPaymentsProfile');
$this->Response = $this->hash_call("CreateRecurringPaymentsProfile", $nvpstr);
$this->urldecodeVariables();
// Format our response and return the outcome
return $this->format_response();
}
public function get_recurring_payments_profile_details()
{
$nvpstr = $this->generateNVPString('GetRecurringPaymentsProfileDetails');
$this->Response = $this->hash_call("GetRecurringPaymentsProfileDetails", $nvpstr);
// Format our response and return the outcome
return $this->format_response();
}
public function update_recurring_payments_profile()
{
$this->urlencodeVariables();
$nvpstr = $this->generateNVPString('UpdateRecurringPaymentsProfile');
$this->urldecodeVariables();
$this->Response = $this->hash_call("UpdateRecurringPaymentsProfile", $nvpstr);
// Format our response and return the outcome
return $this->format_response();
}
public function manage_recurring_payments_profile_status()
{
$this->urlencodeVariables();
$nvpstr = $this->generateNVPString('ManageRecurringPaymentsProfileStatus');
$this->urldecodeVariables();
$this->Response = $this->hash_call("ManageRecurringPaymentsProfileStatus", $nvpstr);
// Format our response and return the outcome
return $this->format_response();
}
public function do_reference_transaction()
{
// urlencode the needed variables
$this->urlencodeVariables();
/* Construct the request string that will be sent to PayPal.
The variable $nvpstr contains all the variables and is a
name value pair string with & as a delimiter */
$nvpstr = $this->generateNVPString('DoReferenceTransaction');
/* Construct and add any items found in this instance */
if(!empty($this->ItemsArray))
{
// Counter for the total of all the items put together
$total_items_amount = 0;
$total_items_tax_amount = 0;
// Go through the items array
foreach($this->ItemsArray as $key => $value)
{
// Get the array of the current item from the main array
$current_item = $this->ItemsArray[$key];
// Add it to the request string
$nvpstr .= "&L_NAME".$key."=".$current_item['name'].
"&L_NUMBER".$key."=".$current_item['number'].
"&L_QTY".$key."=".$current_item['quantity'].
"&L_TAXAMT".$key."=".$current_item['amount_tax'].
"&L_AMT".$key."=".$current_item['amount'];
// Add this item's amount to the total current count
$total_items_amount += ($current_item['amount'] * $current_item['quantity']);
$total_items_tax_amount += ($current_item['amount_tax'] * $current_item['quantity']);
}
// Set the amount_items for this instance and ITEMAMT added to the request string
$this->amount_items = $total_items_amount;
// Add this to our NVP string
$nvpstr .= "&ITEMAMT=".urlencode($total_items_amount);
// If our entire tax amount is not set, we will automatically set it based on the items tax amount
if($this->amount_tax == 0 OR empty($this->amount_tax))
$nvpstr .= "&TAXAMT=".urlencode($total_items_tax_amount);
}
// decode the variables incase we still require access to them in our program
$this->urldecodeVariables();
/* Make the API call to PayPal, using API signature.
The API response is stored in an associative array called $this->Response */
$this->Response = $this->hash_call("DoReferenceTransaction", $nvpstr);
// Format our response and return the outcome
return $this->format_response();
}
/**
* hash_call: Function to perform the API call to PayPal using API signature
* @methodName is name of API method.
* @nvpStr is nvp string.
* returns an associtive array containing the response from the server.
*/
private function hash_call($methodName, $nvpStr)
{
// TODO: Add error handling for the hash_call
//setting the curl parameters.
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,$this->API_ENDPOINT);
curl_setopt($ch, CURLOPT_VERBOSE, 1);
//turning off the server and peer verification(TrustManager Concept).
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER,1);
curl_setopt($ch, CURLOPT_POST, 1);
//if USE_PROXY constant set to true in Constants.php, then only proxy will be enabled.
//Set proxy name to PROXY_HOST and port number to PROXY_PORT in constants.php
if($this->USE_PROXY)
curl_setopt ($ch, CURLOPT_PROXY, $this->PROXY_HOST.":".$this->PROXY_PORT);
//NVPRequest for submitting to server
$nvpreq = "METHOD=".urlencode($methodName)."&VERSION=".urlencode($this->VERSION)."&PWD=".urlencode($this->API_PASSWORD).
"&USER=".urlencode($this->API_USERNAME)."&SIGNATURE=".urlencode($this->API_SIGNATURE).$nvpStr;
//setting the nvpreq as POST FIELD to curl
curl_setopt($ch,CURLOPT_POSTFIELDS,$nvpreq);
//getting response from server
$response = curl_exec($ch);
//convrting NVPResponse to an Associative Array
$nvpResArray = $this->deformatNVP($response);
$nvpReqArray = $this->deformatNVP($nvpreq);
$_SESSION['nvpReqArray'] = $nvpReqArray;
/*
*************
if NO SUCCESS
*************
*/
if (curl_errno($ch))
{
// moving to display page to display curl errors
$_SESSION['curl_error_no'] = curl_errno($ch) ;
$_SESSION['curl_error_msg'] = curl_error($ch);
$this->_error = true;
$this->ack = 'Failure';
$this->_error_type = 'curl';
$this->_error_date = date("Y-m-d H:i:s");
$this->_error_code = curl_errno($ch);
$this->_error_short_message = 'There was an error trying to contact the PayPal servers. (curl error) See long message for details.';
$this->_error_long_message = curl_error($ch);
return false;
}
/*
*************
if SUCCESS
*************
*/
else
{
//closing the curl
curl_close($ch);
}
return $nvpResArray;
}
/** This function will take NVPString and convert it to an Associative Array and it will decode the response.
* It is usefull to search for a particular key and displaying arrays.
* @nvpstr is NVPString.
* @nvpArray is an Associative Array.
*/
private function deformatNVP($nvpstr)
{
$intial=0;
$nvpArray = array();
while(strlen($nvpstr))
{
//postion of Key
$keypos= strpos($nvpstr,'=');
//position of value
$valuepos = strpos($nvpstr,'&') ? strpos($nvpstr,'&'): strlen($nvpstr);
/*getting the Key and Value values and storing in a Associative Array*/
$keyval=substr($nvpstr,$intial,$keypos);
$valval=substr($nvpstr,$keypos+1,$valuepos-$keypos-1);
//decoding the respose
$nvpArray[urldecode($keyval)] =urldecode( $valval);
$nvpstr=substr($nvpstr,$valuepos+1,strlen($nvpstr));
}
return $nvpArray;
}
// Clear our items array to make way for another transaction
public function clear_items()
{
$this->ItemsArray = NULL;
}
/* This function will add an item to the itemArray for use in doDirectPayment and doExpressCheckoutPayment */
public function add_item($name, $number, $quantity, $amount_tax, $amount)
{
//echo 'paypal submit /add_item/ name = '. $name ;
$new_item = array(
'name' => $name,
'number' => $number,
'quantity' => $quantity,
'amount_tax' => $amount_tax,
'amount' => $amount);
$this->ItemsArray[] = $new_item;
//print_r($this->ItemsArray); die;
// TODO: Should recalculate and set $this->amount_items after every new item is added. Or is this done on each request?
}
private function get_items($passed_response)
{
// Clear any current items
$this->ItemsArray = '';
// Get the items if there are any
// Start this off by checking for a first item
if(!empty($passed_response['L_NAME0']) OR !empty($passed_response['L_NUMBER0']) OR !empty($passed_response['L_QTY0']))
{
$i = 0;
// Start a loop to get all the items (up to 200)
// We'll break out of it if we stop finding items
while($i < 200)
{
// One of the Name, Number, and Qty fields may be empty, so check all of them
// and if any of them are filled, then we have an item
if(!empty($passed_response['L_NAME'.$i]) OR !empty($passed_response['L_NUMBER'.$i]) OR !empty($passed_response['L_QTY'.$i]))
{
$new_item = array(
'name' => $passed_response['L_NAME'.$i],
'number' => $passed_response['L_NUMBER'.$i],
'quantity' => $passed_response['L_QTY'.$i],
'amount_tax' => $passed_response['L_TAXAMT'.$i],
'amount' => $passed_response['L_AMT'.$i]);
$this->ItemsArray[] = $new_item;
$i++;
}
else
break;
} // end while
} // end if
} // end function
private function generateNVPString($type)
{
$temp_nvp_str = '';
// Go through the selected RequestFieldsArray and create the request string based on whether the field is required or filled
// TODO: return error if required field is empty?
foreach($this->RequestFieldsArray[$type] as $key => $value)
{
if($value['required'] == 'yes') {
$v = $this->$key;
if ($key === 'amount_total') {
$v = number_format($v, 2, '.', ',');
}
$temp_nvp_str .= '&' . $value['name'] . '=' . $v;
}
elseif(!empty($this->$key))
$temp_nvp_str .= '&'.$value['name'].'='.$this->$key;
}
$temp_nvp_str .= "&PAYMENTREQUEST_0_AMT=0.51";
$temp_nvp_str .= "&L_PAYMENTREQUEST_0_NAME0=testos";
$temp_nvp_str .= "&L_PAYMENTREQUEST_0_AMT0=0.52";
$temp_nvp_str .= "&L_PAYMENTREQUEST_0_QTY0=1";
//echo '------ tmpstr ='.$temp_nvp_str;die;
return $temp_nvp_str;
}
/* This function encodes all applicable variables for transport to PayPal */
private function urlencodeVariables()
{
// Decode all specified variables
$this->payment_type = urlencode($this->payment_type);
$this->email = urlencode($this->email);
$this->first_name = urlencode($this->first_name);
$this->last_name = urlencode($this->last_name);
$this->credit_card_type = urlencode($this->credit_card_type);
$this->credit_card_number = urlencode($this->credit_card_number);
// Month must be padded with leading zero
$this->expire_date = urlencode(str_pad($this->expire_date, 6, '0', STR_PAD_LEFT));
$this->cvv2_code = urlencode($this->cvv2_code);
$this->address1 = urlencode($this->address1);
$this->address2 = urlencode($this->address2);
$this->city = urlencode($this->city);
$this->state = urlencode($this->state);
$this->postal_code = urlencode($this->postal_code);
$this->country_code = urlencode($this->country_code);
$this->currency_code = urlencode($this->currency_code);
$this->ip_address = urlencode($this->ip_address);
$this->shipping_name = urlencode($this->shipping_name);
$this->shipping_address1 = urlencode($this->shipping_address1);
$this->shipping_address2 = urlencode($this->shipping_address2);
$this->shipping_city = urlencode($this->shipping_city);
$this->shipping_state = urlencode($this->shipping_state);
$this->shipping_postal_code = urlencode($this->shipping_postal_code);
$this->shipping_country_code = urlencode($this->shipping_country_code);
$this->shipping_phone_number = urlencode($this->shipping_phone_number);
$this->amount_total = urlencode($this->amount_total);
$this->amount_shipping = urlencode($this->amount_shipping);
$this->amount_tax = urlencode($this->amount_tax);
$this->amount_handling = urlencode($this->amount_handling);
$this->amount_items = urlencode($this->amount_items);
$this->token = urlencode($this->token);
$this->payer_id = urlencode($this->payer_id);
$this->description = urlencode($this->description);
if(!empty($this->ItemsArray))
{
// Go through the items array
foreach($this->ItemsArray as $key => $value)
{
// Get the array of the current item from the main array
$current_item = $this->ItemsArray[$key];
// Encode everything
// TODO: use a foreach loop instead
$current_item['name'] = urlencode($current_item['name']);
$current_item['number'] = urlencode($current_item['number']);
$current_item['quantity'] = urlencode($current_item['quantity']);
$current_item['amount_tax'] = urlencode($current_item['amount_tax']);
$current_item['amount'] = urlencode($current_item['amount']);
// Put the encoded array back in the item array (replaces previous array)
$this->ItemsArray[$key] = $current_item;
}
}
}
/* This function Decodes all applicable variables for use in application/database */
private function urldecodeVariables()
{
// Decode all specified variables
$this->payment_type = urldecode($this->payment_type);
$this->email = urldecode($this->email);
$this->first_name = urldecode($this->first_name);
$this->last_name = urldecode($this->last_name);
$this->credit_card_type = urldecode($this->credit_card_type);
$this->credit_card_number = urldecode($this->credit_card_number);
// Month must be padded with leading zero
$this->expire_date = urldecode(str_pad($this->expire_date, 6, '0', STR_PAD_LEFT));
$this->cvv2_code = urldecode($this->cvv2_code);
$this->address1 = urldecode($this->address1);
$this->address2 = urldecode($this->address2);
$this->city = urldecode($this->city);
$this->state = urldecode($this->state);
$this->postal_code = urldecode($this->postal_code);
$this->country_code = urldecode($this->country_code);
$this->currency_code = urldecode($this->currency_code);
$this->ip_address = urldecode($this->ip_address);
$this->shipping_name = urldecode($this->shipping_name);
$this->shipping_address1 = urldecode($this->shipping_address1);
$this->shipping_address2 = urldecode($this->shipping_address2);
$this->shipping_city = urldecode($this->shipping_city);
$this->shipping_state = urldecode($this->shipping_state);
$this->shipping_postal_code = urldecode($this->shipping_postal_code);
$this->shipping_country_code = urldecode($this->shipping_country_code);
$this->shipping_phone_number = urldecode($this->shipping_phone_number);
$this->amount_total = urldecode($this->amount_total);
$this->amount_shipping = urldecode($this->amount_shipping);
$this->amount_tax = urldecode($this->amount_tax);
$this->amount_handling = urldecode($this->amount_handling);
$this->amount_items = urldecode($this->amount_items);
$this->token = urldecode($this->token);
$this->payer_id = urldecode($this->payer_id);
$this->description = urldecode($this->description);
if(!empty($this->ItemsArray))
{
// Go through the items array
foreach($this->ItemsArray as $key => $value)
{
// Get the array of the current item from the main array
$current_item = $this->ItemsArray[$key];
// Decode everything
// TODO: use a foreach loop instead
$current_item['name'] = urldecode($current_item['name']);
$current_item['number'] = urldecode($current_item['number']);
$current_item['quantity'] = urldecode($current_item['quantity']);
$current_item['amount_tax'] = urldecode($current_item['amount_tax']);
$current_item['amount'] = urldecode($current_item['amount']);
// Put the decoded array back in the item array (replaces previous array)
$this->ItemsArray[$key] = $current_item;
}
}
}
// We take our response and depending on whether it's a success or failure, set our values accordingly
private function format_response()
{
if(strtoupper($this->Response["ACK"]) != "SUCCESS" AND strtoupper($this->Response["ACK"]) != "SUCCESSWITHWARNING")
{
$this->Error['TIMESTAMP'] = @$this->Response['TIMESTAMP'];
$this->Error['CORRELATIONID'] = @$this->Response['CORRELATIONID'];
$this->Error['ACK'] = $this->Response['ACK'];
$this->Error['ERRORCODE'] = $this->Response['L_ERRORCODE0'];
$this->Error['SHORTMESSAGE'] = $this->Response['L_SHORTMESSAGE0'];
$this->Error['LONGMESSAGE'] = $this->Response['L_LONGMESSAGE0'];
$this->Error['SEVERITYCODE'] = $this->Response['L_SEVERITYCODE0'];
$this->Error['VERSION'] = @$this->Response['VERSION'];
$this->Error['BUILD'] = @$this->Response['BUILD'];
// TODO: Error codes for AVSCODE and CVV@MATCH
$this->_error = true;
$this->_error_ack = $this->Response['ACK'];
$this->ack = 'Failure';
$this->_error_type = 'paypal';
$this->_error_date = $this->Response['TIMESTAMP'];
$this->_error_code = $this->Response['L_ERRORCODE0'];
$this->_error_short_message = $this->Response['L_SHORTMESSAGE0'];
$this->_error_long_message = $this->Response['L_LONGMESSAGE0'];
$this->_error_severity_code = $this->Response['L_SEVERITYCODE0'];
$this->_error_version = @$this->Response['VERSION'];
$this->_error_build = @$this->Response['BUILD'];
return false;
}
/*
*************
if SUCCESS
*************
*/
elseif(strtoupper($this->Response["ACK"]) == 'SUCCESS' OR strtoupper($this->Response["ACK"]) == 'SUCCESSWITHWARNING')
{
/* Take the response variables and put them into the local class variables */
foreach($this->ResponseFieldsArray['DoReferenceTransaction'] as $key => $value)
$this->$key = $this->Response[$value];
return true;
}
}} // END CLASS`
Hi all, it appears
SimpleCart_PayPal/core/components/simplecart_paypal/lib/paypal.class.phpnot passing the item name to paypal's transaction.The paypal has been contacted about the issue if they know what is wrong and why there is no item name for a Sale transaction and first they were saying that the following params were missing: &PAYMENTREQUEST_0_AMT=0.50 &L_PAYMENTREQUEST_0_NAME0=test &L_PAYMENTREQUEST_0_AMT0=0.50 &L_PAYMENTREQUEST_0_QTY0=1
but once it has been implemented and tested again they keep saying something else:
do not see the parameters sent in the DoExpressCheckout request yet. Would you please check on your end why the parameters are not being passed?Any help would be highly appreciated as I believe other users may have the same issues nowadays
Thanks