![]($this->proto://$this->host/fp/clear.png?org_id=".
"$this->orgID&session_id=$this->sessionID&m=2){kind=spacer}
".
"";
return $html;
}
}
checkout/index.html 0000666 00000000057 15137552047 0010365 0 ustar 00
checkout/.htaccess 0000666 00000000177 15137552047 0010171 0 ustar 00 * "Buy now, pay in x month"
* * @var int */ const SPECIAL = 2; /** * Fixed campaign type pclass * * @var int */ const FIXED = 3; /** * Delayed campaign type pclass.
* "Pay in X months"
* * @var int */ const DELAY = 4; /** * Klarna Mobile type pclass * * @var int */ const MOBILE = 5; /** * The description for this PClass. * HTML entities for special characters. * * @ignore Do not show in PHPDoc. * @var string */ protected $description; /** * Number of months for this PClass. * * @ignore Do not show in PHPDoc. * @var int */ protected $months; /** * PClass starting fee. * * @ignore Do not show in PHPDoc. * @var float */ protected $startFee; /** * PClass invoice/handling fee. * * @ignore Do not show in PHPDoc. * @var float */ protected $invoiceFee; /** * PClass interest rate. * * @ignore Do not show in PHPDoc. * @var float */ protected $interestRate; /** * PClass minimum amount for purchase/product. * * @ignore Do not show in PHPDoc. * @var float */ protected $minAmount; /** * PClass country. * * @ignore Do not show in PHPDoc. * @see KlarnaCountry * @var int */ protected $country; /** * PClass ID. * * @ignore Do not show in PHPDoc. * @var int */ protected $id; /** * PClass type. * * @see self::CAMPAIGN * @see self::ACCOUNT * @see self::SPECIAL * @see self::FIXED * @see self::DELAY * @see self::MOBILE * * @ignore Do not show in PHPDoc. * @var int */ protected $type; /** * Expire date / valid until date as unix timestamp.
* Compare it with e.g. $_SERVER['REQUEST_TIME'].
* * @ignore Do not show in PHPDoc. * @var int */ protected $expire; /** * Merchant ID / Estore ID. * * @ignore Do not show in PHPDoc. * @var int */ protected $eid; /** * Class constructor * * The optional array argument can be: * array ( * 0 = eid (this is created in the API) * 1 = id number * 2 = description * 3 = amount of months for part payment * 4 = start fee * 5 = invoice fee * 6 = interest rate * 7 = minimum purchase amount for pclass * 8 = country * 9 = type * (This is used to determine which pclass-id is an account and * a campaign, 0 = campaign, 1 = account, 2 = special campaign * i.e. x-mas campaign) * 10 = expire date * * @param null|array $arr Associative or numeric array of PClass data. */ public function __construct($arr = null) { if (!is_array($arr) || count($arr) < 11) { return; } foreach ($arr as $key => $val) { switch($key) { case "0": case "eid": $this->setEid($val); break; case "1": case "id": $this->setId($val); break; case "2": case "desc": case "description": $this->setDescription($val); break; case "3": case "months": $this->setMonths($val); break; case "4": case "startfee": $this->setStartFee($val); break; case "5": case "invoicefee": $this->setInvoiceFee($val); break; case "6": case "interestrate": $this->setInterestRate($val); break; case "7": case "minamount": $this->setMinAmount($val); break; case "8": case "country": $this->setCountry($val); break; case "9": case "type": $this->setType($val); break; case "10": case "expire": $this->setExpire($val); break; default: //Array index not supported. break; } } } /** * Returns an associative array mirroring this PClass. * * @return array */ public function toArray() { return array( 'eid' => $this->eid, 'id' => $this->id, 'description' => $this->description, 'months' => $this->months, 'startfee' => $this->startFee, 'invoicefee' => $this->invoiceFee, 'interestrate' => $this->interestRate, 'minamount' => $this->minAmount, 'country' => $this->country, 'type' => $this->type, 'expire' => $this->expire ); } /** * Sets the descriptiton, converts to HTML entities. * * @param string $description PClass description. * * @return void */ public function setDescription($description) { $this->description = $description; } /** * Sets the number of months. * * @param int $months Number of months. * * @return void */ public function setMonths($months) { $this->months = intval($months); } /** * Sets the starting fee. * * @param float $startFee Starting fee. * * @return void */ public function setStartFee($startFee) { $this->startFee = floatval($startFee); } /** * Sets the invoicing/handling fee. * * @param float $invoiceFee Invoicing fee. * * @return void */ public function setInvoiceFee($invoiceFee) { $this->invoiceFee = floatval($invoiceFee); } /** * Sets the interest rate. * * @param float $interestRate Interest rate. * * @return void */ public function setInterestRate($interestRate) { $this->interestRate = floatval($interestRate); } /** * Sets the Minimum amount to use this PClass. * * @param float $minAmount Minimum amount. * * @return void */ public function setMinAmount($minAmount) { $this->minAmount = floatval($minAmount); } /** * Sets the country for this PClass. * * @param int $country {@link KlarnaCountry} constant. * * @see KlarnaCountry * * @return void */ public function setCountry($country) { $this->country = intval($country); } /** * Sets the ID for this pclass. * * @param int $id PClass identifier. * * @return void */ public function setId($id) { $this->id = intval($id); } /** * Sets the type for this pclass. * * @param int $type PClass type identifier. * * @see self::CAMPAIGN * @see self::ACCOUNT * @see self::SPECIAL * @see self::FIXED * @see self::DELAY * @see self::MOBILE * * @return void */ public function setType($type) { $this->type = intval($type); } /** * Returns the ID for this PClass. * * @return int PClass identifier. */ public function getId() { return $this->id; } /** * Returns this PClass's type. * * @see self::CAMPAIGN * @see self::ACCOUNT * @see self::SPECIAL * @see self::FIXED * @see self::DELAY * @see self::MOBILE * * @return int PClass type identifier. */ public function getType() { return $this->type; } /** * Returns the Merchant ID or Estore ID connected to this PClass. * * @return int */ public function getEid() { return $this->eid; } /** * Merchant ID or Estore ID connected to this PClass. * * @param int $eid Merchant ID. * * @return void */ public function setEid($eid) { $this->eid = intval($eid); } /** * Checks whether this PClass is valid. * * @param int $now Unix timestamp * * @return bool */ public function isValid($now = null) { if ($this->expire == null || $this->expire == '-' || $this->expire <= 0 ) { //No expire, or unset? assume valid. return true; } if ($now === null || !is_numeric($now)) { $now = time(); } //If now is before expire, it is still valid. return ($now > $this->expire) ? false : true; } /** * Returns the valid until/expire date unix timestamp. * * @return int */ public function getExpire() { return $this->expire; } /** * Sets the valid until/expire date unix timestamp. * * @param int $expire unix timestamp for expire * * @return void */ public function setExpire($expire) { $this->expire = $expire; } /** * Returns the description for this PClass. * * Note:
* Encoded with HTML entities. * * @return string PClass description. */ public function getDescription() { return $this->description; } /** * Returns the number of months for this PClass. * * @return int Number of months. */ public function getMonths() { return $this->months; } /** * Returns the starting fee for this PClass. * * @return float Starting fee. */ public function getStartFee() { return $this->startFee; } /** * Returns the invoicing/handling fee for this PClass. * * @return float Invoicing fee. */ public function getInvoiceFee() { return $this->invoiceFee; } /** * Returns the interest rate for this PClass. * * @return float Interest rate. */ public function getInterestRate() { return $this->interestRate; } /** * Returns the minimum order/product amount for which this PClass is allowed. * * @return float Minimum amount to use this PClass. */ public function getMinAmount() { return $this->minAmount; } /** * Returns the country related to this PClass. * * @see KlarnaCountry * @return int {@link KlarnaCountry} constant. */ public function getCountry() { return $this->country; } } Currency.php 0000666 00000004104 15137552047 0007063 0 ustar 00 * @copyright 2012 Klarna AB (http://klarna.com) * @license http://opensource.org/licenses/BSD-2-Clause BSD-2 * @link http://integration.klarna.com/ */ /** * Currency Constants class * * @category Payment * @package KlarnaAPI * @author MS Dev
* ISO639_DA * * @var int */ const DA = 27; /** * Language constant for German (DE).
* ISO639_DE * * @var int */ const DE = 28; /** * Language constant for English (EN).
* ISO639_EN * * @var int */ const EN = 31; /** * Language constant for Finnish (FI).
* ISO639_FI * * @var int */ const FI = 37; /** * Language constant for Norwegian (NB).
* ISO639_NB * * @var int */ const NB = 97; /** * Language constant for Dutch (NL).
* ISO639_NL * * @var int */ const NL = 101; /** * Language constant for Swedish (SV).
* ISO639_SV * * @var int */ const SV = 138; /** * Converts a language code, e.g. 'de' to the KlarnaLanguage constant. * * @param string $val language code * * @return int|null */ public static function fromCode($val) { $val = strtoupper($val); if (array_key_exists($val, self::$_languages)) { return self::$_languages[$val]; } return null; } /** * Converts a KlarnaLanguage constant to the respective language code. * * @param int $val KlarnaLanguage constant * * @return lowercase string|null */ public static function getCode($val) { if (self::$_languageFlip === array()) { self::$_languageFlip = array_flip(self::$_languages); } if (array_key_exists($val, self::$_languageFlip)) { return strtolower(self::$_languageFlip[$val]); } return null; } /** * Cache for the flipped language array * * @var array */ private static $_languageFlip = array(); /** * Array containing all languages and their KRED Code * * @var array */ private static $_languages = array( 'AA' => 1, // Afar 'AB' => 2, // Abkhazian 'AE' => 3, // Avestan 'AF' => 4, // Afrikaans 'AM' => 5, // Amharic 'AR' => 6, // Arabic 'AS' => 7, // Assamese 'AY' => 8, // Aymara 'AZ' => 9, // Azerbaijani 'BA' => 10, // Bashkir 'BE' => 11, // Byelorussian; Belarusian 'BG' => 12, // Bulgarian 'BH' => 13, // Bihari 'BI' => 14, // Bislama 'BN' => 15, // Bengali; Bangla 'BO' => 16, // Tibetan 'BR' => 17, // Breton 'BS' => 18, // Bosnian 'CA' => 19, // Catalan 'CE' => 20, // Chechen 'CH' => 21, // Chamorro 'CO' => 22, // Corsican 'CS' => 23, // Czech 'CU' => 24, // Church Slavic 'CV' => 25, // Chuvash 'CY' => 26, // Welsh 'DA' => 27, // Danish 'DE' => 28, // German 'DZ' => 29, // Dzongkha; Bhutani 'EL' => 30, // Greek 'EN' => 31, // English 'EO' => 32, // Esperanto 'ES' => 33, // Spanish 'ET' => 34, // Estonian 'EU' => 35, // Basque 'FA' => 36, // Persian 'FI' => 37, // Finnish 'FJ' => 38, // Fijian; Fiji 'FO' => 39, // Faroese 'FR' => 40, // French 'FY' => 41, // Frisian 'GA' => 42, // Irish 'GD' => 43, // Scots; Gaelic 'GL' => 44, // Gallegan; Galician 'GN' => 45, // Guarani 'GU' => 46, // Gujarati 'GV' => 47, // Manx 'HA' => 48, // Hausa 'HE' => 49, // Hebrew (formerly iw) 'HI' => 50, // Hindi 'HO' => 51, // Hiri Motu 'HR' => 52, // Croatian 'HU' => 53, // Hungarian 'HY' => 54, // Armenian 'HZ' => 55, // Herero 'IA' => 56, // Interlingua 'ID' => 57, // Indonesian (formerly in) 'IE' => 58, // Interlingue 'IK' => 59, // Inupiak 'IO' => 60, // Ido 'IS' => 61, // Icelandic 'IT' => 62, // Italian 'IU' => 63, // Inuktitut 'JA' => 64, // Japanese 'JV' => 65, // Javanese 'KA' => 66, // Georgian 'KI' => 67, // Kikuyu 'KJ' => 68, // Kuanyama 'KK' => 69, // Kazakh 'KL' => 70, // Kalaallisut; Greenlandic 'KM' => 71, // Khmer; Cambodian 'KN' => 72, // Kannada 'KO' => 73, // Korean 'KS' => 74, // Kashmiri 'KU' => 75, // Kurdish 'KV' => 76, // Komi 'KW' => 77, // Cornish 'KY' => 78, // Kirghiz 'LA' => 79, // Latin 'LB' => 80, // Letzeburgesch 'LN' => 81, // Lingala 'LO' => 82, // Lao; Laotian 'LT' => 83, // Lithuanian 'LV' => 84, // Latvian; Lettish 'MG' => 85, // Malagasy 'MH' => 86, // Marshall 'MI' => 87, // Maori 'MK' => 88, // Macedonian 'ML' => 89, // Malayalam 'MN' => 90, // Mongolian 'MO' => 91, // Moldavian 'MR' => 92, // Marathi 'MS' => 93, // Malay 'MT' => 94, // Maltese 'MY' => 95, // Burmese 'NA' => 96, // Nauru 'NB' => 97, // Norwegian Bokmål 'ND' => 98, // Ndebele, North 'NE' => 99, // Nepali 'NG' => 100, // Ndonga 'NL' => 101, // Dutch 'NN' => 102, // Norwegian Nynorsk 'NO' => 103, // Norwegian 'NR' => 104, // Ndebele, South 'NV' => 105, // Navajo 'NY' => 106, // Chichewa; Nyanja 'OC' => 107, // Occitan; Provençal 'OM' => 108, // (Afan) Oromo 'OR' => 109, // Oriya 'OS' => 110, // Ossetian; Ossetic 'PA' => 111, // Panjabi; Punjabi 'PI' => 112, // Pali 'PL' => 113, // Polish 'PS' => 114, // Pashto, Pushto 'PT' => 115, // Portuguese 'QU' => 116, // Quechua 'RM' => 117, // Rhaeto-Romance 'RN' => 118, // Rundi; Kirundi 'RO' => 119, // Romanian 'RU' => 120, // Russian 'RW' => 121, // Kinyarwanda 'SA' => 122, // Sanskrit 'SC' => 123, // Sardinian 'SD' => 124, // Sindhi 'SE' => 125, // Northern Sami 'SG' => 126, // Sango; Sangro 'SI' => 127, // Sinhalese 'SK' => 128, // Slovak 'SL' => 129, // Slovenian 'SM' => 130, // Samoan 'SN' => 131, // Shona 'SO' => 132, // Somali 'SQ' => 133, // Albanian 'SR' => 134, // Serbian 'SS' => 135, // Swati; Siswati 'ST' => 136, // Sesotho; Sotho, Southern 'SU' => 137, // Sundanese 'SV' => 138, // Swedish 'SW' => 139, // Swahili 'TA' => 140, // Tamil 'TE' => 141, // Telugu 'TG' => 142, // Tajik 'TH' => 143, // Thai 'TI' => 144, // Tigrinya 'TK' => 145, // Turkmen 'TL' => 146, // Tagalog 'TN' => 147, // Tswana; Setswana 'TO' => 148, // Tongan 'TR' => 149, // Turkish 'TS' => 150, // Tsonga 'TT' => 151, // Tatar 'TW' => 152, // Twi 'TY' => 153, // Tahitian 'UG' => 154, // Uighur 'UK' => 155, // Ukrainian 'UR' => 156, // Urdu 'UZ' => 157, // Uzbek 'VI' => 158, // Vietnamese 'VO' => 159, // Volapuk 'WA' => 160, // Walloon 'WO' => 161, // Wolof 'XH' => 162, // Xhosa 'YI' => 163, // Yiddish (formerly ji) 'YO' => 164, // Yoruba 'ZA' => 165, // Zhuang 'ZH' => 166, // Chinese 'ZU' => 167 // Zulu ); } .htaccess 0000666 00000000177 15137552047 0006364 0 ustar 00
* In addition you need to decode HTML entities, if they exist.
* * For more information see our * {@link http://integration.klarna.com/en/api/step-by-step step by step} guide. * * Dependencies: * * xmlrpc-3.0.0.beta/lib/xmlrpc.inc * from {@link http://phpxmlrpc.sourceforge.net/} * * xmlrpc-3.0.0.beta/lib/xmlrpc_wrappers.inc * from {@link http://phpxmlrpc.sourceforge.net/} * * @category Payment * @package KlarnaAPI * @author MS Dev
* DO NOT SHARE THIS WITH ANYONE! * * @var string */ private $_secret; /** * KlarnaCountry constant. * * @see KlarnaCountry * * @var int */ private $_country; /** * KlarnaCurrency constant. * * @see KlarnaCurrency * * @var int */ private $_currency; /** * KlarnaLanguage constant. * * @see KlarnaLanguage * * @var int */ private $_language; /** * An array of articles for the current order. * * @var array */ protected $goodsList; /** * An array of article numbers and quantity. * * @var array */ protected $artNos; /** * An KlarnaAddr object containing the billing address. * * @var KlarnaAddr */ protected $billing; /** * An KlarnaAddr object containing the shipping address. * * @var KlarnaAddr */ protected $shipping; /** * Estore's user(name) or identifier. * Only used in {@link Klarna::addTransaction()}. * * @var string */ protected $estoreUser = ""; /** * External order numbers from other systems. * * @var string */ protected $orderid = array("", ""); /** * Reference (person) parameter. * * @var string */ protected $reference = ""; /** * Reference code parameter. * * @var string */ protected $reference_code = ""; /** * An array of named extra info. * * @var array */ protected $extraInfo = array(); /** * An array of named bank info. * * @var array */ protected $bankInfo = array(); /** * An array of named income expense info. * * @var array */ protected $incomeInfo = array(); /** * An array of named shipment info. * * @var array */ protected $shipInfo = array(); /** * An array of named travel info. * * @ignore Do not show this in PHPDoc. * @var array */ protected $travelInfo = array(); /** * An array of named activate info * * @ignore * @var array */ protected $activateInfo = array(); /** * An array of named session id's.
* E.g. "dev_id_1" => ...
* * @var array */ protected $sid = array(); /** * A comment sent in the XMLRPC communications. * This is resetted using clear(). * * @var string */ protected $comment = ""; /** * An array with all the checkoutHTML objects. * * @var array */ protected $coObjects = array(); /** * Flag to indicate if the API should output verbose * debugging information. * * @var bool */ public static $debug = false; /** * Turns on the internal XMLRPC debugging. * * @var bool */ public static $xmlrpcDebug = false; /** * If this is set to true, XMLRPC invocation is disabled. * * @var bool */ public static $disableXMLRPC = false; /** * If the estore is using a proxy which populates the clients IP to * x_forwarded_for * then and only then should this be set to true. * * Note:
* USE WITH CARE! * * @var bool */ public static $x_forwarded_for = false; /** * Array of HTML entities, used to create numeric htmlentities. * * @ignore Do not show this in PHPDoc. * @var array */ protected static $htmlentities = false; /** * Populated with possible proxy information. * A comma separated list of IP addresses. * * @var string */ private $_x_fwd; /** * The storage class for PClasses. * * Use 'xml' for xmlstorage.class.php.
* Use 'mysql' for mysqlstorage.class.php.
* Use 'json' for jsonstorage.class.php.
* * @var string */ protected $pcStorage; /** * The storage URI for PClasses. * * Use the absolute or relative URI to a file if * {@link Klarna::$pcStorage} is set as 'xml' or 'json'.
* Use a HTTP-auth similar URL if {@link Klarna::$pcStorage} is set * as 'mysql',
* e.g. user:passwd@addr:port/dbName.dbTable.
* Or an associative array (recommended) {@see MySQLStorage} * * @var mixed */ protected $pcURI; /** * PCStorage instance. * * @ignore Do not show this in PHPDoc. * @var PCStorage */ protected $pclasses; /** * ArrayAccess instance. * * @ignore Do not show this in PHPDoc. * @var ArrayAccess */ protected $config; /** * Empty constructor, because sometimes it's needed. */ public function __construct() { } /** * Checks if the config has fields described in argument.
* Missing field(s) is in the exception message. * * To check that the config has eid and secret:
*
* try {
* $this->hasFields('eid', 'secret');
* }
* catch(Exception $e) {
* echo "Missing fields: " . $e->getMessage();
* }
*
*
* @throws Exception
* @return void
*/
protected function hasFields(/*variable arguments*/)
{
$missingFields = array();
$args = func_get_args();
foreach ($args as $field) {
if (!isset($this->config[$field])) {
$missingFields[] = $field;
}
}
if (count($missingFields) > 0) {
throw new Klarna_ConfigFieldMissingException(
implode(', ', $missingFields)
);
}
}
/**
* Initializes the Klarna object accordingly to the set config object.
*
* @throws KlarnaException
* @return void
*/
protected function init()
{
$this->hasFields('eid', 'secret', 'mode', 'pcStorage', 'pcURI');
if (!is_int($this->config['eid'])) {
$this->config['eid'] = intval($this->config['eid']);
}
if ($this->config['eid'] <= 0) {
throw new Klarna_ConfigFieldMissingException('eid');
}
if (!is_string($this->config['secret'])) {
$this->config['secret'] = strval($this->config['secret']);
}
if (strlen($this->config['secret']) == 0) {
throw new Klarna_ConfigFieldMissingException('secret');
}
//Set the shop id and secret.
$this->_eid = $this->config['eid'];
$this->_secret = $this->config['secret'];
//Set the country specific attributes.
try {
$this->hasFields('country', 'language', 'currency');
//If hasFields doesn't throw exception we can set them all.
$this->setCountry($this->config['country']);
$this->setLanguage($this->config['language']);
$this->setCurrency($this->config['currency']);
} catch(Exception $e) {
//fields missing for country, language or currency
$this->_country = $this->_language = $this->_currency = null;
}
//Set addr and port according to mode.
$this->mode = (int)$this->config['mode'];
$this->_url = array();
// If a custom url has been added to the config, use that as xmlrpc
// recipient.
if (isset($this->config['url'])) {
$this->_url = parse_url($this->config['url']);
if ($this->_url === false) {
$message = "Configuration value 'url' could not be parsed. " .
"(Was: '{$this->config['url']}')";
Klarna::printDebug(__METHOD__, $message);
throw new InvalidArgumentException($message);
}
} else {
$this->_url['scheme'] = 'https';
if ($this->mode === self::LIVE) {
$this->_url['host'] = self::$_live_addr;
} else {
$this->_url['host'] = self::$_beta_addr;
}
if (isset($this->config['ssl'])
&& (bool)$this->config['ssl'] === false
) {
$this->_url['scheme'] = 'http';
}
}
// If no port has been specified, deduce from url scheme
if (!array_key_exists('port', $this->_url)) {
if ($this->_url['scheme'] === 'https') {
$this->_url['port'] = 443;
} else {
$this->_url['port'] = 80;
}
}
try {
$this->hasFields('candice');
self::$_candice = (bool)$this->config['candice'];
} catch(Exception $e) {
//No 'candice' field ignore it...
}
try {
$this->hasFields('xmlrpcDebug');
Klarna::$xmlrpcDebug = $this->config['xmlrpcDebug'];
} catch(Exception $e) {
//No 'xmlrpcDebug' field ignore it...
}
try {
$this->hasFields('debug');
Klarna::$debug = $this->config['debug'];
} catch(Exception $e) {
//No 'debug' field ignore it...
}
$this->pcStorage = $this->config['pcStorage'];
$this->pcURI = $this->config['pcURI'];
// Default path to '/' if not set.
if (!array_key_exists('path', $this->_url)) {
$this->_url['path'] = '/';
}
$this->xmlrpc = new xmlrpc_client(
$this->_url['path'],
$this->_url['host'],
$this->_url['port'],
$this->_url['scheme']
);
$this->xmlrpc->request_charset_encoding = 'ISO-8859-1';
}
/**
* Method of ease for setting common config fields.
*
* The storage module for PClasses:* Use 'xml' for xmlstorage.class.php.
* Use 'mysql' for mysqlstorage.class.php.
* Use 'json' for jsonstorage.class.php.
* * The storage URI for PClasses:
* Use the absolute or relative URI to a file if {@link Klarna::$pcStorage} * is set as 'xml' or 'json'.
* Use a HTTP-auth similar URL if {@link Klarna::$pcStorage} is set as * mysql', e.g. user:passwd@addr:port/dbName.dbTable. * Or an associative array (recommended) {@see MySQLStorage} * * Note:
* This disables the config file storage.
* * @param int $eid Merchant ID/EID * @param string $secret Secret key/Shared key * @param int $country {@link KlarnaCountry} * @param int $language {@link KlarnaLanguage} * @param int $currency {@link KlarnaCurrency} * @param int $mode {@link Klarna::LIVE} or {@link Klarna::BETA} * @param string $pcStorage PClass storage module. * @param string $pcURI PClass URI. * @param bool $ssl Whether HTTPS (HTTP over SSL) or HTTP is used. * @param bool $candice Error reporting to Klarna. * * @see Klarna::setConfig() * @see KlarnaConfig * * @throws KlarnaException * @return void */ public function config( $eid, $secret, $country, $language, $currency, $mode = Klarna::LIVE, $pcStorage = 'json', $pcURI = 'pclasses.json', $ssl = true, $candice = true ) { try { KlarnaConfig::$store = false; $this->config = new KlarnaConfig(null); $this->config['eid'] = $eid; $this->config['secret'] = $secret; $this->config['country'] = $country; $this->config['language'] = $language; $this->config['currency'] = $currency; $this->config['mode'] = $mode; $this->config['ssl'] = $ssl; $this->config['candice'] = $candice; $this->config['pcStorage'] = $pcStorage; $this->config['pcURI'] = $pcURI; $this->init(); } catch(Exception $e) { $this->config = null; throw new KlarnaException( $e->getMessage(), $e->getCode() ); } } /** * Sets and initializes this Klarna object using the supplied config object. * * @param KlarnaConfig &$config Config object. * * @see KlarnaConfig * @throws KlarnaException * @return void */ public function setConfig(&$config) { $this->_checkConfig($config); $this->config = $config; $this->init(); } /** * Get the complete locale (country, language, currency) to use for the * values passed, or the configured value if passing null. * * @param mixed $country country constant or code * @param mixed $language language constant or code * @param mixed $currency currency constant or code * * @throws KlarnaException * @return array */ public function getLocale( $country = null, $language = null, $currency = null ) { $locale = array( 'country' => null, 'language' => null, 'currency' => null ); if ($country === null) { // Use the configured country / language / currency $locale['country'] = $this->_country; if ($this->_language !== null) { $locale['language'] = $this->_language; } if ($this->_currency !== null) { $locale['currency'] = $this->_currency; } } else { // Use the given country / language / currency if (!is_numeric($country)) { $country = KlarnaCountry::fromCode($country); } $locale['country'] = intval($country); if ($language !== null) { if (!is_numeric($language)) { $language = KlarnaLanguage::fromCode($language); } $locale['language'] = intval($language); } if ($currency !== null) { if (!is_numeric($currency)) { $currency = KlarnaCurrency::fromCode($currency); } $locale['currency'] = intval($currency); } } // Complete partial structure with defaults if ($locale['currency'] === null) { $locale['currency'] = $this->getCurrencyForCountry( $locale['country'] ); } if ($locale['language'] === null) { $locale['language'] = $this->getLanguageForCountry( $locale['country'] ); } $this->_checkCountry($locale['country']); $this->_checkCurrency($locale['currency']); $this->_checkLanguage($locale['language']); return $locale; } /** * Sets the country used. * * Note:
* If you input 'dk', 'fi', 'de', 'nl', 'no' or 'se',
* then currency and language will be set to mirror that country.
* * @param string|int $country {@link KlarnaCountry} * * @see KlarnaCountry * * @throws KlarnaException * @return void */ public function setCountry($country) { if (!is_numeric($country) && (strlen($country) == 2 || strlen($country) == 3) ) { $country = KlarnaCountry::fromCode($country); } $this->_checkCountry($country); $this->_country = $country; } /** * Returns the country code for the set country constant. * * @param int $country {@link KlarnaCountry Country} constant. * * @return string Two letter code, e.g. "se", "no", etc. */ public function getCountryCode($country = null) { if ($country === null) { $country = $this->_country; } $code = KlarnaCountry::getCode($country); return (string) $code; } /** * Returns the {@link KlarnaCountry country} constant from the country code. * * @param string $code Two letter code, e.g. "se", "no", etc. * * @throws KlarnaException * @return int {@link KlarnaCountry Country} constant. */ public static function getCountryForCode($code) { $country = KlarnaCountry::fromCode($code); if ($country === null) { throw new Klarna_UnknownCountryException($code); } return $country; } /** * Returns the country constant. * * @return int {@link KlarnaCountry} */ public function getCountry() { return $this->_country; } /** * Sets the language used. * * Note:
* You can use the two letter language code instead of the constant.
* E.g. 'da' instead of using {@link KlarnaLanguage::DA}.
* * @param string|int $language {@link KlarnaLanguage} * * @see KlarnaLanguage * * @throws KlarnaException * @return void */ public function setLanguage($language) { if (!is_numeric($language) && strlen($language) == 2) { $this->setLanguage(self::getLanguageForCode($language)); } else { $this->_checkLanguage($language); $this->_language = $language; } } /** * Returns the language code for the set language constant. * * @param int $language {@link KlarnaLanguage Language} constant. * * @return string Two letter code, e.g. "da", "de", etc. */ public function getLanguageCode($language = null) { if ($language === null) { $language = $this->_language; } $code = KlarnaLanguage::getCode($language); return (string) $code; } /** * Returns the {@link KlarnaLanguage language} constant from the language code. * * @param string $code Two letter code, e.g. "da", "de", etc. * * @throws KlarnaException * @return int {@link KlarnaLanguage Language} constant. */ public static function getLanguageForCode($code) { $language = KlarnaLanguage::fromCode($code); if ($language === null) { throw new Klarna_UnknownLanguageException($code); } return $language; } /** * Returns the language constant. * * @return int {@link KlarnaLanguage} */ public function getLanguage() { return $this->_language; } /** * Sets the currency used. * * Note:
* You can use the three letter shortening of the currency.
* E.g. "dkk", "eur", "nok" or "sek" instead of the constant.
* * @param string|int $currency {@link KlarnaCurrency} * * @see KlarnaCurrency * * @throws KlarnaException * @return void */ public function setCurrency($currency) { if (!is_numeric($currency) && strlen($currency) == 3) { $this->setCurrency(self::getCurrencyForCode($currency)); } else { $this->_checkCurrency($currency); $this->_currency = $currency; } } /** * Returns the {@link KlarnaCurrency currency} constant from the currency * code. * * @param string $code Two letter code, e.g. "dkk", "eur", etc. * * @throws KlarnaException * @return int {@link KlarnaCurrency Currency} constant. */ public static function getCurrencyForCode($code) { $currency = KlarnaCurrency::fromCode($code); if ($currency === null) { throw new Klarna_UnknownCurrencyException($code); } return $currency; } /** * Returns the the currency code for the set currency constant. * * @param int $currency {@link KlarnaCurrency Currency} constant. * * @return string Three letter currency code. */ public function getCurrencyCode($currency = null) { if ($currency === null) { $currency = $this->_currency; } $code = KlarnaCurrency::getCode($currency); return (string) $code; } /** * Returns the set currency constant. * * @return int {@link KlarnaCurrency} */ public function getCurrency() { return $this->_currency; } /** * Returns the {@link KlarnaLanguage language} constant for the specified * or set country. * * @param int $country {@link KlarnaCountry Country} constant. * * @deprecated Do not use. * * @return int|false if no match otherwise KlarnaLanguage constant. */ public function getLanguageForCountry($country = null) { if ($country === null) { $country = $this->_country; } // Since getLanguage defaults to EN, check so we actually have a match $language = KlarnaCountry::getLanguage($country); if (KlarnaCountry::checkLanguage($country, $language)) { return $language; } return false; } /** * Returns the {@link KlarnaCurrency currency} constant for the specified * or set country. * * @param int $country {@link KlarnaCountry country} constant. * * @deprecated Do not use. * * @return int|false {@link KlarnaCurrency currency} constant. */ public function getCurrencyForCountry($country = null) { if ($country === null) { $country = $this->_country; } return KlarnaCountry::getCurrency($country); } /** * Sets the session id's for various device identification, * behaviour identification software. * * Available named session id's:
* string - dev_id_1
* string - dev_id_2
* string - dev_id_3
* string - beh_id_1
* string - beh_id_2
* string - beh_id_3
* * @param string $name Session ID identifier, e.g. 'dev_id_1'. * @param string $sid Session ID. * * @throws KlarnaException * @return void */ public function setSessionID($name, $sid) { $this->_checkArgument($name, "name"); $this->_checkArgument($sid, "sid"); $this->sid[$name] = $sid; } /** * Sets the shipment information for the upcoming transaction.
* * Using this method is optional. * * Available named values are:
* int - delay_adjust
* string - shipping_company
* string - shipping_product
* string - tracking_no
* array - warehouse_addr
* * "warehouse_addr" is sent using {@link KlarnaAddr::toArray()}. * * Make sure you send in the values as the right data type.
* Use strval, intval or similar methods to ensure the right type is sent. * * @param string $name key * @param mixed $value value * * @throws KlarnaException * @return void */ public function setShipmentInfo($name, $value) { $this->_checkArgument($name, "name"); $this->shipInfo[$name] = $value; } /** * Sets the Activation information for the upcoming transaction.
* * Using this method is optional. * * Available named values are:
* int - flags
* int - bclass
* string - orderid1
* string - orderid2
* string - ocr
* string - reference
* string - reference_code
* string - cust_no
* * Make sure you send in the values as the right data type.
* Use strval, intval or similar methods to ensure the right type is sent. * * @param string $name key * @param mixed $value value * * @see setShipmentInfo * * @return void */ public function setActivateInfo($name, $value) { $this->activateInfo[$name] = $value; } /** * Sets the extra information for the upcoming transaction.
* * Using this method is optional. * * Available named values are:
* string - cust_no
* string - estore_user
* string - maiden_name
* string - place_of_birth
* string - password
* string - new_password
* string - captcha
* int - poa_group
* string - poa_pno
* string - ready_date
* string - rand_string
* int - bclass
* string - pin
* * Make sure you send in the values as the right data type.
* Use strval, intval or similar methods to ensure the right type is sent. * * @param string $name key * @param mixed $value value * * @throws KlarnaException * @return void */ public function setExtraInfo($name, $value) { $this->_checkArgument($name, "name"); $this->extraInfo[$name] = $value; } /** * Sets the income expense information for the upcoming transaction.
* * Using this method is optional. * * Available named values are:
* int - yearly_salary
* int - no_people_in_household
* int - no_children_below_18
* int - net_monthly_household_income
* int - monthly_cost_accommodation
* int - monthly_cost_other_loans
* * Make sure you send in the values as the right data type.
* Use strval, intval or similar methods to ensure the right type is sent. * * @param string $name key * @param mixed $value value * * @throws KlarnaException * @return void */ public function setIncomeInfo($name, $value) { $this->_checkArgument($name, "name"); $this->incomeInfo[$name] = $value; } /** * Sets the bank information for the upcoming transaction.
* * Using this method is optional. * * Available named values are:
* int - bank_acc_bic
* int - bank_acc_no
* int - bank_acc_pin
* int - bank_acc_tan
* string - bank_name
* string - bank_city
* string - iban
* * Make sure you send in the values as the right data type.
* Use strval, intval or similar methods to ensure the right type is sent. * * @param string $name key * @param mixed $value value * * @throws KlarnaException * @return void */ public function setBankInfo($name, $value) { $this->_checkArgument($name, "name"); $this->bankInfo[$name] = $value; } /** * Sets the travel information for the upcoming transaction.
* * Using this method is optional. * * Available named values are:
* string - travel_company
* string - reseller_company
* string - departure_date
* string - return_date
* array - destinations
* array - passenger_list
* array - passport_no
* array - driver_license_no
* * Make sure you send in the values as the right data type.
* Use strval, intval or similar methods to ensure the right type is sent. * * @param string $name key * @param mixed $value value * * @throws KlarnaException * @return void */ public function setTravelInfo($name, $value) { $this->_checkArgument($name, "name"); $this->travelInfo[$name] = $value; } /** * Returns the clients IP address. * * @return string */ public function getClientIP() { $tmp_ip = ''; $x_fwd = null; //Proxy handling. if (array_key_exists('REMOTE_ADDR', $_SERVER)) { $tmp_ip = $_SERVER['REMOTE_ADDR']; } if (isset($_SERVER["HTTP_X_FORWARDED_FOR"])) { $x_fwd = $_SERVER["HTTP_X_FORWARDED_FOR"]; } if (self::$x_forwarded_for && ($x_fwd !== null)) { $forwarded = explode(",", $x_fwd); return trim($forwarded[0]); } return $tmp_ip; } /** * Sets the specified address for the current order. * * Address type can be:
* {@link KlarnaFlags::IS_SHIPPING}
* {@link KlarnaFlags::IS_BILLING}
* * @param int $type Address type. * @param KlarnaAddr $addr Specified address. * * @throws KlarnaException * @return void */ public function setAddress($type, $addr) { if (!($addr instanceof KlarnaAddr)) { throw new Klarna_InvalidKlarnaAddrException; } if ($addr->isCompany === null) { $addr->isCompany = false; } if ($type === KlarnaFlags::IS_SHIPPING) { $this->shipping = $addr; self::printDebug("shipping address array", $this->shipping); return; } if ($type === KlarnaFlags::IS_BILLING) { $this->billing = $addr; self::printDebug("billing address array", $this->billing); return; } throw new Klarna_UnknownAddressTypeException($type); } /** * Sets order id's from other systems for the upcoming transaction.
* User is only sent with {@link Klarna::addTransaction()}.
* * @param string $orderid1 order id 1 * @param string $orderid2 order id 2 * @param string $user username * * @see Klarna::setExtraInfo() * * @throws KlarnaException * @return void */ public function setEstoreInfo($orderid1 = "", $orderid2 = "", $user = "") { if (!is_string($orderid1)) { $orderid1 = strval($orderid1); } if (!is_string($orderid2)) { $orderid2 = strval($orderid2); } if (!is_string($user)) { $user = strval($user); } if (strlen($user) > 0 ) { $this->setExtraInfo('estore_user', $user); } $this->orderid[0] = $orderid1; $this->orderid[1] = $orderid2; } /** * Sets the reference (person) and reference code, for the upcoming * transaction. * * If this is omitted, it can grab first name, last name from the address * and use that as a reference person. * * @param string $ref Reference person / message to customer on invoice. * @param string $code Reference code / message to customer on invoice. * * @return void */ public function setReference($ref, $code) { $this->_checkRef($ref, $code); $this->reference = $ref; $this->reference_code = $code; } /** * Returns the reference (person). * * @return string */ public function getReference() { return $this->reference; } /** * Returns an associative array used to send the address to Klarna. * TODO: Kill it all * * @param KlarnaAddr $addr Address object to assemble. * * @throws KlarnaException * @return array The address for the specified method. */ protected function assembleAddr($addr) { if (!($addr instanceof KlarnaAddr)) { throw new Klarna_InvalidKlarnaAddrException; } return $addr->toArray(); } /** * Sets the comment field, which can be shown in the invoice. * * @param string $data comment to set * * @return void */ public function setComment($data) { $this->comment = $data; } /** * Adds an additional comment to the comment field. Appends with a newline. * * @param string $data comment to add * * @see Klarna::setComment() * * @return void */ public function addComment($data) { $this->comment .= "\n".$data; } /** * Returns the PNO/SSN encoding constant for currently set country. * * Note:
* Country, language and currency needs to match! * * @throws KlarnaException * @return int {@link KlarnaEncoding} constant. */ public function getPNOEncoding() { $this->_checkLocale(); $country = KlarnaCountry::getCode($this->_country); return KlarnaEncoding::get($country); } /** * Purpose: The get_addresses function is used to retrieve a customer's * address(es). Using this, the customer is not required to enter any * information, only confirm the one presented to him/her.
* * The get_addresses function can also be used for companies.
* If the customer enters a company number, it will return all the * addresses where the company is registered at.
* * The get_addresses function is ONLY allowed to be used for Swedish * persons with the following conditions: *
-
*
- * It can be only used if invoice or part payment is * the default payment method * *
- * It has to disappear if the customer chooses another * payment method * *
-
* The button is not allowed to be called "get address", but
* "continue" or
* it can be picked up automatically when all the numbers have * been typed. *
*
* {@link KlarnaFlags::GA_ALL},
* {@link KlarnaFlags::GA_LAST},
* {@link KlarnaFlags::GA_GIVEN}.
* * @param string $pno Social security number, personal number, ... * @param int $encoding {@link KlarnaEncoding PNO Encoding} constant. * @param int $type Specifies returned information. * * @link http://integration.klarna.com/en/api/standard-integration/functions * /getaddresses * @throws KlarnaException * @return array An array of {@link KlarnaAddr} objects. */ public function getAddresses( $pno, $encoding = null, $type = KlarnaFlags::GA_GIVEN ) { if ($this->_country !== KlarnaCountry::SE) { throw new Klarna_UnsupportedMarketException("Sweden"); } //Get the PNO/SSN encoding constant. if ($encoding === null) { $encoding = $this->getPNOEncoding(); } $this->_checkPNO($pno, $encoding); $digestSecret = self::digest( $this->colon( $this->_eid, $pno, $this->_secret ) ); $paramList = array( $pno, $this->_eid, $digestSecret, $encoding, $type, $this->getClientIP() ); self::printDebug("get_addresses array", $paramList); $result = $this->xmlrpc_call('get_addresses', $paramList); self::printDebug("get_addresses result array", $result); $addrs = array(); foreach ($result as $tmpAddr) { try { $addr = new KlarnaAddr(); if ($type === KlarnaFlags::GA_GIVEN) { $addr->isCompany = (count($tmpAddr) == 5) ? true : false; if ($addr->isCompany) { $addr->setCompanyName($tmpAddr[0]); $addr->setStreet($tmpAddr[1]); $addr->setZipCode($tmpAddr[2]); $addr->setCity($tmpAddr[3]); $addr->setCountry($tmpAddr[4]); } else { $addr->setFirstName($tmpAddr[0]); $addr->setLastName($tmpAddr[1]); $addr->setStreet($tmpAddr[2]); $addr->setZipCode($tmpAddr[3]); $addr->setCity($tmpAddr[4]); $addr->setCountry($tmpAddr[5]); } } else if ($type === KlarnaFlags::GA_LAST) { // Here we cannot decide if it is a company or not? // Assume private person. $addr->setLastName($tmpAddr[0]); $addr->setStreet($tmpAddr[1]); $addr->setZipCode($tmpAddr[2]); $addr->setCity($tmpAddr[3]); $addr->setCountry($tmpAddr[4]); } else if ($type === KlarnaFlags::GA_ALL) { if (strlen($tmpAddr[0]) > 0) { $addr->setFirstName($tmpAddr[0]); $addr->setLastName($tmpAddr[1]); } else { $addr->isCompany = true; $addr->setCompanyName($tmpAddr[1]); } $addr->setStreet($tmpAddr[2]); $addr->setZipCode($tmpAddr[3]); $addr->setCity($tmpAddr[4]); $addr->setCountry($tmpAddr[5]); } else { continue; } $addrs[] = $addr; } catch(Exception $e) { //Silently fail } } return $addrs; } /** * Adds an article to the current goods list for the current order. * * Note:
* It is recommended that you use {@link KlarnaFlags::INC_VAT}.
* * Flags can be:
* {@link KlarnaFlags::INC_VAT}
* {@link KlarnaFlags::IS_SHIPMENT}
* {@link KlarnaFlags::IS_HANDLING}
* {@link KlarnaFlags::PRINT_1000}
* {@link KlarnaFlags::PRINT_100}
* {@link KlarnaFlags::PRINT_10}
* {@link KlarnaFlags::NO_FLAG}
* * Some flags can be added to each other for multiple options. * * @param int $qty Quantity. * @param string $artNo Article number. * @param string $title Article title. * @param int $price Article price. * @param float $vat VAT in percent, e.g. 25% is inputted as 25. * @param float $discount Possible discount on article. * @param int $flags Options which specify the article * ({@link KlarnaFlags::IS_HANDLING}) and it's price * ({@link KlarnaFlags::INC_VAT}) * * @see Klarna::addTransaction() * @see Klarna::reserveAmount() * @see Klarna::activateReservation() * * @throws KlarnaException * @return void */ public function addArticle( $qty, $artNo, $title, $price, $vat, $discount = 0, $flags = KlarnaFlags::INC_VAT ) { $this->_checkQty($qty); // Either artno or title has to be set if ((($artNo === null ) || ($artNo == "")) && (($title === null ) || ($title == "")) ) { throw new Klarna_ArgumentNotSetException('Title and ArtNo', 50026); } $this->_checkPrice($price); $this->_checkVAT($vat); $this->_checkDiscount($discount); $this->_checkInt($flags, 'flags'); //Create goodsList array if not set. if (!$this->goodsList || !is_array($this->goodsList)) { $this->goodsList = array(); } //Populate a temp array with the article details. $tmpArr = array( "artno" => $artNo, "title" => $title, "price" => $price, "vat" => $vat, "discount" => $discount, "flags" => $flags ); //Add the temp array and quantity field to the internal goods list. $this->goodsList[] = array( "goods" => $tmpArr, "qty" => $qty ); if (count($this->goodsList) > 0) { self::printDebug( "article added", $this->goodsList[count($this->goodsList)-1] ); } } /** * Assembles and sends the current order to Klarna.
* This clears all relevant data if $clear is set to true.
* * This method returns an array with:
* Invoice number
* Order status flag
* * If the flag {@link KlarnaFlags::RETURN_OCR} is used:
* Invoice number
* OCR number
* Order status flag
* * Order status can be:
* {@link KlarnaFlags::ACCEPTED}
* {@link KlarnaFlags::PENDING}
* {@link KlarnaFlags::DENIED}
* * Gender is only required for Germany and Netherlands.
* * Flags can be:
* {@link KlarnaFlags::NO_FLAG}
* {@link KlarnaFlags::TEST_MODE}
* {@link KlarnaFlags::AUTO_ACTIVATE}
* {@link KlarnaFlags::SENSITIVE_ORDER}
* {@link KlarnaFlags::RETURN_OCR}
* {@link KlarnaFlags::M_PHONE_TRANSACTION}
* {@link KlarnaFlags::M_SEND_PHONE_PIN}
* * Some flags can be added to each other for multiple options. * * Note:
* Normal shipment type is assumed unless otherwise specified, * ou can do this by calling:
* {@link Klarna::setShipmentInfo() setShipmentInfo('delay_adjust', ...)} * with either:
* {@link KlarnaFlags::NORMAL_SHIPMENT NORMAL_SHIPMENT} or * {@link KlarnaFlags::EXPRESS_SHIPMENT EXPRESS_SHIPMENT}
* * @param string $pno Personal number, SSN, date of birth, etc. * @param int $gender {@link KlarnaFlags::FEMALE} or * {@link KlarnaFlags::MALE}, * null or "" for unspecified. * @param int $flags Options which affect the behaviour. * @param int $pclass PClass id used for this invoice. * @param int $encoding {@link KlarnaEncoding Encoding} constant for the * PNO parameter. * @param bool $clear Whether customer info should be cleared after * this call or not. * * @link http://integration.klarna.com/en/api/standard-integration/functions/ * addtransaction * * @throws KlarnaException * @return array An array with invoice number and order status. [string, int] */ public function addTransaction( $pno, $gender, $flags = KlarnaFlags::NO_FLAG, $pclass = KlarnaPClass::INVOICE, $encoding = null, $clear = true ) { $this->_checkLocale(50023); //Get the PNO/SSN encoding constant. if ($encoding === null) { $encoding = $this->getPNOEncoding(); } if (!($flags & KlarnaFlags::PRE_PAY)) { $this->_checkPNO($pno, $encoding); } if ($gender === 'm') { $gender = KlarnaFlags::MALE; } else if ($gender === 'f') { $gender = KlarnaFlags::FEMALE; } if ($gender !== null && strlen($gender) > 0) { $this->_checkInt($gender, 'gender'); } $this->_checkInt($flags, 'flags'); $this->_checkInt($pclass, 'pclass'); //Check so required information is set. $this->_checkGoodslist(); //We need at least one address set if (!($this->billing instanceof KlarnaAddr) && !($this->shipping instanceof KlarnaAddr) ) { throw new Klarna_MissingAddressException; } //If only one address is set, copy to the other address. if (!($this->shipping instanceof KlarnaAddr) && ($this->billing instanceof KlarnaAddr) ) { $this->shipping = $this->billing; } else if (!($this->billing instanceof KlarnaAddr) && ($this->shipping instanceof KlarnaAddr) ) { $this->billing = $this->shipping; } //Assume normal shipment unless otherwise specified. if (!isset($this->shipInfo['delay_adjust'])) { $this->setShipmentInfo('delay_adjust', KlarnaFlags::NORMAL_SHIPMENT); } //Make sure we get any session ID's or similar $this->initCheckout(); //function add_transaction_digest $string = ""; foreach ($this->goodsList as $goods) { $string .= $goods['goods']['title'] .':'; } $digestSecret = self::digest($string . $this->_secret); //end function add_transaction_digest $billing = $this->assembleAddr($this->billing); $shipping = $this->assembleAddr($this->shipping); //Shipping country must match specified country! if (strlen($shipping['country']) > 0 && ($shipping['country'] !== $this->_country) ) { throw new Klarna_ShippingCountryException; } $paramList = array( $pno, $gender, $this->reference, $this->reference_code, $this->orderid[0], $this->orderid[1], $shipping, $billing, $this->getClientIP(), $flags, $this->_currency, $this->_country, $this->_language, $this->_eid, $digestSecret, $encoding, $pclass, $this->goodsList, $this->comment, $this->shipInfo, $this->travelInfo, $this->incomeInfo, $this->bankInfo, $this->sid, $this->extraInfo ); self::printDebug('add_invoice', $paramList); $result = $this->xmlrpc_call('add_invoice', $paramList); if ($clear === true) { //Make sure any stored values that need to be unique between //purchases are cleared. foreach ($this->coObjects as $co) { $co->clear(); } $this->clear(); } self::printDebug('add_invoice result', $result); return $result; } /** * Activates previously created invoice * (from {@link Klarna::addTransaction()}). * * Note:
* If you want to change the shipment type, you can specify it using: * {@link Klarna::setShipmentInfo() setShipmentInfo('delay_adjust', ...)} * with either: {@link KlarnaFlags::NORMAL_SHIPMENT NORMAL_SHIPMENT} or * {@link KlarnaFlags::EXPRESS_SHIPMENT EXPRESS_SHIPMENT} * * @param string $invNo Invoice number. * @param int $pclass PClass id used for this invoice. * @param bool $clear Whether customer info should be cleared after this * call. * * @see Klarna::setShipmentInfo() * @link http://integration.klarna.com/en/api/standard-integration/functions * /activateinvoice * * @throws KlarnaException * @return string An URL to the PDF invoice. */ public function activateInvoice( $invNo, $pclass = KlarnaPClass::INVOICE, $clear = true ) { $this->_checkInvNo($invNo); $digestSecret = self::digest( $this->colon($this->_eid, $invNo, $this->_secret) ); $paramList = array( $this->_eid, $invNo, $digestSecret, $pclass, $this->shipInfo ); self::printDebug('activate_invoice', $paramList); $result = $this->xmlrpc_call('activate_invoice', $paramList); if ($clear === true) { $this->clear(); } self::printDebug('activate_invoice result', $result); return $result; } /** * Removes a passive invoices which has previously been created with * {@link Klarna::addTransaction()}. * True is returned if the invoice was successfully removed, otherwise an * exception is thrown.
* * @param string $invNo Invoice number. * * @throws KlarnaException * @return bool */ public function deleteInvoice($invNo) { $this->_checkInvNo($invNo); $digestSecret = self::digest( $this->colon($this->_eid, $invNo, $this->_secret) ); $paramList = array( $this->_eid, $invNo, $digestSecret ); self::printDebug('delete_invoice', $paramList); $result = $this->xmlrpc_call('delete_invoice', $paramList); return ($result == 'ok') ? true : false; } /** * Summarizes the prices of the held goods list * * @return int total amount */ public function summarizeGoodsList() { $amount = 0; if (!is_array($this->goodsList)) { return $amount; } foreach ($this->goodsList as $goods) { $price = $goods['goods']['price']; // Add VAT if price is Excluding VAT if (($goods['goods']['flags'] & KlarnaFlags::INC_VAT) === 0) { $vat = $goods['goods']['vat'] / 100.0; $price *= (1.0 + $vat); } // Reduce discounts if ($goods['goods']['discount'] > 0) { $discount = $goods['goods']['discount'] / 100.0; $price *= (1.0 - $discount); } $amount += $price * (int)$goods['qty']; } return $amount; } /** * Reserves a purchase amount for a specific customer.
* The reservation is valid, by default, for 7 days.
* * This method returns an array with:
* A reservation number (rno)
* Order status flag
* * Order status can be:
* {@link KlarnaFlags::ACCEPTED}
* {@link KlarnaFlags::PENDING}
* {@link KlarnaFlags::DENIED}
* * Please note:
* Activation must be done with activate_reservation, i.e. you cannot * activate through Klarna Online. * * Gender is only required for Germany and Netherlands.
* * Flags can be set to:
* {@link KlarnaFlags::NO_FLAG}
* {@link KlarnaFlags::TEST_MODE}
* {@link KlarnaFlags::RSRV_SENSITIVE_ORDER}
* {@link KlarnaFlags::RSRV_PHONE_TRANSACTION}
* {@link KlarnaFlags::RSRV_SEND_PHONE_PIN}
* * Some flags can be added to each other for multiple options. * * Note:
* Normal shipment type is assumed unless otherwise specified, you can do * this by calling:
* {@link Klarna::setShipmentInfo() setShipmentInfo('delay_adjust', ...)} * with either: {@link KlarnaFlags::NORMAL_SHIPMENT NORMAL_SHIPMENT} or * {@link KlarnaFlags::EXPRESS_SHIPMENT EXPRESS_SHIPMENT}
* * @param string $pno Personal number, SSN, date of birth, etc. * @param int $gender {@link KlarnaFlags::FEMALE} or * {@link KlarnaFlags::MALE}, null for unspecified. * @param int $amount Amount to be reserved, including VAT. * @param int $flags Options which affect the behaviour. * @param int $pclass {@link KlarnaPClass::getId() PClass ID}. * @param int $encoding {@link KlarnaEncoding PNO Encoding} constant. * @param bool $clear Whether customer info should be cleared after * this call. * * @link http://integration.klarna.com/en/api/advanced-integration * /functions/reserveamount * * @throws KlarnaException * @return array An array with reservation number and order * status. [string, int] */ public function reserveAmount( $pno, $gender, $amount, $flags = 0, $pclass = KlarnaPClass::INVOICE, $encoding = null, $clear = true ) { $this->_checkLocale(); //Get the PNO/SSN encoding constant. if ($encoding === null) { $encoding = $this->getPNOEncoding(); } $this->_checkPNO($pno, $encoding); if ($gender === 'm') { $gender = KlarnaFlags::MALE; } else if ($gender === 'f') { $gender = KlarnaFlags::FEMALE; } if ($gender !== null && strlen($gender) > 0) { $this->_checkInt($gender, 'gender'); } $this->_checkInt($flags, 'flags'); $this->_checkInt($pclass, 'pclass'); //Check so required information is set. $this->_checkGoodslist(); //Calculate automatically the amount from goodsList. if ($amount === -1) { $amount = (int)round($this->summarizeGoodsList()); } else { $this->_checkAmount($amount); } if ($amount < 0) { throw new Klarna_InvalidPriceException($amount); } //No addresses used for phone transactions if ($flags & KlarnaFlags::RSRV_PHONE_TRANSACTION) { $billing = $shipping = ''; } else { $billing = $this->assembleAddr($this->billing); $shipping = $this->assembleAddr($this->shipping); if (strlen($shipping['country']) > 0 && ($shipping['country'] !== $this->_country) ) { throw new Klarna_ShippingCountryException; } } //Assume normal shipment unless otherwise specified. if (!isset($this->shipInfo['delay_adjust'])) { $this->setShipmentInfo('delay_adjust', KlarnaFlags::NORMAL_SHIPMENT); } //Make sure we get any session ID's or similar $this->initCheckout($this, $this->_eid); $digestSecret = self::digest( "{$this->_eid}:{$pno}:{$amount}:{$this->_secret}" ); $paramList = array( $pno, $gender, $amount, $this->reference, $this->reference_code, $this->orderid[0], $this->orderid[1], $shipping, $billing, $this->getClientIP(), $flags, $this->_currency, $this->_country, $this->_language, $this->_eid, $digestSecret, $encoding, $pclass, $this->goodsList, $this->comment, $this->shipInfo, $this->travelInfo, $this->incomeInfo, $this->bankInfo, $this->sid, $this->extraInfo ); self::printDebug('reserve_amount', $paramList); $result = $this->xmlrpc_call('reserve_amount', $paramList); if ($clear === true) { //Make sure any stored values that need to be unique between //purchases are cleared. foreach ($this->coObjects as $co) { $co->clear(); } $this->clear(); } self::printDebug('reserve_amount result', $result); return $result; } /** * Cancels a reservation. * * @param string $rno Reservation number. * * @link http://integration.klarna.com/en/api/advanced-integration/functions * /cancelreservation * * @throws KlarnaException * @return bool True, if the cancellation was successful. */ public function cancelReservation($rno) { $this->_checkRNO($rno); $digestSecret = self::digest( $this->colon($this->_eid, $rno, $this->_secret) ); $paramList = array( $rno, $this->_eid, $digestSecret ); self::printDebug('cancel_reservation', $paramList); $result = $this->xmlrpc_call('cancel_reservation', $paramList); return ($result == 'ok'); } /** * Changes specified reservation to a new amount. * * Flags can be either of these:
* {@link KlarnaFlags::NEW_AMOUNT}
* {@link KlarnaFlags::ADD_AMOUNT}
* * @param string $rno Reservation number. * @param int $amount Amount including VAT. * @param int $flags Options which affect the behaviour. * * @link http://integration.klarna.com/en/api/advanced-integration/functions * /changereservation * * @throws KlarnaException * @return bool True, if the change was successful. */ public function changeReservation( $rno, $amount, $flags = KlarnaFlags::NEW_AMOUNT ) { $this->_checkRNO($rno); $this->_checkAmount($amount); $this->_checkInt($flags, 'flags'); $digestSecret = self::digest( $this->colon($this->_eid, $rno, $amount, $this->_secret) ); $paramList = array( $rno, $amount, $this->_eid, $digestSecret, $flags ); self::printDebug('change_reservation', $paramList); $result = $this->xmlrpc_call('change_reservation', $paramList); return ($result == 'ok') ? true : false; } /** * Update the reservation matching the given reservation number. * * @param string $rno Reservation number * @param boolean $clear clear set data aftre updating. Defaulted to true. * * @throws KlarnaException if no RNO is given, or if an error is recieved * from Klarna Online. * * @return true if the update was successful */ public function update($rno, $clear = true) { $rno = strval($rno); // All info that is sent in is part of the digest secret, in this order: // [ // proto_vsn, client_vsn, eid, rno, careof, street, zip, city, // country, fname, lname, careof, street, zip, city, country, // fname, lname, artno, qty, orderid1, orderid2 // ]. // The address part appears twice, that is one per address that // changes. If no value is sent in for an optional field, there // is no entry for this field in the digest secret. Shared secret // is added at the end of the digest secret. $digestArray = array( str_replace('.', ':', $this->PROTO), $this->VERSION, $this->_eid, $rno ); $digestArray = array_merge( $digestArray, $this->_addressDigestPart($this->shipping) ); $digestArray = array_merge( $digestArray, $this->_addressDigestPart($this->billing) ); if (is_array($this->goodsList) && $this->goodsList !== array()) { foreach ($this->goodsList as $goods) { if (strlen($goods["goods"]["artno"]) > 0) { $digestArray[] = $goods["goods"]["artno"]; } else { $digestArray[] = $goods["goods"]["title"]; } $digestArray[] = $goods["qty"]; } } foreach ($this->orderid as $orderid) { $digestArray[] = $orderid; } $digestArray[] = $this->_secret; $digestSecret = $this->digest( call_user_func_array( array('self', 'colon'), $digestArray ) ); $shipping = array(); $billing = array(); if ($this->shipping !== null && $this->shipping instanceof KlarnaAddr) { $shipping = $this->shipping->toArray(); } if ($this->billing !== null && $this->billing instanceof KlarnaAddr) { $billing = $this->billing->toArray(); } $paramList = array( $this->_eid, $digestSecret, $rno, array( 'goods_list' => $this->goodsList, 'dlv_addr' => $shipping, 'bill_addr' => $billing, 'orderid1' => $this->orderid[0], 'orderid2' => $this->orderid[1] ) ); self::printDebug('update array', $paramList); $result = $this->xmlrpc_call('update', $paramList); self::printDebug('update result', $result); return ($result === 'ok'); } /** * Help function to sort the address for update digest. * * @param KlarnaAddr|null $address KlarnaAddr object or null * * @return array */ private function _addressDigestPart(KlarnaAddr $address = null) { if ($address === null) { return array(); } $keyOrder = array( 'careof', 'street', 'zip', 'city', 'country', 'fname', 'lname' ); $holder = $address->toArray(); $digest = array(); foreach ($keyOrder as $key) { if ($holder[$key] != "") { $digest[] = $holder[$key]; } } return $digest; } /** * Activate the reservation matching the given reservation number. * Optional information should be set in ActivateInfo. * * To perform a partial activation, use the addArtNo function to specify * which items in the reservation to include in the activation. * * @param string $rno Reservation number * @param string $ocr optional OCR number to attach to the reservation when * activating. Overrides OCR specified in activateInfo. * @param string $flags optional flags to affect behavior. If specified it * will overwrite any flag set in activateInfo. * @param boolean $clear clear set data after activating. Defaulted to true. * * @throws KlarnaException when the RNO is not specified, or if an error * is recieved from Klarna Online. * @return A string array with risk status and reservation number. */ public function activate( $rno, $ocr = null, $flags = null, $clear = true ) { $this->_checkRNO($rno); // Overwrite any OCR set on activateInfo if supplied here since this // method call is more specific. if ($ocr !== null) { $this->setActivateInfo('ocr', $ocr); } // If flags is specified set the flag supplied here to activateInfo. if ($flags !== null) { $this->setActivateInfo('flags', $flags); } //Assume normal shipment unless otherwise specified. if (!array_key_exists('delay_adjust', $this->shipInfo)) { $this->setShipmentInfo('delay_adjust', KlarnaFlags::NORMAL_SHIPMENT); } // Append shipment info to activateInfo $this->activateInfo['shipment_info'] = $this->shipInfo; // Unlike other calls, if NO_FLAG is specified it should not be sent in // at all. if (array_key_exists('flags', $this->activateInfo) && $this->activateInfo['flags'] === KlarnaFlags::NO_FLAG ) { unset($this->activateInfo['flags']); } // Build digest. Any field in activateInfo that is set is included in // the digest. $digestArray = array( str_replace('.', ':', $this->PROTO), $this->VERSION, $this->_eid, $rno ); $optionalDigestKeys = array( 'bclass', 'cust_no', 'flags', 'ocr', 'orderid1', 'orderid2', 'reference', 'reference_code' ); foreach ($optionalDigestKeys as $key) { if (array_key_exists($key, $this->activateInfo)) { $digestArray[] = $this->activateInfo[$key]; } } if (array_key_exists('delay_adjust', $this->activateInfo['shipment_info'])) { $digestArray[] = $this->activateInfo['shipment_info']['delay_adjust']; } // If there are any artnos added with addArtNo, add them to the digest // and to the activateInfo if (is_array($this->artNos)) { foreach ($this->artNos as $artNo) { $digestArray[] = $artNo['artno']; $digestArray[] = $artNo['qty']; } $this->setActivateInfo('artnos', $this->artNos); } $digestArray[] = $this->_secret; $digestSecret = self::digest( call_user_func_array( array('self', 'colon'), $digestArray ) ); // Create the parameter list. $paramList = array( $this->_eid, $digestSecret, $rno, $this->activateInfo ); self::printDebug('activate array', $paramList); $result = $this->xmlrpc_call('activate', $paramList); self::printDebug('activate result', $result); // Clear the state if specified. if ($clear) { $this->clear(); } return $result; } /** * Activates a previously created reservation. * * This method returns an array with:
* Risk status ("no_risk", "ok")
* Invoice number
* * Gender is only required for Germany and Netherlands.
* * Use of the OCR parameter is optional. * An OCR number can be retrieved by using: * {@link Klarna::reserveOCR()} or {@link Klarna::reserveOCRemail()}. * * Flags can be set to:
* {@link KlarnaFlags::NO_FLAG}
* {@link KlarnaFlags::TEST_MODE}
* {@link KlarnaFlags::RSRV_SEND_BY_MAIL}
* {@link KlarnaFlags::RSRV_SEND_BY_EMAIL}
* {@link KlarnaFlags::RSRV_PRESERVE_RESERVATION}
* {@link KlarnaFlags::RSRV_SENSITIVE_ORDER}
* * Some flags can be added to each other for multiple options. * * Note:
* Normal shipment type is assumed unless otherwise specified, you can * do this by calling: * {@link Klarna::setShipmentInfo() setShipmentInfo('delay_adjust', ...)} * with either: {@link KlarnaFlags::NORMAL_SHIPMENT NORMAL_SHIPMENT} or * {@link KlarnaFlags::EXPRESS_SHIPMENT EXPRESS_SHIPMENT}
* * @param string $pno Personal number, SSN, date of birth, etc. * @param string $rno Reservation number. * @param int $gender {@link KlarnaFlags::FEMALE} or * {@link KlarnaFlags::MALE}, null for unspecified. * @param string $ocr A OCR number. * @param int $flags Options which affect the behaviour. * @param int $pclass {@link KlarnaPClass::getId() PClass ID}. * @param int $encoding {@link KlarnaEncoding PNO Encoding} constant. * @param bool $clear Whether customer info should be cleared after * this call. * * @link http://integration.klarna.com/en/api/advanced-integration/functions * /activatereservation * @see Klarna::reserveAmount() * * @throws KlarnaException * @return array An array with risk status and invoice number [string, string]. */ public function activateReservation( $pno, $rno, $gender, $ocr = "", $flags = KlarnaFlags::NO_FLAG, $pclass = KlarnaPClass::INVOICE, $encoding = null, $clear = true ) { $this->_checkLocale(); //Get the PNO/SSN encoding constant. if ($encoding === null) { $encoding = $this->getPNOEncoding(); } // Only check PNO if it is not explicitly null. if ($pno !== null) { $this->_checkPNO($pno, $encoding); } $this->_checkRNO($rno); if ($gender !== null && strlen($gender) > 0) { $this->_checkInt($gender, 'gender'); } $this->_checkOCR($ocr); $this->_checkRef($this->reference, $this->reference_code); $this->_checkGoodslist(); //No addresses used for phone transactions $billing = $shipping = ''; if ( !($flags & KlarnaFlags::RSRV_PHONE_TRANSACTION) ) { $billing = $this->assembleAddr($this->billing); $shipping = $this->assembleAddr($this->shipping); if (strlen($shipping['country']) > 0 && ($shipping['country'] !== $this->_country) ) { throw new Klarna_ShippingCountryException; } } //activate digest $string = $this->_eid . ":" . $pno . ":"; foreach ($this->goodsList as $goods) { $string .= $goods["goods"]["artno"] . ":" . $goods["qty"] . ":"; } $digestSecret = self::digest($string . $this->_secret); //end digest //Assume normal shipment unless otherwise specified. if (!isset($this->shipInfo['delay_adjust'])) { $this->setShipmentInfo('delay_adjust', KlarnaFlags::NORMAL_SHIPMENT); } $paramList = array( $rno, $ocr, $pno, $gender, $this->reference, $this->reference_code, $this->orderid[0], $this->orderid[1], $shipping, $billing, "0.0.0.0", $flags, $this->_currency, $this->_country, $this->_language, $this->_eid, $digestSecret, $encoding, $pclass, $this->goodsList, $this->comment, $this->shipInfo, $this->travelInfo, $this->incomeInfo, $this->bankInfo, $this->extraInfo ); self::printDebug('activate_reservation', $paramList); $result = $this->xmlrpc_call('activate_reservation', $paramList); if ($clear === true) { $this->clear(); } self::printDebug('activate_reservation result', $result); return $result; } /** * Splits a reservation due to for example outstanding articles. * * For flags usage see:
* {@link Klarna::reserveAmount()}
* * @param string $rno Reservation number. * @param int $amount The amount to be subtracted from the reservation. * @param int $flags Options which affect the behaviour. * * @link http://integration.klarna.com/en/api/advanced-integration/functions * /splitreservation * * @throws KlarnaException * @return string A new reservation number. */ public function splitReservation( $rno, $amount, $flags = KlarnaFlags::NO_FLAG ) { //Check so required information is set. $this->_checkRNO($rno); $this->_checkAmount($amount); if ($amount <= 0) { throw new Klarna_InvalidPriceException($amount); } $digestSecret = self::digest( $this->colon($this->_eid, $rno, $amount, $this->_secret) ); $paramList = array( $rno, $amount, $this->orderid[0], $this->orderid[1], $flags, $this->_eid, $digestSecret ); self::printDebug('split_reservation array', $paramList); $result = $this->xmlrpc_call('split_reservation', $paramList); self::printDebug('split_reservation result', $result); return $result; } /** * Reserves a specified number of OCR numbers.
* For the specified country or the {@link Klarna::setCountry() set country}.
* * @param int $no The number of OCR numbers to reserve. * @param int $country {@link KlarnaCountry} constant. * * @link http://integration.klarna.com/en/api/advanced-integration/functions * /reserveocrnums * * @throws KlarnaException * @return array An array of OCR numbers. */ public function reserveOCR($no, $country = null) { $this->_checkNo($no); if ($country === null) { if (!$this->_country) { throw new Klarna_MissingCountryException; } $country = $this->_country; } else { $this->_checkCountry($country); } $digestSecret = self::digest( $this->colon($this->_eid, $no, $this->_secret) ); $paramList = array( $no, $this->_eid, $digestSecret, $country ); self::printDebug('reserve_ocr_nums array', $paramList); return $this->xmlrpc_call('reserve_ocr_nums', $paramList); } /** * Reserves the number of OCRs specified and sends them to the given email. * * @param int $no Number of OCR numbers to reserve. * @param string $email address. * @param int $country {@link KlarnaCountry} constant. * * @return bool True, if the OCRs were reserved and sent. */ public function reserveOCRemail($no, $email, $country = null) { $this->_checkNo($no); $this->_checkPNO($email, KlarnaEncoding::EMAIL); if ($country === null) { if (!$this->_country) { throw new Klarna_MissingCountryException; } $country = $this->_country; } else { $this->_checkCountry($country); } $digestSecret = self::digest( $this->colon($this->_eid, $no, $this->_secret) ); $paramList = array( $no, $email, $this->_eid, $digestSecret, $country ); self::printDebug('reserve_ocr_nums_email array', $paramList); $result = $this->xmlrpc_call('reserve_ocr_nums_email', $paramList); return ($result == 'ok'); } /** * Checks if the specified SSN/PNO has an part payment account with Klarna. * * @param string $pno Social security number, Personal number, ... * @param int $encoding {@link KlarnaEncoding PNO Encoding} constant. * * @link http://integration.klarna.com/en/api/standard-integration/functions * /hasaccount * * @throws KlarnaException * @return bool True, if customer has an account. */ public function hasAccount($pno, $encoding = null) { //Get the PNO/SSN encoding constant. if ($encoding === null) { $encoding = $this->getPNOEncoding(); } $this->_checkPNO($pno, $encoding); $digest = self::digest( $this->colon($this->_eid, $pno, $this->_secret) ); $paramList = array( $this->_eid, $pno, $digest, $encoding ); self::printDebug('has_account', $paramList); $result = $this->xmlrpc_call('has_account', $paramList); return ($result === 'true'); } /** * Adds an article number and quantity to be used in * {@link Klarna::activatePart()}, {@link Klarna::creditPart()} * and {@link Klarna::invoicePartAmount()}. * * @param int $qty Quantity of specified article. * @param string $artNo Article number. * * @link http://integration.klarna.com/en/api/invoice-handling-functions/ * functions/mkartno * * @throws KlarnaException * @return void */ public function addArtNo($qty, $artNo) { $this->_checkQty($qty); $this->_checkArtNo($artNo); if (!is_array($this->artNos)) { $this->artNos = array(); } $this->artNos[] = array('artno' => $artNo, 'qty' => $qty); } /** * Partially activates a passive invoice. * * Returned array contains index "url" and "invno".
* The value of "url" is a URL pointing to a temporary PDF-version of the * activated invoice.
* The value of "invno" is either 0 if the entire invoice was activated or * the number on the new passive invoice.
* * Note:
* You need to call {@link Klarna::addArtNo()} first, to specify which * articles and how many you want to partially activate.
* If you want to change the shipment type, you can specify it using: * {@link Klarna::setShipmentInfo() setShipmentInfo('delay_adjust', ...)} * with either: {@link KlarnaFlags::NORMAL_SHIPMENT NORMAL_SHIPMENT} * or {@link KlarnaFlags::EXPRESS_SHIPMENT EXPRESS_SHIPMENT} * * @param string $invNo Invoice numbers. * @param int $pclass PClass id used for this invoice. * @param bool $clear Whether customer info should be cleared after * this call. * * @see Klarna::addArtNo() * @see Klarna::activateInvoice() * @link http://integration.klarna.com/en/api/standard-integration/functions * /activatepart * * @throws KlarnaException * @return array An array with invoice URL and invoice number. * ['url' => val, 'invno' => val] */ public function activatePart( $invNo, $pclass = KlarnaPClass::INVOICE, $clear = true ) { $this->_checkInvNo($invNo); $this->_checkArtNos($this->artNos); self::printDebug('activate_part artNos array', $this->artNos); //function activate_part_digest $string = $this->_eid . ":" . $invNo . ":"; foreach ($this->artNos as $artNo) { $string .= $artNo["artno"] . ":". $artNo["qty"] . ":"; } $digestSecret = self::digest($string . $this->_secret); //end activate_part_digest $paramList = array( $this->_eid, $invNo, $this->artNos, $digestSecret, $pclass, $this->shipInfo ); self::printDebug('activate_part array', $paramList); $result = $this->xmlrpc_call('activate_part', $paramList); if ($clear === true) { $this->clear(); } self::printDebug('activate_part result', $result); return $result; } /** * Retrieves the total amount for an active invoice. * * @param string $invNo Invoice number. * * @link http://integration.klarna.com/en/api/other-functions/functions * /invoiceamount * * @throws KlarnaException * @return float The total amount. */ public function invoiceAmount($invNo) { $this->_checkInvNo($invNo); $digestSecret = self::digest( $this->colon($this->_eid, $invNo, $this->_secret) ); $paramList = array( $this->_eid, $invNo, $digestSecret ); self::printDebug('invoice_amount array', $paramList); $result = $this->xmlrpc_call('invoice_amount', $paramList); //Result is in cents, fix it. return ($result / 100); } /** * Changes the order number of a purchase that was set when the order was * made online. * * @param string $invNo Invoice number. * @param string $orderid Estores order number. * * @link http://integration.klarna.com/en/api/other-functions/functions * /updateorderno * * @throws KlarnaException * @return string Invoice number. */ public function updateOrderNo($invNo, $orderid) { $this->_checkInvNo($invNo); $this->_checkEstoreOrderNo($orderid); $digestSecret = self::digest( $this->colon($invNo, $orderid, $this->_secret) ); $paramList = array( $this->_eid, $digestSecret, $invNo, $orderid ); self::printDebug('update_orderno array', $paramList); $result = $this->xmlrpc_call('update_orderno', $paramList); return $result; } /** * Sends an activated invoice to the customer via e-mail.
* The email is sent in plain text format and contains a link to a * PDF-invoice.
* * Please note!
* Regular postal service is used if the customer has not entered his/her * e-mail address when making the purchase (charges may apply).
* * @param string $invNo Invoice number. * * @link http://integration.klarna.com/en/api/invoice-handling-functions * /functions/emailinvoice * * @throws KlarnaException * @return string Invoice number. */ public function emailInvoice($invNo) { $this->_checkInvNo($invNo); $digestSecret = self::digest( $this->colon($this->_eid, $invNo, $this->_secret) ); $paramList = array( $this->_eid, $invNo, $digestSecret ); self::printDebug('email_invoice array', $paramList); return $this->xmlrpc_call('email_invoice', $paramList); } /** * Requests a postal send-out of an activated invoice to a customer by * Klarna (charges may apply). * * @param string $invNo Invoice number. * * @link http://integration.klarna.com/en/api/invoice-handling-functions * /functions/sendinvoice * * @throws KlarnaException * @return string Invoice number. */ public function sendInvoice($invNo) { $this->_checkInvNo($invNo); $digestSecret = self::digest( $this->colon($this->_eid, $invNo, $this->_secret) ); $paramList = array( $this->_eid, $invNo, $digestSecret ); self::printDebug('send_invoice array', $paramList); return $this->xmlrpc_call('send_invoice', $paramList); } /** * Gives discounts on invoices.
* If you are using standard integration and the purchase is not yet * activated (you have not yet delivered the goods),
* just change the article list in our online interface Klarna Online.
* * Flags can be:
* {@link KlarnaFlags::INC_VAT}
* {@link KlarnaFlags::NO_FLAG}, NOT RECOMMENDED!
* * @param string $invNo Invoice number. * @param int $amount The amount given as a discount. * @param float $vat VAT in percent, e.g. 22.2 for 22.2%. * @param int $flags If amount is * {@link KlarnaFlags::INC_VAT including} or * {@link KlarnaFlags::NO_FLAG excluding} VAT. * @param string $description Optional custom text to present as discount * in the invoice. * * @link http://integration.klarna.com/en/api/invoice-handling-functions * /functions/returnamount * * @throws KlarnaException * @return string Invoice number. */ public function returnAmount( $invNo, $amount, $vat, $flags = KlarnaFlags::INC_VAT, $description = "" ) { $this->_checkInvNo($invNo); $this->_checkAmount($amount); $this->_checkVAT($vat); $this->_checkInt($flags, 'flags'); if ($description == null) { $description = ""; } $digestSecret = self::digest( $this->colon($this->_eid, $invNo, $this->_secret) ); $paramList = array( $this->_eid, $invNo, $amount, $vat, $digestSecret, $flags, $description ); self::printDebug('return_amount', $paramList); return $this->xmlrpc_call('return_amount', $paramList); } /** * Performs a complete refund on an invoice, part payment and mobile * purchase. * * @param string $invNo Invoice number. * @param string $credNo Credit number. * * @link http://integration.klarna.com/en/api/invoice-handling-functions * /functions/creditinvoice * * @throws KlarnaException * @return string Invoice number. */ public function creditInvoice($invNo, $credNo = "") { $this->_checkInvNo($invNo); $this->_checkCredNo($credNo); $digestSecret = self::digest( $this->colon($this->_eid, $invNo, $this->_secret) ); $paramList = array( $this->_eid, $invNo, $credNo, $digestSecret ); self::printDebug('credit_invoice', $paramList); return $this->xmlrpc_call('credit_invoice', $paramList); } /** * Performs a partial refund on an invoice, part payment or mobile purchase. * * Note:
* You need to call {@link Klarna::addArtNo()} first.
* * @param string $invNo Invoice number. * @param string $credNo Credit number. * * @see Klarna::addArtNo() * @link http://integration.klarna.com/en/api/invoice-handling-functions * /functions/creditpart * * @throws KlarnaException * @return string Invoice number. */ public function creditPart($invNo, $credNo = "") { $this->_checkInvNo($invNo); $this->_checkCredNo($credNo); if ($this->goodsList === null || empty($this->goodsList)) { $this->_checkArtNos($this->artNos); } //function activate_part_digest $string = $this->_eid . ":" . $invNo . ":"; if ($this->artNos !== null && !empty($this->artNos)) { foreach ($this->artNos as $artNo) { $string .= $artNo["artno"] . ":". $artNo["qty"] . ":"; } } $digestSecret = self::digest($string . $this->_secret); //end activate_part_digest $paramList = array( $this->_eid, $invNo, $this->artNos, $credNo, $digestSecret ); if ($this->goodsList !== null && !empty($this->goodsList)) { $paramList[] = 0; $paramList[] = $this->goodsList; } $this->artNos = array(); self::printDebug('credit_part', $paramList); return $this->xmlrpc_call('credit_part', $paramList); } /** * Changes the quantity of a specific item in a passive invoice. * * @param string $invNo Invoice number. * @param string $artNo Article number. * @param int $qty Quantity of specified article. * * @link http://integration.klarna.com/en/api/other-functions/functions * /updategoodsqty * * @throws KlarnaException * @return string Invoice number. */ public function updateGoodsQty($invNo, $artNo, $qty) { $this->_checkInvNo($invNo); $this->_checkQty($qty); $this->_checkArtNo($artNo); $digestSecret = self::digest( $this->colon($invNo, $artNo, $qty, $this->_secret) ); $paramList = array( $this->_eid, $digestSecret, $invNo, $artNo, $qty ); self::printDebug('update_goods_qty', $paramList); return $this->xmlrpc_call('update_goods_qty', $paramList); } /** * Changes the amount of a fee (e.g. the invoice fee) in a passive invoice. * * Type can be:
* {@link KlarnaFlags::IS_SHIPMENT}
* {@link KlarnaFlags::IS_HANDLING}
* * @param string $invNo Invoice number. * @param int $type Charge type. * @param int $newAmount The new amount for the charge. * * @link http://integration.klarna.com/en/api/other-functions/functions * /updatechargeamount * * @throws KlarnaException * @return string Invoice number. */ public function updateChargeAmount($invNo, $type, $newAmount) { $this->_checkInvNo($invNo); $this->_checkInt($type, 'type'); $this->_checkAmount($newAmount); if ($type === KlarnaFlags::IS_SHIPMENT) { $type = 1; } else if ($type === KlarnaFlags::IS_HANDLING) { $type = 2; } $digestSecret = self::digest( $this->colon($invNo, $type, $newAmount, $this->_secret) ); $paramList = array( $this->_eid, $digestSecret, $invNo, $type, $newAmount ); self::printDebug('update_charge_amount', $paramList); return $this->xmlrpc_call('update_charge_amount', $paramList); } /** * The invoice_address function is used to retrieve the address of a * purchase. * * @param string $invNo Invoice number. * * @link http://integration.klarna.com/en/api/other-functions/functions * /invoiceaddress * * @throws KlarnaException * @return KlarnaAddr */ public function invoiceAddress($invNo) { $this->_checkInvNo($invNo); $digestSecret = self::digest( $this->colon($this->_eid, $invNo, $this->_secret) ); $paramList = array( $this->_eid, $invNo, $digestSecret ); self::printDebug('invoice_address', $paramList); $result = $this->xmlrpc_call('invoice_address', $paramList); $addr = new KlarnaAddr(); if (strlen($result[0]) > 0) { $addr->isCompany = false; $addr->setFirstName($result[0]); $addr->setLastName($result[1]); } else { $addr->isCompany = true; $addr->setCompanyName($result[1]); } $addr->setStreet($result[2]); $addr->setZipCode($result[3]); $addr->setCity($result[4]); $addr->setCountry($result[5]); return $addr; } /** * Retrieves the amount of a specific goods from a purchase. * * Note:
* You need to call {@link Klarna::addArtNo()} first.
* * @param string $invNo Invoice number. * * @link http://integration.klarna.com/en/api/other-functions/functions * /invoicepartamount * @see Klarna::addArtNo() * * @throws KlarnaException * @return float The amount of the goods. */ public function invoicePartAmount($invNo) { $this->_checkInvNo($invNo); $this->_checkArtNos($this->artNos); //function activate_part_digest $string = $this->_eid . ":" . $invNo . ":"; foreach ($this->artNos as $artNo) { $string .= $artNo["artno"] . ":". $artNo["qty"] . ":"; } $digestSecret = self::digest($string . $this->_secret); //end activate_part_digest $paramList = array( $this->_eid, $invNo, $this->artNos, $digestSecret ); $this->artNos = array(); self::printDebug('invoice_part_amount', $paramList); $result = $this->xmlrpc_call('invoice_part_amount', $paramList); return ($result / 100); } /** * Returns the current order status for a specific reservation or invoice. * Use this when {@link Klarna::addTransaction()} or * {@link Klarna::reserveAmount()} returns a {@link KlarnaFlags::PENDING} * status. * * Order status can be:
* {@link KlarnaFlags::ACCEPTED}
* {@link KlarnaFlags::PENDING}
* {@link KlarnaFlags::DENIED}
* * @param string $id Reservation number or invoice number. * @param int $type 0 if $id is an invoice or reservation, 1 for order id * * @link http://integration.klarna.com/en/api/other-functions/functions * /checkorderstatus * * @throws KlarnaException * @return string The order status. */ public function checkOrderStatus($id, $type = 0) { $this->_checkArgument($id, "id"); $this->_checkInt($type, 'type'); if ($type !== 0 && $type !== 1) { throw new Klarna_InvalidTypeException( 'type', "0 or 1" ); } $digestSecret = self::digest( $this->colon($this->_eid, $id, $this->_secret) ); $paramList = array( $this->_eid, $digestSecret, $id, $type ); self::printDebug('check_order_status', $paramList); return $this->xmlrpc_call('check_order_status', $paramList); } /** * Retrieves a list of all the customer numbers associated with the * specified pno. * * @param string $pno Social security number, Personal number, ... * @param int $encoding {@link KlarnaEncoding PNO Encoding} constant. * * @throws KlarnaException * @return array An array containing all customer numbers associated * with that pno. */ public function getCustomerNo($pno, $encoding = null) { //Get the PNO/SSN encoding constant. if ($encoding === null) { $encoding = $this->getPNOEncoding(); } $this->_checkPNO($pno, $encoding); $digestSecret = self::digest( $this->colon($this->_eid, $pno, $this->_secret) ); $paramList = array( $pno, $this->_eid, $digestSecret, $encoding ); self::printDebug('get_customer_no', $paramList); return $this->xmlrpc_call('get_customer_no', $paramList); } /** * Associates a pno with a customer number when you want to make future * purchases without a pno. * * @param string $pno Social security number, Personal number, ... * @param string $custNo The customer number. * @param int $encoding {@link KlarnaEncoding PNO Encoding} constant. * * @throws KlarnaException * @return bool True, if the customer number was associated with the pno. */ public function setCustomerNo($pno, $custNo, $encoding = null) { //Get the PNO/SSN encoding constant. if ($encoding === null) { $encoding = $this->getPNOEncoding(); } $this->_checkPNO($pno, $encoding); $this->_checkArgument($custNo, 'custNo'); $digestSecret = self::digest( $this->colon($this->_eid, $pno, $custNo, $this->_secret) ); $paramList = array( $pno, $custNo, $this->_eid, $digestSecret, $encoding ); self::printDebug('set_customer_no', $paramList); $result = $this->xmlrpc_call('set_customer_no', $paramList); return ($result == 'ok'); } /** * Removes a customer number from association with a pno. * * @param string $custNo The customer number. * * @throws KlarnaException * @return bool True, if the customer number association was removed. */ public function removeCustomerNo($custNo) { $this->_checkArgument($custNo, 'custNo'); $digestSecret = self::digest( $this->colon($this->_eid, $custNo, $this->_secret) ); $paramList = array( $custNo, $this->_eid, $digestSecret ); self::printDebug('remove_customer_no', $paramList); $result = $this->xmlrpc_call('remove_customer_no', $paramList); return ($result == 'ok'); } /** * Sets notes/log information for the specified invoice number. * * @param string $invNo Invoice number. * @param string $notes Note(s) to be associated with the invoice. * * @throws KlarnaException * @return string Invoice number. */ public function updateNotes($invNo, $notes) { $this->_checkInvNo($invNo); if (!is_string($notes)) { $notes = strval($notes); } $digestSecret = self::digest( $this->colon($invNo, $notes, $this->_secret) ); $paramList = array( $this->_eid, $digestSecret, $invNo, $notes ); self::printDebug('update_notes', $paramList); return $this->xmlrpc_call('update_notes', $paramList); } /** * Returns the configured PCStorage object. * * @throws Exception|KlarnaException * @return PCStorage */ public function getPCStorage() { if (isset($this->pclasses)) { return $this->pclasses; } include_once 'pclasses/storage.intf.php'; $className = $this->pcStorage.'storage'; $pclassStorage = dirname(__FILE__) . "/pclasses/{$className}.class.php"; include_once $pclassStorage; $storage = new $className; if (!($storage instanceof PCStorage)) { throw new Klarna_PCStorageInvalidException( $className, $pclassStorage ); } return $storage; } /** * Fetch pclasses * * @param PCStorage $storage PClass Storage * @param int $country KlarnaCountry constant * @param int $language KlarnaLanguage constant * @param int $currency KlarnaCurrency constant * * @return void */ private function _fetchPClasses($storage, $country, $language, $currency) { $digestSecret = self::digest( $this->_eid . ":" . $currency . ":" . $this->_secret ); $paramList = array( $this->_eid, $currency, $digestSecret, $country, $language ); self::printDebug('get_pclasses array', $paramList); $result = $this->xmlrpc_call('get_pclasses', $paramList); self::printDebug('get_pclasses result', $result); foreach ($result as &$pclass) { //numeric htmlentities $pclass[1] = Klarna::num_htmlentities($pclass[1]); //Below values are in "cents", fix them. $pclass[3] /= 100; //divide start fee with 100 $pclass[4] /= 100; //divide invoice fee with 100 $pclass[5] /= 100; //divide interest rate with 100 $pclass[6] /= 100; //divide min amount with 100 if ($pclass[9] != '-') { //unix timestamp instead of yyyy-mm-dd $pclass[9] = strtotime($pclass[9]); } //Associate the PClass with this estore. array_unshift($pclass, $this->_eid); $storage->addPClass(new KlarnaPClass($pclass)); } } /** * Fetches the PClasses from Klarna Online.
* Removes the cached/stored pclasses and updates.
* You are only allowed to call this once, or once per update of PClasses * in KO.
* * Note:
* If language and/or currency is null, then they will be set to mirror * the specified country.
* Short codes like DE, SV or EUR can also be used instead of the constants. * * @param string|int $country {@link KlarnaCountry Country} constant, * or two letter code. * @param mixed $language {@link KlarnaLanguage Language} constant, * or two letter code. * @param mixed $currency {@link KlarnaCurrency Currency} constant, * or three letter code. * * @throws KlarnaException * @return void */ public function fetchPClasses( $country = null, $language = null, $currency = null ) { extract( $this->getLocale($country, $language, $currency), EXTR_OVERWRITE ); $this->_checkConfig(); $pclasses = $this->getPCStorage(); try { //Attempt to load previously stored pclasses, so they aren't // accidentially removed. $pclasses->load($this->pcURI); } catch(Exception $e) { self::printDebug('load pclasses', $e->getMessage()); } $this->_fetchPClasses($pclasses, $country, $language, $currency); $pclasses->save($this->pcURI); $this->pclasses = $pclasses; } /** * Removes the stored PClasses, if you need to update them. * * @throws KlarnaException * @return void */ public function clearPClasses() { $this->_checkConfig(); $pclasses = $this->getPCStorage(); $pclasses->clear($this->pcURI); } /** * Retrieves the specified PClasses. * * Type can be:
* {@link KlarnaPClass::CAMPAIGN}
* {@link KlarnaPClass::ACCOUNT}
* {@link KlarnaPClass::SPECIAL}
* {@link KlarnaPClass::FIXED}
* {@link KlarnaPClass::DELAY}
* {@link KlarnaPClass::MOBILE}
* * @param int $type PClass type identifier. * * @throws KlarnaException * @return array An array of PClasses. [KlarnaPClass] */ public function getPClasses($type = null) { $this->_checkConfig(); if (!$this->pclasses) { $this->pclasses = $this->getPCStorage(); $this->pclasses->load($this->pcURI); } $tmp = $this->pclasses->getPClasses( $this->_eid, $this->_country, $type ); $this->sortPClasses($tmp[$this->_eid]); return $tmp[$this->_eid]; } /** * Retrieve a flattened array of all pclasses stored in the configured * pclass storage. * * @return array */ public function getAllPClasses() { if (!$this->pclasses) { $this->pclasses = $this->getPCStorage(); $this->pclasses->load($this->pcURI); } return $this->pclasses->getAllPClasses(); } /** * Returns the specified PClass. * * @param int $id The PClass ID. * * @return KlarnaPClass */ public function getPClass($id) { if (!is_numeric($id)) { throw new Klarna_InvalidTypeException('id', 'integer'); } $this->_checkConfig(); if (!$this->pclasses || !($this->pclasses instanceof PCStorage)) { $this->pclasses = $this->getPCStorage(); $this->pclasses->load($this->pcURI); } return $this->pclasses->getPClass( intval($id), $this->_eid, $this->_country ); } /** * Sorts the specified array of KlarnaPClasses. * * @param array &$array An array of {@link KlarnaPClass PClasses}. * * @return void */ public function sortPClasses(&$array) { if (!is_array($array)) { //Input is not an array! $array = array(); return; } //Sort pclasses array after natural sort (natcmp) if (!function_exists('pcCmp')) { /** * Comparison function * * @param KlarnaPClass $a object 1 * @param KlarnaPClass $b object 2 * * @return int */ function pcCmp($a, $b) { if ($a->getDescription() == null && $b->getDescription() == null ) { return 0; } else if ($a->getDescription() == null) { return 1; } else if ($b->getDescription() == null) { return -1; } else if ($b->getType() === 2 && $a->getType() !== 2) { return 1; } else if ($b->getType() !== 2 && $a->getType() === 2) { return -1; } return strnatcmp($a->getDescription(), $b->getDescription())*-1; } } usort($array, "pcCmp"); } /** * Returns the cheapest, per month, PClass related to the specified sum. * * Note: This choose the cheapest PClass for the current country.
* {@link Klarna::setCountry()} * * Flags can be:
* {@link KlarnaFlags::CHECKOUT_PAGE}
* {@link KlarnaFlags::PRODUCT_PAGE}
* * @param float $sum The product cost, or total sum of the cart. * @param int $flags Which type of page the info will be displayed on. * * @throws KlarnaException * @return KlarnaPClass or false if none was found. */ public function getCheapestPClass($sum, $flags) { if (!is_numeric($sum)) { throw new Klarna_InvalidPriceException($sum); } if (!is_numeric($flags) || !in_array( $flags, array( KlarnaFlags::CHECKOUT_PAGE, KlarnaFlags::PRODUCT_PAGE) ) ) { throw new Klarna_InvalidTypeException( 'flags', KlarnaFlags::CHECKOUT_PAGE . ' or ' . KlarnaFlags::PRODUCT_PAGE ); } $lowest_pp = $lowest = false; foreach ($this->getPClasses() as $pclass) { $lowest_payment = KlarnaCalc::get_lowest_payment_for_account( $pclass->getCountry() ); if ($pclass->getType() < 2 && $sum >= $pclass->getMinAmount()) { $minpay = KlarnaCalc::calc_monthly_cost( $sum, $pclass, $flags ); if ($minpay < $lowest_pp || $lowest_pp === false) { if ($pclass->getType() == KlarnaPClass::ACCOUNT || $minpay >= $lowest_payment ) { $lowest_pp = $minpay; $lowest = $pclass; } } } } return $lowest; } /** * Initializes the checkoutHTML objects. * * @see Klarna::checkoutHTML() * @return void */ protected function initCheckout() { $dir = dirname(__FILE__); //Require the CheckoutHTML interface/abstract class include_once $dir.'/checkout/checkouthtml.intf.php'; //Iterate over all .class.php files in checkout/ foreach (glob($dir.'/checkout/*.class.php') as $checkout) { if (!self::$debug) { ob_start(); } include_once $checkout; $className = basename($checkout, '.class.php'); $cObj = new $className; if ($cObj instanceof CheckoutHTML) { $cObj->init($this, $this->_eid); $this->coObjects[$className] = $cObj; } if (!self::$debug) { ob_end_clean(); } } } /** * Returns the checkout page HTML from the checkout classes. * * Note:
* This method uses output buffering to silence unwanted echoes.
* * @see CheckoutHTML * * @return string A HTML string. */ public function checkoutHTML() { if (empty($this->coObjects)) { $this->initCheckout(); } $dir = dirname(__FILE__); //Require the CheckoutHTML interface/abstract class include_once $dir.'/checkout/checkouthtml.intf.php'; //Iterate over all .class.php files in $html = "\n"; foreach ($this->coObjects as $cObj) { if (!self::$debug) { ob_start(); } if ($cObj instanceof CheckoutHTML) { $html .= $cObj->toHTML() . "\n"; } if (!self::$debug) { ob_end_clean(); } } return $html; } /** * Creates a XMLRPC call with specified XMLRPC method and parameters from array. * * @param string $method XMLRPC method. * @param array $array XMLRPC parameters. * * @throws KlarnaException * @return mixed */ protected function xmlrpc_call($method, $array) { $this->_checkConfig(); if (!isset($method) || !is_string($method)) { throw new Klarna_InvalidTypeException('method', 'string'); } if ($array === null || count($array) === 0) { throw new KlarnaException("Parameterlist is empty or null!", 50067); } if (self::$disableXMLRPC) { return true; } try { /* * Disable verifypeer for CURL, so below error is avoided. * CURL error: SSL certificate problem, verify that the CA * cert is OK. * Details: error:14090086:SSL * routines:SSL3_GET_SERVER_CERTIFICATE:certificate verify failed (#8) */ $this->xmlrpc->verifypeer = false; $timestart = microtime(true); //Create the XMLRPC message. $msg = new xmlrpcmsg($method); $params = array_merge( array( $this->PROTO, $this->VERSION ), $array ); $msg = new xmlrpcmsg($method); foreach ($params as $p) { if (!$msg->addParam( php_xmlrpc_encode($p, array('extension_api')) ) ) { throw new KlarnaException( "Failed to add parameters to XMLRPC message.", 50068 ); } } //Send the message. $selectDateTime = microtime(true); if (self::$xmlrpcDebug) { $this->xmlrpc->setDebug(2); } $xmlrpcresp = $this->xmlrpc->send($msg); //Calculate time and selectTime. $timeend = microtime(true); $time = (int) (($selectDateTime - $timestart) * 1000); $selectTime = (int) (($timeend - $timestart) * 1000); $status = $xmlrpcresp->faultCode(); //Send report to candice. if (self::$_candice === true) { $this->sendStat($method, $time, $selectTime, $status); } if ($status !== 0) { throw new KlarnaException($xmlrpcresp->faultString(), $status); } return php_xmlrpc_decode($xmlrpcresp->value()); } catch(KlarnaException $e) { //Otherwise it is caught below, and rethrown. throw $e; } catch(Exception $e) { throw new KlarnaException($e->getMessage(), $e->getCode()); } } /** * Removes all relevant order/customer data from the internal structure. * * @return void */ public function clear() { $this->goodsList = null; $this->comment = ""; $this->billing = null; $this->shipping = null; $this->shipInfo = array(); $this->extraInfo = array(); $this->bankInfo = array(); $this->incomeInfo = array(); $this->activateInfo = array(); $this->reference = ""; $this->reference_code = ""; $this->orderid[0] = ""; $this->orderid[1] = ""; $this->artNos = array(); $this->coObjects = array(); } /** * Sends a report to Candice. * * @param string $method XMLRPC method. * @param int $time Elapsed time of entire XMLRPC call. * @param int $selectTime Time to create the XMLRPC parameters. * @param int $status XMLRPC error code. * * @return void */ protected function sendStat($method, $time, $selectTime, $status) { $fp = @fsockopen('udp://'.self::$_c_addr, 80, $errno, $errstr, 1500); if ($fp) { $uri = "{$this->_url['scheme']}://{$this->_url['host']}" . ":{$this->_url['port']}"; $data = $this->pipe( $this->_eid, $method, $time, $selectTime, $status, $uri ); $digest = self::digest($this->pipe($data, $this->_secret)); self::printDebug("candice report", $data); @fwrite($fp, $this->pipe($data, $digest)); @fclose($fp); } } /** * Implodes parameters with delimiter ':'. * Null and "" values are ignored by the colon function to * ensure there is not several colons in succession. * * @return string Colon separated string. */ public static function colon(/* variable parameters */) { return implode( ':', array_filter( func_get_args(), array('self', 'filterDigest') ) ); } /** * Implodes parameters with delimiter '|'. * * @return string Pipe separated string. */ public static function pipe(/* variable parameters */) { $args = func_get_args(); return implode('|', $args); } /** * Check if the value has a string length larger than 0 * * @param mixed $value The value to check. * * @return boolean True if string length is larger than 0 */ public static function filterDigest($value) { return strlen(strval($value)) > 0; } /** * Creates a digest hash from the inputted string, * and the specified or the preferred hash algorithm. * * @param string $data Data to be hashed. * @param string $hash hash algoritm to use * * @throws KlarnaException * @return string Base64 encoded hash. */ public static function digest($data, $hash = null) { if ($hash===null) { $preferred = array( 'sha512', 'sha384', 'sha256', 'sha224', 'md5' ); $hashes = array_intersect($preferred, hash_algos()); if (count($hashes) == 0) { throw new KlarnaException( "No available hash algorithm supported!" ); } $hash = array_shift($hashes); } self::printDebug('digest() using hash', $hash); return base64_encode(pack("H*", hash($hash, $data))); } /** * Converts special characters to numeric htmlentities. * * Note:
* If supplied string is encoded with UTF-8, o umlaut ("ö") will become two * HTML entities instead of one. * * @param string $str String to be converted. * * @return string String converted to numeric HTML entities. */ public static function num_htmlentities($str) { if (!self::$htmlentities) { self::$htmlentities = array(); $table = get_html_translation_table(HTML_ENTITIES, ENT_QUOTES); foreach ($table as $char => $entity) { self::$htmlentities[$entity] = '&#' . ord($char) . ';'; } } return str_replace( array_keys( self::$htmlentities ), self::$htmlentities, htmlentities($str) ); } /** * Prints debug information if debug is set to true. * $msg is used as header/footer in the output. * * if FirePHP is available it will be used instead of * dumping the debug info into the document. * * It uses print_r and encapsulates it in HTML/XML comments. * () * * @param string $msg Debug identifier, e.g. "my array". * @param mixed $mixed Object, type, etc, to be debugged. * * @return void */ public static function printDebug($msg, $mixed) { if (self::$debug) { if (class_exists('FB', false)) { FB::send($mixed, $msg); } else { echo "\n\n"; } } } /** * Checks/fixes so the invNo input is valid. * * @param string &$invNo Invoice number. * * @throws KlarnaException * @return void */ private function _checkInvNo(&$invNo) { if (!isset($invNo)) { throw new Klarna_ArgumentNotSetException("Invoice number"); } if (!is_string($invNo)) { $invNo = strval($invNo); } if (strlen($invNo) == 0) { throw new Klarna_ArgumentNotSetException("Invoice number"); } } /** * Checks/fixes so the quantity input is valid. * * @param int &$qty Quantity. * * @throws KlarnaException * @return void */ private function _checkQty(&$qty) { if (!isset($qty)) { throw new Klarna_ArgumentNotSetException("Quantity"); } if (is_numeric($qty) && !is_int($qty)) { $qty = intval($qty); } if (!is_int($qty)) { throw new Klarna_InvalidTypeException("Quantity", "integer"); } } /** * Checks/fixes so the artTitle input is valid. * * @param string &$artTitle Article title. * * @throws KlarnaException * @return void */ private function _checkArtTitle(&$artTitle) { if (!is_string($artTitle)) { $artTitle = strval($artTitle); } if (!isset($artTitle) || strlen($artTitle) == 0) { throw new Klarna_ArgumentNotSetException("artTitle", 50059); } } /** * Checks/fixes so the artNo input is valid. * * @param int|string &$artNo Article number. * * @throws KlarnaException * @return void */ private function _checkArtNo(&$artNo) { if (is_numeric($artNo) && !is_string($artNo)) { //Convert artNo to string if integer. $artNo = strval($artNo); } if (!isset($artNo) || strlen($artNo) == 0 || (!is_string($artNo))) { throw new Klarna_ArgumentNotSetException("artNo"); } } /** * Checks/fixes so the credNo input is valid. * * @param string &$credNo Credit number. * * @throws KlarnaException * @return void */ private function _checkCredNo(&$credNo) { if (!isset($credNo)) { throw new Klarna_ArgumentNotSetException("Credit number"); } if ($credNo === false || $credNo === null) { $credNo = ""; } if (!is_string($credNo)) { $credNo = strval($credNo); if (!is_string($credNo)) { throw new Klarna_InvalidTypeException("Credit number", "string"); } } } /** * Checks so that artNos is an array and is not empty. * * @param array &$artNos Array from {@link Klarna::addArtNo()}. * * @throws KlarnaException * @return void */ private function _checkArtNos(&$artNos) { if (!is_array($artNos)) { throw new Klarna_InvalidTypeException("artNos", "array"); } if (empty($artNos)) { throw new KlarnaException('ArtNo array is empty!', 50064); } } /** * Checks/fixes so the integer input is valid. * * @param int &$int {@link KlarnaFlags flags} constant. * @param string $field Name of the field. * * @throws KlarnaException * @return void */ private function _checkInt(&$int, $field) { if (!isset($int)) { throw new Klarna_ArgumentNotSetException($field); } if (is_numeric($int) && !is_int($int)) { $int = intval($int); } if (!is_numeric($int) || !is_int($int)) { throw new Klarna_InvalidTypeException($field, "integer"); } } /** * Checks/fixes so the VAT input is valid. * * @param float &$vat VAT. * * @throws KlarnaException * @return void */ private function _checkVAT(&$vat) { if (!isset($vat)) { throw new Klarna_ArgumentNotSetException("VAT"); } if (is_numeric($vat) && (!is_int($vat) || !is_float($vat))) { $vat = floatval($vat); } if (!is_numeric($vat) || (!is_int($vat) && !is_float($vat))) { throw new Klarna_InvalidTypeException("VAT", "integer or float"); } } /** * Checks/fixes so the amount input is valid. * * @param int &$amount Amount. * * @throws KlarnaException * @return void */ private function _checkAmount(&$amount) { if (!isset($amount)) { throw new Klarna_ArgumentNotSetException("Amount"); } if (is_numeric($amount)) { $this->_fixValue($amount); } if (is_numeric($amount) && !is_int($amount)) { $amount = intval($amount); } if (!is_numeric($amount) || !is_int($amount)) { throw new Klarna_InvalidTypeException("amount", "integer"); } } /** * Checks/fixes so the price input is valid. * * @param int &$price Price. * * @throws KlarnaException * @return void */ private function _checkPrice(&$price) { if (!isset($price)) { throw new Klarna_ArgumentNotSetException("Price"); } if (is_numeric($price)) { $this->_fixValue($price); } if (is_numeric($price) && !is_int($price)) { $price = intval($price); } if (!is_numeric($price) || !is_int($price)) { throw new Klarna_InvalidTypeException("Price", "integer"); } } /** * Multiplies value with 100 and rounds it. * This fixes value/price/amount inputs so that KO can handle them. * * @param float &$value value * * @return void */ private function _fixValue(&$value) { $value = round($value * 100); } /** * Checks/fixes so the discount input is valid. * * @param float &$discount Discount amount. * * @throws KlarnaException * @return void */ private function _checkDiscount(&$discount) { if (!isset($discount)) { throw new Klarna_ArgumentNotSetException("Discount"); } if (is_numeric($discount) && (!is_int($discount) || !is_float($discount)) ) { $discount = floatval($discount); } if (!is_numeric($discount) || (!is_int($discount) && !is_float($discount)) ) { throw new Klarna_InvalidTypeException("Discount", "integer or float"); } } /** * Checks/fixes so that the estoreOrderNo input is valid. * * @param string &$estoreOrderNo Estores order number. * * @throws KlarnaException * @return void */ private function _checkEstoreOrderNo(&$estoreOrderNo) { if (!isset($estoreOrderNo)) { throw new Klarna_ArgumentNotSetException("Order number"); } if (!is_string($estoreOrderNo)) { $estoreOrderNo = strval($estoreOrderNo); if (!is_string($estoreOrderNo)) { throw new Klarna_InvalidTypeException("Order number", "string"); } } } /** * Checks/fixes to the PNO/SSN input is valid. * * @param string &$pno Personal number, social security number, ... * @param int $enc {@link KlarnaEncoding PNO Encoding} constant. * * @throws KlarnaException * @return void */ private function _checkPNO(&$pno, $enc) { if (!$pno) { throw new Klarna_ArgumentNotSetException("PNO/SSN"); } if (!KlarnaEncoding::checkPNO($pno)) { throw new Klarna_InvalidPNOException; } } /** * Checks/fixes to the country input is valid. * * @param int &$country {@link KlarnaCountry Country} constant. * * @throws KlarnaException * @return void */ private function _checkCountry(&$country) { if (!isset($country)) { throw new Klarna_ArgumentNotSetException("Country"); } if (is_numeric($country) && !is_int($country)) { $country = intval($country); } if (!is_numeric($country) || !is_int($country)) { throw new Klarna_InvalidTypeException("Country", "integer"); } } /** * Checks/fixes to the language input is valid. * * @param int &$language {@link KlarnaLanguage Language} constant. * * @throws KlarnaException * @return void */ private function _checkLanguage(&$language) { if (!isset($language)) { throw new Klarna_ArgumentNotSetException("Language"); } if (is_numeric($language) && !is_int($language)) { $language = intval($language); } if (!is_numeric($language) || !is_int($language)) { throw new Klarna_InvalidTypeException("Language", "integer"); } } /** * Checks/fixes to the currency input is valid. * * @param int &$currency {@link KlarnaCurrency Currency} constant. * * @throws KlarnaException * @return void */ private function _checkCurrency(&$currency) { if (!isset($currency)) { throw new Klarna_ArgumentNotSetException("Currency"); } if (is_numeric($currency) && !is_int($currency)) { $currency = intval($currency); } if (!is_numeric($currency) || !is_int($currency)) { throw new Klarna_InvalidTypeException("Currency", "integer"); } } /** * Checks/fixes so no/number is a valid input. * * @param int &$no Number. * * @throws KlarnaException * @return void */ private function _checkNo(&$no) { if (!isset($no)) { throw new Klarna_ArgumentNotSetException("no"); } if (is_numeric($no) && !is_int($no)) { $no = intval($no); } if (!is_numeric($no) || !is_int($no) || $no <= 0) { throw new Klarna_InvalidTypeException('no', 'integer > 0'); } } /** * Checks/fixes so reservation number is a valid input. * * @param string &$rno Reservation number. * * @throws KlarnaException * @return void */ private function _checkRNO(&$rno) { if (!is_string($rno)) { $rno = strval($rno); } if (strlen($rno) == 0) { throw new Klarna_ArgumentNotSetException("RNO"); } } /** * Checks/fixes so that reference/refCode are valid. * * @param string &$reference Reference string. * @param string &$refCode Reference code. * * @throws KlarnaException * @return void */ private function _checkRef(&$reference, &$refCode) { if (!is_string($reference)) { $reference = strval($reference); if (!is_string($reference)) { throw new Klarna_InvalidTypeException("Reference", "string"); } } if (!is_string($refCode)) { $refCode = strval($refCode); if (!is_string($refCode)) { throw new Klarna_InvalidTypeException("Reference code", "string"); } } } /** * Checks/fixes so that the OCR input is valid. * * @param string &$ocr OCR number. * * @throws KlarnaException * @return void */ private function _checkOCR(&$ocr) { if (!is_string($ocr)) { $ocr = strval($ocr); if (!is_string($ocr)) { throw new Klarna_InvalidTypeException("OCR", "string"); } } } /** * Check so required argument is supplied. * * @param string $argument argument to check * @param string $name name of argument * * @throws Klarna_ArgumentNotSetException * @return void */ private function _checkArgument($argument, $name) { if (!is_string($argument)) { $argument = strval($argument); } if (strlen($argument) == 0) { throw new Klarna_ArgumentNotSetException($name); } } /** * Check so Locale settings (country, currency, language) are set. * * @throws KlarnaException * @return void */ private function _checkLocale() { if (!is_int($this->_country) || !is_int($this->_language) || !is_int($this->_currency) ) { throw new Klarna_InvalidLocaleException; } } /** * Checks wether a goodslist is set. * * @throws Klarna_MissingGoodslistException * @return void */ private function _checkGoodslist() { if (!is_array($this->goodsList) || empty($this->goodsList)) { throw new Klarna_MissingGoodslistException; } } /** * Set the pcStorage method used for this instance * * @param PCStorage $pcStorage PCStorage implementation * * @return void */ public function setPCStorage($pcStorage) { if (!($pcStorage instanceof PCStorage)) { throw new Klarna_InvalidTypeException('pcStorage', 'PCStorage'); } $this->pcStorage = $pcStorage->getName(); $this->pclasses = $pcStorage; } /** * Ensure the configuration is of the correct type. * * @param array|ArrayAccess|null $config an optional config to validate * * @return void */ private function _checkConfig($config = null) { if ($config === null) { $config = $this->config; } if (!($config instanceof ArrayAccess) && !is_array($config) ) { throw new Klarna_IncompleteConfigurationException; } } } //End Klarna /** * Include the {@link KlarnaConfig} class. */ require_once 'klarnaconfig.php'; /** * Include the {@link KlarnaPClass} class. */ require_once 'klarnapclass.php'; /** * Include the {@link KlarnaCalc} class. */ require_once 'klarnacalc.php'; /** * Include the {@link KlarnaAddr} class. */ require_once 'klarnaaddr.php'; /** * Include the Exception classes. */ require_once 'Exceptions.php'; /** * Include the KlarnaEncoding class. */ require_once 'Encoding.php'; /** * Include the KlarnaFlags class. */ require_once 'Flags.php'; /** * Include KlarnaCountry, KlarnaCurrency, KlarnaLanguage classes */ require_once 'Country.php'; require_once 'Currency.php'; require_once 'Language.php'; CHANGELOG 0000666 00000016025 15137552047 0005777 0 ustar 00 ===================== Klarna PHP API ===================== v2.3.4 --------------- Date: 2013-05-03 Joakim L.
\n---SENDING---\n" . htmlentities($op) . "\n---END---\n"; // let the client see this now in case http times out... flush(); } if($timeout>0) { $fp=@fsockopen($connectserver, $connectport, $this->errno, $this->errstr, $timeout); } else { $fp=@fsockopen($connectserver, $connectport, $this->errno, $this->errstr); } if($fp) { if($timeout>0 && function_exists('stream_set_timeout')) { stream_set_timeout($fp, $timeout); } } else { $this->errstr='Connect error: '.$this->errstr; $r=new xmlrpcresp(0, $GLOBALS['xmlrpcerr']['http_error'], $this->errstr . ' (' . $this->errno . ')'); return $r; } if(!fputs($fp, $op, strlen($op))) { fclose($fp); $this->errstr='Write error'; $r=new xmlrpcresp(0, $GLOBALS['xmlrpcerr']['http_error'], $this->errstr); return $r; } else { // reset errno and errstr on succesful socket connection $this->errstr = ''; } // G. Giunta 2005/10/24: close socket before parsing. // should yeld slightly better execution times, and make easier recursive calls (e.g. to follow http redirects) $ipd=''; do { // shall we check for $data === FALSE? // as per the manual, it signals an error $ipd.=fread($fp, 32768); } while(!feof($fp)); fclose($fp); $r =& $msg->parseResponse($ipd, false, $this->return_type); return $r; } /** * @access private */ function &sendPayloadHTTPS($msg, $server, $port, $timeout=0, $username='', $password='', $authtype=1, $cert='',$certpass='', $cacert='', $cacertdir='', $proxyhost='', $proxyport=0, $proxyusername='', $proxypassword='', $proxyauthtype=1, $keepalive=false, $key='', $keypass='') { $r =& $this->sendPayloadCURL($msg, $server, $port, $timeout, $username, $password, $authtype, $cert, $certpass, $cacert, $cacertdir, $proxyhost, $proxyport, $proxyusername, $proxypassword, $proxyauthtype, 'https', $keepalive, $key, $keypass); return $r; } /** * Contributed by Justin Miller
\n---SENDING---\n" . htmlentities($payload) . "\n---END---\n"; // let the client see this now in case http times out... flush(); } if(!$keepalive || !$this->xmlrpc_curl_handle) { $curl = curl_init($method . '://' . $server . ':' . $port . $this->path); if($keepalive) { $this->xmlrpc_curl_handle = $curl; } } else { $curl = $this->xmlrpc_curl_handle; } // results into variable curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); if($this->debug) { curl_setopt($curl, CURLOPT_VERBOSE, 1); } curl_setopt($curl, CURLOPT_USERAGENT, $this->user_agent); // required for XMLRPC: post the data curl_setopt($curl, CURLOPT_POST, 1); // the data curl_setopt($curl, CURLOPT_POSTFIELDS, $payload); // return the header too curl_setopt($curl, CURLOPT_HEADER, 1); // will only work with PHP >= 5.0 // NB: if we set an empty string, CURL will add http header indicating // ALL methods it is supporting. This is possibly a better option than // letting the user tell what curl can / cannot do... if(is_array($this->accepted_compression) && count($this->accepted_compression)) { //curl_setopt($curl, CURLOPT_ENCODING, implode(',', $this->accepted_compression)); // empty string means 'any supported by CURL' (shall we catch errors in case CURLOPT_SSLKEY undefined ?) if (count($this->accepted_compression) == 1) { curl_setopt($curl, CURLOPT_ENCODING, $this->accepted_compression[0]); } else curl_setopt($curl, CURLOPT_ENCODING, ''); } // extra headers $headers = array('Content-Type: ' . $msg->content_type , 'Accept-Charset: ' . implode(',', $this->accepted_charset_encodings)); // if no keepalive is wanted, let the server know it in advance if(!$keepalive) { $headers[] = 'Connection: close'; } // request compression header if($encoding_hdr) { $headers[] = $encoding_hdr; } curl_setopt($curl, CURLOPT_HTTPHEADER, $headers); // timeout is borked if($timeout) { curl_setopt($curl, CURLOPT_TIMEOUT, $timeout == 1 ? 1 : $timeout - 1); } if($username && $password) { curl_setopt($curl, CURLOPT_USERPWD, $username.':'.$password); if (defined('CURLOPT_HTTPAUTH')) { curl_setopt($curl, CURLOPT_HTTPAUTH, $authtype); } else if ($authtype != 1) { error_log('XML-RPC: '.__METHOD__.': warning. Only Basic auth is supported by the current PHP/curl install'); } } if($method == 'https') { // set cert file if($cert) { curl_setopt($curl, CURLOPT_SSLCERT, $cert); } // set cert password if($certpass) { curl_setopt($curl, CURLOPT_SSLCERTPASSWD, $certpass); } // whether to verify remote host's cert curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, $this->verifypeer); // set ca certificates file/dir if($cacert) { curl_setopt($curl, CURLOPT_CAINFO, $cacert); } if($cacertdir) { curl_setopt($curl, CURLOPT_CAPATH, $cacertdir); } // set key file (shall we catch errors in case CURLOPT_SSLKEY undefined ?) if($key) { curl_setopt($curl, CURLOPT_SSLKEY, $key); } // set key password (shall we catch errors in case CURLOPT_SSLKEY undefined ?) if($keypass) { curl_setopt($curl, CURLOPT_SSLKEYPASSWD, $keypass); } // whether to verify cert's common name (CN); 0 for no, 1 to verify that it exists, and 2 to verify that it matches the hostname used curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, $this->verifyhost); } // proxy info if($proxyhost) { if($proxyport == 0) { $proxyport = 8080; // NB: even for HTTPS, local connection is on port 8080 } curl_setopt($curl, CURLOPT_PROXY, $proxyhost.':'.$proxyport); //curl_setopt($curl, CURLOPT_PROXYPORT,$proxyport); if($proxyusername) { curl_setopt($curl, CURLOPT_PROXYUSERPWD, $proxyusername.':'.$proxypassword); if (defined('CURLOPT_PROXYAUTH')) { curl_setopt($curl, CURLOPT_PROXYAUTH, $proxyauthtype); } else if ($proxyauthtype != 1) { error_log('XML-RPC: '.__METHOD__.': warning. Only Basic auth to proxy is supported by the current PHP/curl install'); } } } // NB: should we build cookie http headers by hand rather than let CURL do it? // the following code does not honour 'expires', 'path' and 'domain' cookie attributes // set to client obj the the user... if (count($this->cookies)) { $cookieheader = ''; foreach ($this->cookies as $name => $cookie) { $cookieheader .= $name . '=' . $cookie['value'] . '; '; } curl_setopt($curl, CURLOPT_COOKIE, substr($cookieheader, 0, -2)); } foreach ($this->extracurlopts as $opt => $val) { curl_setopt($curl, $opt, $val); } $result = curl_exec($curl); if ($this->debug > 1) { print "
\n---CURL INFO---\n"; foreach(curl_getinfo($curl) as $name => $val) print $name . ': ' . htmlentities($val). "\n"; print "---END---\n"; } if(!$result) /// @todo we should use a better check here - what if we get back '' or '0'? { $this->errstr='no response'; $resp=new xmlrpcresp(0, $GLOBALS['xmlrpcerr']['curl_fail'], $GLOBALS['xmlrpcstr']['curl_fail']. ': '. curl_error($curl)); curl_close($curl); if($keepalive) { $this->xmlrpc_curl_handle = null; } } else { if(!$keepalive) { curl_close($curl); } $resp =& $msg->parseResponse($result, true, $this->return_type); } return $resp; } /** * Send an array of request messages and return an array of responses. * Unless $this->no_multicall has been set to true, it will try first * to use one single xmlrpc call to server method system.multicall, and * revert to sending many successive calls in case of failure. * This failure is also stored in $this->no_multicall for subsequent calls. * Unfortunately, there is no server error code universally used to denote * the fact that multicall is unsupported, so there is no way to reliably * distinguish between that and a temporary failure. * If you are sure that server supports multicall and do not want to * fallback to using many single calls, set the fourth parameter to FALSE. * * NB: trying to shoehorn extra functionality into existing syntax has resulted * in pretty much convoluted code... * * @param array $msgs an array of xmlrpcmsg objects * @param integer $timeout connection timeout (in seconds) * @param string $method the http protocol variant to be used * @param boolean fallback When true, upon receiveing an error during multicall, multiple single calls will be attempted * @return array * @access public */ function multicall($msgs, $timeout=0, $method='', $fallback=true) { if ($method == '') { $method = $this->method; } if(!$this->no_multicall) { $results = $this->_try_multicall($msgs, $timeout, $method); if(is_array($results)) { // System.multicall succeeded return $results; } else { // either system.multicall is unsupported by server, // or call failed for some other reason. if ($fallback) { // Don't try it next time... $this->no_multicall = true; } else { if (is_a($results, 'xmlrpcresp')) { $result = $results; } else { $result = new xmlrpcresp(0, $GLOBALS['xmlrpcerr']['multicall_error'], $GLOBALS['xmlrpcstr']['multicall_error']); } } } } else { // override fallback, in case careless user tries to do two // opposite things at the same time $fallback = true; } $results = array(); if ($fallback) { // system.multicall is (probably) unsupported by server: // emulate multicall via multiple requests foreach($msgs as $msg) { $results[] =& $this->send($msg, $timeout, $method); } } else { // user does NOT want to fallback on many single calls: // since we should always return an array of responses, // return an array with the same error repeated n times foreach($msgs as $msg) { $results[] = $result; } } return $results; } /** * Attempt to boxcar $msgs via system.multicall. * Returns either an array of xmlrpcreponses, an xmlrpc error response * or false (when received response does not respect valid multicall syntax) * @access private */ function _try_multicall($msgs, $timeout, $method) { // Construct multicall message $calls = array(); foreach($msgs as $msg) { $call['methodName'] = new xmlrpcval($msg->method(),'string'); $numParams = $msg->getNumParams(); $params = array(); for($i = 0; $i < $numParams; $i++) { $params[$i] = $msg->getParam($i); } $call['params'] = new xmlrpcval($params, 'array'); $calls[] = new xmlrpcval($call, 'struct'); } $multicall = new xmlrpcmsg('system.multicall'); $multicall->addParam(new xmlrpcval($calls, 'array')); // Attempt RPC call $result =& $this->send($multicall, $timeout, $method); if($result->faultCode() != 0) { // call to system.multicall failed return $result; } // Unpack responses. $rets = $result->value(); if ($this->return_type == 'xml') { return $rets; } else if ($this->return_type == 'phpvals') { ///@todo test this code branch... $rets = $result->value(); if(!is_array($rets)) { return false; // bad return type from system.multicall } $numRets = count($rets); if($numRets != count($msgs)) { return false; // wrong number of return values. } $response = array(); for($i = 0; $i < $numRets; $i++) { $val = $rets[$i]; if (!is_array($val)) { return false; } switch(count($val)) { case 1: if(!isset($val[0])) { return false; // Bad value } // Normal return value $response[$i] = new xmlrpcresp($val[0], 0, '', 'phpvals'); break; case 2: /// @todo remove usage of @: it is apparently quite slow $code = @$val['faultCode']; if(!is_int($code)) { return false; } $str = @$val['faultString']; if(!is_string($str)) { return false; } $response[$i] = new xmlrpcresp(0, $code, $str); break; default: return false; } } return $response; } else // return type == 'xmlrpcvals' { $rets = $result->value(); if($rets->kindOf() != 'array') { return false; // bad return type from system.multicall } $numRets = $rets->arraysize(); if($numRets != count($msgs)) { return false; // wrong number of return values. } $response = array(); for($i = 0; $i < $numRets; $i++) { $val = $rets->arraymem($i); switch($val->kindOf()) { case 'array': if($val->arraysize() != 1) { return false; // Bad value } // Normal return value $response[$i] = new xmlrpcresp($val->arraymem(0)); break; case 'struct': $code = $val->structmem('faultCode'); if($code->kindOf() != 'scalar' || $code->scalartyp() != 'int') { return false; } $str = $val->structmem('faultString'); if($str->kindOf() != 'scalar' || $str->scalartyp() != 'string') { return false; } $response[$i] = new xmlrpcresp(0, $code->scalarval(), $str->scalarval()); break; default: return false; } } return $response; } } } // end class xmlrpc_client class xmlrpcresp { var $val = 0; var $valtyp; var $errno = 0; var $errstr = ''; var $payload; var $hdrs = array(); var $_cookies = array(); var $content_type = 'text/xml'; var $raw_data = ''; /** * @param mixed $val either an xmlrpcval obj, a php value or the xml serialization of an xmlrpcval (a string) * @param integer $fcode set it to anything but 0 to create an error response * @param string $fstr the error string, in case of an error response * @param string $valtyp either 'xmlrpcvals', 'phpvals' or 'xml' * * @todo add check that $val / $fcode / $fstr is of correct type??? * NB: as of now we do not do it, since it might be either an xmlrpcval or a plain * php val, or a complete xml chunk, depending on usage of xmlrpc_client::send() inside which creator is called... */ function xmlrpcresp($val, $fcode = 0, $fstr = '', $valtyp='') { if($fcode != 0) { // error response $this->errno = $fcode; $this->errstr = $fstr; //$this->errstr = htmlspecialchars($fstr); // XXX: encoding probably shouldn't be done here; fix later. } else { // successful response $this->val = $val; if ($valtyp == '') { // user did not declare type of response value: try to guess it if (is_object($this->val) && is_a($this->val, 'xmlrpcval')) { $this->valtyp = 'xmlrpcvals'; } else if (is_string($this->val)) { $this->valtyp = 'xml'; } else { $this->valtyp = 'phpvals'; } } else { // user declares type of resp value: believe him $this->valtyp = $valtyp; } } } /** * Returns the error code of the response. * @return integer the error code of this response (0 for not-error responses) * @access public */ function faultCode() { return $this->errno; } /** * Returns the error code of the response. * @return string the error string of this response ('' for not-error responses) * @access public */ function faultString() { return $this->errstr; } /** * Returns the value received by the server. * @return mixed the xmlrpcval object returned by the server. Might be an xml string or php value if the response has been created by specially configured xmlrpc_client objects * @access public */ function value() { return $this->val; } /** * Returns an array with the cookies received from the server. * Array has the form: $cookiename => array ('value' => $val, $attr1 => $val1, $attr2 = $val2, ...) * with attributes being e.g. 'expires', 'path', domain'. * NB: cookies sent as 'expired' by the server (i.e. with an expiry date in the past) * are still present in the array. It is up to the user-defined code to decide * how to use the received cookies, and wheter they have to be sent back with the next * request to the server (using xmlrpc_client::setCookie) or not * @return array array of cookies received from the server * @access public */ function cookies() { return $this->_cookies; } /** * Returns xml representation of the response. XML prologue not included * @param string $charset_encoding the charset to be used for serialization. if null, US-ASCII is assumed * @return string the xml representation of the response * @access public */ function serialize($charset_encoding='') { if ($charset_encoding != '') $this->content_type = 'text/xml; charset=' . $charset_encoding; else $this->content_type = 'text/xml'; $result = "
';
foreach($GLOBALS['_xh']['headers'] as $header => $value)
{
print htmlentities("HEADER: $header: $value\n");
}
foreach($GLOBALS['_xh']['cookies'] as $header => $value)
{
print htmlentities("COOKIE: $header={$value['value']}\n");
}
print "\n";
}
// if CURL was used for the call, http headers have been processed,
// and dechunking + reinflating have been carried out
if(!$headers_processed)
{
// Decode chunked encoding sent by http 1.1 servers
if(isset($GLOBALS['_xh']['headers']['transfer-encoding']) && $GLOBALS['_xh']['headers']['transfer-encoding'] == 'chunked')
{
if(!$data = decode_chunked($data))
{
error_log('XML-RPC: '.__METHOD__.': errors occurred when trying to rebuild the chunked data received from server');
$r = new xmlrpcresp(0, $GLOBALS['xmlrpcerr']['dechunk_fail'], $GLOBALS['xmlrpcstr']['dechunk_fail']);
return $r;
}
}
// Decode gzip-compressed stuff
// code shamelessly inspired from nusoap library by Dietrich Ayala
if(isset($GLOBALS['_xh']['headers']['content-encoding']))
{
$GLOBALS['_xh']['headers']['content-encoding'] = str_replace('x-', '', $GLOBALS['_xh']['headers']['content-encoding']);
if($GLOBALS['_xh']['headers']['content-encoding'] == 'deflate' || $GLOBALS['_xh']['headers']['content-encoding'] == 'gzip')
{
// if decoding works, use it. else assume data wasn't gzencoded
if(function_exists('gzinflate'))
{
if($GLOBALS['_xh']['headers']['content-encoding'] == 'deflate' && $degzdata = @gzuncompress($data))
{
$data = $degzdata;
if($this->debug)
print "---INFLATED RESPONSE---[".strlen($data)." chars]---\n" . htmlentities($data) . "\n---END---"; } elseif($GLOBALS['_xh']['headers']['content-encoding'] == 'gzip' && $degzdata = @gzinflate(substr($data, 10))) { $data = $degzdata; if($this->debug) print "
---INFLATED RESPONSE---[".strlen($data)." chars]---\n" . htmlentities($data) . "\n---END---"; } else { error_log('XML-RPC: '.__METHOD__.': errors occurred when trying to decode the deflated data received from server'); $r = new xmlrpcresp(0, $GLOBALS['xmlrpcerr']['decompress_fail'], $GLOBALS['xmlrpcstr']['decompress_fail']); return $r; } } else { error_log('XML-RPC: '.__METHOD__.': the server sent deflated data. Your php install must have the Zlib extension compiled in to support this.'); $r = new xmlrpcresp(0, $GLOBALS['xmlrpcerr']['cannot_decompress'], $GLOBALS['xmlrpcstr']['cannot_decompress']); return $r; } } } } // end of 'if needed, de-chunk, re-inflate response' // real stupid hack to avoid PHP complaining about returning NULL by ref $r = null; $r =& $r; return $r; } /** * Parse the xmlrpc response contained in the string $data and return an xmlrpcresp object. * @param string $data the xmlrpc response, eventually including http headers * @param bool $headers_processed when true prevents parsing HTTP headers for interpretation of content-encoding and consequent decoding * @param string $return_type decides return type, i.e. content of response->value(). Either 'xmlrpcvals', 'xml' or 'phpvals' * @return xmlrpcresp * @access public */ function &parseResponse($data='', $headers_processed=false, $return_type='xmlrpcvals') { if($this->debug) { //by maHo, replaced htmlspecialchars with htmlentities print "
---GOT---\n" . htmlentities($data) . "\n---END---\n"; } if($data == '') { error_log('XML-RPC: '.__METHOD__.': no response received from server.'); $r = new xmlrpcresp(0, $GLOBALS['xmlrpcerr']['no_data'], $GLOBALS['xmlrpcstr']['no_data']); return $r; } $GLOBALS['_xh']=array(); $raw_data = $data; // parse the HTTP headers of the response, if present, and separate them from data if(substr($data, 0, 4) == 'HTTP') { $r =& $this->parseResponseHeaders($data, $headers_processed); if ($r) { // failed processing of HTTP response headers // save into response obj the full payload received, for debugging $r->raw_data = $data; return $r; } } else { $GLOBALS['_xh']['headers'] = array(); $GLOBALS['_xh']['cookies'] = array(); } if($this->debug) { $start = strpos($data, '', $start); $comments = substr($data, $start, $end-$start); print "
---SERVER DEBUG INFO (DECODED) ---\n\t".htmlentities(str_replace("\n", "\n\t", base64_decode($comments)))."\n---END---\n";
}
}
// be tolerant of extra whitespace in response body
$data = trim($data);
/// @todo return an error msg if $data=='' ?
// be tolerant of junk after methodResponse (e.g. javascript ads automatically inserted by free hosts)
// idea from Luca Mariano ---PARSED---\n"; // somehow htmlentities chokes on var_export, and some full html string... //print htmlentitites(var_export($GLOBALS['_xh']['value'], true)); print htmlspecialchars(var_export($GLOBALS['_xh']['value'], true)); print "\n---END---"; } // note that using =& will raise an error if $GLOBALS['_xh']['st'] does not generate an object. $v =& $GLOBALS['_xh']['value']; if($GLOBALS['_xh']['isf']) { /// @todo we should test here if server sent an int and a string, /// and/or coerce them into such... if ($return_type == 'xmlrpcvals') { $errno_v = $v->structmem('faultCode'); $errstr_v = $v->structmem('faultString'); $errno = $errno_v->scalarval(); $errstr = $errstr_v->scalarval(); } else { $errno = $v['faultCode']; $errstr = $v['faultString']; } if($errno == 0) { // FAULT returned, errno needs to reflect that $errno = -1; } $r = new xmlrpcresp(0, $errno, $errstr); } else { $r=new xmlrpcresp($v, 0, '', $return_type); } } $r->hdrs = $GLOBALS['_xh']['headers']; $r->_cookies = $GLOBALS['_xh']['cookies']; $r->raw_data = $raw_data; return $r; } } class xmlrpcval { var $me=array(); var $mytype=0; var $_php_class=null; /** * @param mixed $val * @param string $type any valid xmlrpc type name (lowercase). If null, 'string' is assumed */ function xmlrpcval($val=-1, $type='') { /// @todo: optimization creep - do not call addXX, do it all inline. /// downside: booleans will not be coerced anymore if($val!==-1 || $type!='') { // optimization creep: inlined all work done by constructor switch($type) { case '': $this->mytype=1; $this->me['string']=$val; break; case 'i4': case 'int': case 'double': case 'string': case 'boolean': case 'dateTime.iso8601': case 'base64': case 'null': $this->mytype=1; $this->me[$type]=$val; break; case 'array': $this->mytype=2; $this->me['array']=$val; break; case 'struct': $this->mytype=3; $this->me['struct']=$val; break; default: error_log("XML-RPC: ".__METHOD__.": not a known type ($type)"); } /*if($type=='') { $type='string'; } if($GLOBALS['xmlrpcTypes'][$type]==1) { $this->addScalar($val,$type); } elseif($GLOBALS['xmlrpcTypes'][$type]==2) { $this->addArray($val); } elseif($GLOBALS['xmlrpcTypes'][$type]==3) { $this->addStruct($val); }*/ } } /** * Add a single php value to an (unitialized) xmlrpcval * @param mixed $val * @param string $type * @return int 1 or 0 on failure */ function addScalar($val, $type='string') { $typeof=@$GLOBALS['xmlrpcTypes'][$type]; if($typeof!=1) { error_log("XML-RPC: ".__METHOD__.": not a scalar type ($type)"); return 0; } // coerce booleans into correct values // NB: we should either do it for datetimes, integers and doubles, too, // or just plain remove this check, implemented on booleans only... if($type==$GLOBALS['xmlrpcBoolean']) { if(strcasecmp($val,'true')==0 || $val==1 || ($val==true && strcasecmp($val,'false'))) { $val=true; } else { $val=false; } } switch($this->mytype) { case 1: error_log('XML-RPC: '.__METHOD__.': scalar xmlrpcval can have only one value'); return 0; case 3: error_log('XML-RPC: '.__METHOD__.': cannot add anonymous scalar to struct xmlrpcval'); return 0; case 2: // we're adding a scalar value to an array here //$ar=$this->me['array']; //$ar[]=new xmlrpcval($val, $type); //$this->me['array']=$ar; // Faster (?) avoid all the costly array-copy-by-val done here... $this->me['array'][]=new xmlrpcval($val, $type); return 1; default: // a scalar, so set the value and remember we're scalar $this->me[$type]=$val; $this->mytype=$typeof; return 1; } } /** * Add an array of xmlrpcval objects to an xmlrpcval * @param array $vals * @return int 1 or 0 on failure * @access public * * @todo add some checking for $vals to be an array of xmlrpcvals? */ function addArray($vals) { if($this->mytype==0) { $this->mytype=$GLOBALS['xmlrpcTypes']['array']; $this->me['array']=$vals; return 1; } elseif($this->mytype==2) { // we're adding to an array here $this->me['array'] = array_merge($this->me['array'], $vals); return 1; } else { error_log('XML-RPC: '.__METHOD__.': already initialized as a [' . $this->kindOf() . ']'); return 0; } } /** * Add an array of named xmlrpcval objects to an xmlrpcval * @param array $vals * @return int 1 or 0 on failure * @access public * * @todo add some checking for $vals to be an array? */ function addStruct($vals) { if($this->mytype==0) { $this->mytype=$GLOBALS['xmlrpcTypes']['struct']; $this->me['struct']=$vals; return 1; } elseif($this->mytype==3) { // we're adding to a struct here $this->me['struct'] = array_merge($this->me['struct'], $vals); return 1; } else { error_log('XML-RPC: '.__METHOD__.': already initialized as a [' . $this->kindOf() . ']'); return 0; } } // poor man's version of print_r ??? // DEPRECATED! function dump($ar) { foreach($ar as $key => $val) { echo "$key => $val
"; if($key == 'array') { while(list($key2, $val2) = each($val)) { echo "-- $key2 => $val2
"; } } } } /** * Returns a string containing "struct", "array" or "scalar" describing the base type of the value * @return string * @access public */ function kindOf() { switch($this->mytype) { case 3: return 'struct'; break; case 2: return 'array'; break; case 1: return 'scalar'; break; default: return 'undef'; } } /** * @access private */ function serializedata($typ, $val, $charset_encoding='') { $rs=''; switch(@$GLOBALS['xmlrpcTypes'][$typ]) { case 1: switch($typ) { case $GLOBALS['xmlrpcBase64']: $rs.="<${typ}>" . base64_encode($val) . ""; break; case $GLOBALS['xmlrpcBoolean']: $rs.="<${typ}>" . ($val ? '1' : '0') . ""; break; case $GLOBALS['xmlrpcString']: // G. Giunta 2005/2/13: do NOT use htmlentities, since // it will produce named html entities, which are invalid xml $rs.="<${typ}>" . xmlrpc_encode_entitites($val, $GLOBALS['xmlrpc_internalencoding'], $charset_encoding). ""; break; case $GLOBALS['xmlrpcInt']: case $GLOBALS['xmlrpcI4']: $rs.="<${typ}>".(int)$val.""; break; case $GLOBALS['xmlrpcDouble']: // avoid using standard conversion of float to string because it is locale-dependent, // and also because the xmlrpc spec forbids exponential notation. // sprintf('%F') could be most likely ok but it fails eg. on 2e-14. // The code below tries its best at keeping max precision while avoiding exp notation, // but there is of course no limit in the number of decimal places to be used... $rs.="<${typ}>".preg_replace('/\\.?0+$/','',number_format((double)$val, 128, '.', '')).""; break; case $GLOBALS['xmlrpcDateTime']: if (is_string($val)) { $rs.="<${typ}>${val}"; } else if(is_a($val, 'DateTime')) { $rs.="<${typ}>".$val->format('Ymd\TH:i:s').""; } else if(is_int($val)) { $rs.="<${typ}>".strftime("%Y%m%dT%H:%M:%S", $val).""; } else { // not really a good idea here: but what shall we output anyway? left for backward compat... $rs.="<${typ}>${val}"; } break; case $GLOBALS['xmlrpcNull']: if ($GLOBALS['xmlrpc_null_apache_encoding']) { $rs.="
* {@link KlarnaFlags::CHECKOUT_PAGE}
* {@link KlarnaFlags::PRODUCT_PAGE}
* * @param float $sum The sum for the order/product. * @param KlarnaPClass $pclass KlarnaPClass used to calculate the APR. * @param int $flags Checkout or Product page. * * @throws KlarnaException * @return array An array of monthly payments. */ private static function _getPayArray($sum, $pclass, $flags) { $monthsfee = 0; if ($flags === KlarnaFlags::CHECKOUT_PAGE) { $monthsfee = $pclass->getInvoiceFee(); } $startfee = 0; if ($flags === KlarnaFlags::CHECKOUT_PAGE) { $startfee = $pclass->getStartFee(); } //Include start fee in sum $sum += $startfee; $base = ($pclass->getType() === KlarnaPClass::ACCOUNT); $lowest = self::get_lowest_payment_for_account($pclass->getCountry()); if ($flags == KlarnaFlags::CHECKOUT_PAGE) { $minpay = ($pclass->getType() === KlarnaPClass::ACCOUNT) ? $lowest : 0; } else { $minpay = 0; } $payment = self::_annuity( $sum, $pclass->getMonths(), $pclass->getInterestRate() ); //Add monthly fee $payment += $monthsfee; return self::_fulpacc( $sum, $pclass->getInterestRate(), $monthsfee, $minpay, $payment, $pclass->getMonths(), $base ); } /** * Calculates APR for the specified values.
* Result is rounded with two decimals.
* * Flags can be either:
* {@link KlarnaFlags::CHECKOUT_PAGE}
* {@link KlarnaFlags::PRODUCT_PAGE}
* * @param float $sum The sum for the order/product. * @param KlarnaPClass $pclass KlarnaPClass used to calculate the APR. * @param int $flags Checkout or Product page. * @param int $free Number of free months. * * @throws KlarnaException * @return float APR in % */ public static function calc_apr($sum, $pclass, $flags, $free = 0) { if (!is_numeric($sum)) { throw new Klarna_InvalidTypeException('sum', 'numeric'); } if (is_numeric($sum) && (!is_int($sum) || !is_float($sum))) { $sum = floatval($sum); } if (!($pclass instanceof KlarnaPClass)) { throw new Klarna_InvalidTypeException('pclass', 'KlarnaPClass'); } if (!is_numeric($free)) { throw new Klarna_InvalidTypeException('free', 'integer'); } if (is_numeric($free) && !is_int($free)) { $free = intval($free); } if ($free < 0) { throw new KlarnaException( 'Error in ' . __METHOD__ . ': Number of free months must be positive or zero!' ); } if (is_numeric($flags) && !is_int($flags)) { $flags = intval($flags); } if (!is_numeric($flags) || !in_array( $flags, array( KlarnaFlags::CHECKOUT_PAGE, KlarnaFlags::PRODUCT_PAGE ) ) ) { throw new Klarna_InvalidTypeException( 'flags', KlarnaFlags::CHECKOUT_PAGE . ' or ' . KlarnaFlags::PRODUCT_PAGE ); } $monthsfee = 0; if ($flags === KlarnaFlags::CHECKOUT_PAGE) { $monthsfee = $pclass->getInvoiceFee(); } $startfee = 0; if ($flags === KlarnaFlags::CHECKOUT_PAGE) { $startfee = $pclass->getStartFee(); } //Include start fee in sum $sum += $startfee; $lowest = self::get_lowest_payment_for_account($pclass->getCountry()); if ($flags == KlarnaFlags::CHECKOUT_PAGE) { $minpay = ($pclass->getType() === KlarnaPClass::ACCOUNT) ? $lowest : 0; } else { $minpay = 0; } //add monthly fee $payment = self::_annuity( $sum, $pclass->getMonths(), $pclass->getInterestRate() ) + $monthsfee; $type = $pclass->getType(); switch($type) { case KlarnaPClass::CAMPAIGN: case KlarnaPClass::ACCOUNT: return round( self::_aprAnnuity( $sum, $pclass->getMonths(), $pclass->getInterestRate(), $pclass->getInvoiceFee(), $minpay ), 2 ); case KlarnaPClass::SPECIAL: throw new Klarna_PClassException( 'Method is not available for SPECIAL pclasses' ); case KlarnaPClass::FIXED: throw new Klarna_PClassException( 'Method is not available for FIXED pclasses' ); default: throw new Klarna_PClassException( 'Unknown PClass type! ('.$type.')' ); } } /** * Calculates the total credit purchase cost.
* The result is rounded up, depending on the pclass country.
* * Flags can be either:
* {@link KlarnaFlags::CHECKOUT_PAGE}
* {@link KlarnaFlags::PRODUCT_PAGE}
* * @param float $sum The sum for the order/product. * @param KlarnaPClass $pclass PClass used to calculate total credit cost. * @param int $flags Checkout or Product page. * * @throws KlarnaException * @return float Total credit purchase cost. */ public static function total_credit_purchase_cost($sum, $pclass, $flags) { if (!is_numeric($sum)) { throw new Klarna_InvalidTypeException('sum', 'numeric'); } if (is_numeric($sum) && (!is_int($sum) || !is_float($sum))) { $sum = floatval($sum); } if (!($pclass instanceof KlarnaPClass)) { throw new Klarna_InvalidTypeException('pclass', 'KlarnaPClass'); } if (is_numeric($flags) && !is_int($flags)) { $flags = intval($flags); } if (!is_numeric($flags) || !in_array( $flags, array( KlarnaFlags::CHECKOUT_PAGE, KlarnaFlags::PRODUCT_PAGE ) ) ) { throw new Klarna_InvalidTypeException( 'flags', KlarnaFlags::CHECKOUT_PAGE . ' or ' . KlarnaFlags::PRODUCT_PAGE ); } $payarr = self::_getPayArray($sum, $pclass, $flags); $credit_cost = 0; foreach ($payarr as $pay) { $credit_cost += $pay; } return self::pRound($credit_cost, $pclass->getCountry()); } /** * Calculates the monthly cost for the specified pclass. * The result is rounded up to the correct value depending on the * pclass country.
* * Example:
*
-
*
- In product view, round monthly cost with max 0.5 or 0.1
* depending on currency.
*-
*
- 10.50 SEK rounds to 11 SEK *
- 10.49 SEK rounds to 10 SEK *
- 8.55 EUR rounds to 8.6 EUR *
- 8.54 EUR rounds to 8.5 EUR *
* -
* In checkout, round the monthly cost to have 2 decimals.
* For example 10.57 SEK/per månad *
*
* {@link KlarnaFlags::CHECKOUT_PAGE}
* {@link KlarnaFlags::PRODUCT_PAGE}
* * @param int $sum The sum for the order/product. * @param KlarnaPClass $pclass PClass used to calculate monthly cost. * @param int $flags Checkout or product page. * * @throws KlarnaException * @return float The monthly cost. */ public static function calc_monthly_cost($sum, $pclass, $flags) { if (!is_numeric($sum)) { throw new Klarna_InvalidTypeException('sum', 'numeric'); } if (is_numeric($sum) && (!is_int($sum) || !is_float($sum))) { $sum = floatval($sum); } if (!($pclass instanceof KlarnaPClass)) { throw new Klarna_InvalidTypeException('pclass', 'KlarnaPClass'); } if (is_numeric($flags) && !is_int($flags)) { $flags = intval($flags); } if (!is_numeric($flags) || !in_array( $flags, array( KlarnaFlags::CHECKOUT_PAGE, KlarnaFlags::PRODUCT_PAGE ) ) ) { throw new Klarna_InvalidTypeException( 'flags', KlarnaFlags::CHECKOUT_PAGE . ' or ' . KlarnaFlags::PRODUCT_PAGE ); } $payarr = self::_getPayArray($sum, $pclass, $flags); $value = 0; if (isset($payarr[0])) { $value = $payarr[0]; } if (KlarnaFlags::CHECKOUT_PAGE == $flags) { return round($value, 2); } return self::pRound($value, $pclass->getCountry()); } /** * Returns the lowest monthly payment for Klarna Account. * * @param int $country KlarnaCountry constant. * * @throws KlarnaException * @return int|float Lowest monthly payment. */ public static function get_lowest_payment_for_account($country) { $country = KlarnaCountry::getCode($country); switch (strtoupper($country)) { case "SE": return 50.0; case "NO": return 95.0; case "FI": return 8.95; case "DK": return 89.0; case "DE": case "AT": return 6.95; case "NL": return 5.0; default: throw new KlarnaException("Invalid country {$country}"); } } /** * Rounds a value depending on the specified country. * * @param int|float $value The value to be rounded. * @param int $country KlarnaCountry constant. * * @return float|int */ public static function pRound($value, $country) { $multiply = 1; //Round to closest integer $country = KlarnaCountry::getCode($country); switch($country) { case "FI": case "DE": case "NL": case "AT": $multiply = 10; //Round to closest decimal break; } return floor(($value*$multiply)+0.5)/$multiply; } } index.html 0000666 00000000057 15137552047 0006560 0 ustar 00 pclasses/storage.intf.php 0000666 00000014166 15137552047 0011522 0 ustar 00 * @copyright 2012 Klarna AB (http://klarna.com) * @license http://opensource.org/licenses/BSD-2-Clause BSD-2 * @link http://integration.klarna.com/ */ /** * KlarnaPClass Storage interface * * This class provides an interface with which to save the PClasses easily. * * @category Payment * @package KlarnaAPI * @author MS Dev
* {@link KlarnaPClass::ACCOUNT}
* {@link KlarnaPClass::CAMPAIGN}
* {@link KlarnaPClass::SPECIAL}
* {@link KlarnaPClass::DELAY}
* {@link KlarnaPClass::MOBILE}
* * @param int $eid Merchant ID. * @param int $country {@link KlarnaCountry Country} constant. * @param int $type PClass type identifier. * * @throws KlarnaException * @return array An array of {@link KlarnaPClass PClasses}. */ public function getPClasses($eid, $country, $type = null) { if (!is_int($country)) { throw new Klarna_ArgumentNotSetException('country'); } $tmp = false; if (!is_array($this->pclasses)) { return; } $tmp = array(); foreach ($this->pclasses as $eid => $pclasses) { $tmp[$eid] = array(); foreach ($pclasses as $pclass) { if (!$pclass->isValid()) { continue; //Pclass invalid, skip it. } if ($pclass->getEid() === $eid && $pclass->getCountry() === $country && ($pclass->getType() === $type || $type === null) ) { $tmp[$eid][$pclass->getId()] = $pclass; } } } return $tmp; } /** * Returns a flattened array of all pclasses * * @return array */ public function getAllPClasses() { if (!is_array($this->pclasses)) { return array(); } return $this->_flatten(array_values($this->pclasses)); } /** * Flatten an array * * @param array $array array to flatten * * @return array */ private function _flatten($array) { if (!is_array($array)) { // nothing to do if it's not an array return array($array); } $result = array(); foreach ($array as $value) { // explode the sub-array, and add the parts $result = array_merge($result, $this->_flatten($value)); } return $result; } /** * Loads the PClasses and calls {@link self::addPClass()} to store them * in runtime. * URI can be location to a file, or a db prefixed table. * * @param string $uri URI to stored PClasses. * * @throws KlarnaException|Exception * @return void */ abstract public function load($uri); /** * Takes the internal PClass array and stores it. * URI can be location to a file, or a db prefixed table. * * @param string $uri URI to stored PClasses. * * @throws KlarnaException|Exception * @return void */ abstract public function save($uri); /** * Removes the internally stored pclasses. * * @param string $uri URI to stored PClasses. * * @throws KlarnaException|Exception * @return void */ abstract public function clear($uri); } pclasses/index.html 0000666 00000000057 15137552047 0010375 0 ustar 00 pclasses/xmlstorage.class.php 0000666 00000017070 15137552047 0012405 0 ustar 00 * @copyright 2012 Klarna AB (http://klarna.com) * @license http://opensource.org/licenses/BSD-2-Clause BSD-2 * @link http://integration.klarna.com/ */ /** * Include the {@link PCStorage} interface. */ require_once 'storage.intf.php'; /** * XML storage class for KlarnaPClass * * This class is an XML implementation of the PCStorage interface. * * @category Payment * @package KlarnaAPI * @author MS Dev
* Config field pcURI needs to match format: * user:passwd@addr:port/dbName.dbTable
* Port can be omitted.
* * Acceptable characters:
* Username: [A-Za-z0-9_]
* Password: [A-Za-z0-9_]
* Address: [A-Za-z0-9_.]
* Port: [0-9]
* DB name: [A-Za-z0-9_]
* DB table: [A-Za-z0-9_]
* * To allow for more special characters, and to avoid having
* a regular expression that is too hard to understand, you can
* use an associative array:
*
* array(
* "user" => "myuser",
* "passwd" => "mypass",
* "dsn" => "localhost",
* "db" => "mydatabase",
* "table" => "mytable"
* );
*
*
* @category Payment
* @package KlarnaAPI
* @author MS Dev * user:passwd@addr/dbName.dbTable (assumes MySQL)
* user:password@pdo:dsn/dbName.dbTable
* * To allow for more special characters, and to avoid having
* a regular expression that is too hard to understand, you can
* use an associative array:
*
* array(
* "user" => "myuser",
* "passwd" => "mypass",
* "dsn" => "localhost",
* "db" => "mydatabase",
* "table" => "mytable"
* );
*
*
* @param string|array $uri Specified URI to database and table.
*
* @throws KlarnaException
* @return void
*/
protected function splitURI($uri)
{
/* If you want to have some characters that would make the
regexp too complex, you can use an array as input instead. */
if (is_array($uri)) {
$this->user = $uri['user'];
$this->passwd = $uri['passwd'];
$this->dsn = $uri['dsn'];
$this->dbName = $uri['db'];
$this->dbTable = $uri['table'];
return array(
$uri,
$this->user,
$this->passwd,
$this->dsn,
$this->dbName,
$this->dbTable
);
}
$pdo_rex
= '/^([\w-]+):([\w-]+)@pdo:([\w.,:;\/ \\\t=\(\){}\*-]+)\/([\w-]+)'.
'.([\w-]+)$/';
$pcuri_rex
= '/^([\w-]+):([\w-]+)@([\w\.-]+|[\w\.-]+:[\d]+|[\w\.-]+:'.
'[\w\.\/-]+|:[\w\.\/-]+)\/([\w-]+).([\w-]+)$/';
$arr = null;
if (preg_match($pdo_rex, $uri, $arr) === 1) {
/*
* [0] => user:password@pdo:dsn/dbName.dbTable
* [1] => user
* [2] => passwd
* [3] => dsn
* [4] => dbName
* [5] => dbTable
*/
if (count($arr) != 6) {
throw new Klarna_DatabaseException(
'URI is invalid! Missing field or invalid characters used!'
);
}
$this->user = $arr[1];
$this->passwd = $arr[2];
$this->dsn = $arr[3];
$this->dbName = $arr[4];
$this->dbTable = $arr[5];
} else if (preg_match($pcuri_rex, $uri, $arr) === 1) {
//user:pass@127.0.0.1:3306/dbName.dbTable
//user:pass@localhost:/tmp/mysql.sock/dbName.dbTable
/*
* [0] => user:passwd@addr/dbName.dbTable
* [1] => user
* [2] => passwd
* [3] => addr
* [4] => dbName
* [5] => dbTable
*/
if (count($arr) != 6) {
throw new Klarna_DatabaseException(
'URI is invalid! Missing field or invalid characters used!'
);
}
$this->user = $arr[1];
$this->passwd = $arr[2];
$this->addr = $arr[3];
$this->port = 3306;
if (preg_match(
'/^([0-9.]+(:([0-9]+))?)$/', $this->addr, $tmp
) === 1
) {
if (isset($tmp[3])) {
$this->port = $tmp[3];
}
}
$this->dbName = $arr[4];
$this->dbTable = $arr[5];
$this->dsn = "mysql:host={$this->addr};port={$this->port};";
} else {
throw new Klarna_DatabaseException(
'URI to SQL is not valid! ( user:passwd@addr/dbName.dbTable )'
);
}
return $arr;
}
/**
* Grabs the PDO connection to the database, specified by the URI.
*
* @param string $uri pclass uri
*
* @return void
* @throws KlarnaException
*/
protected function getConnection($uri)
{
if ($this->pdo) {
return; //Already have a connection
}
$this->splitURI($uri);
try {
$this->pdo = new PDO($this->dsn, $this->user, $this->passwd);
$this->pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
throw new Klarna_DatabaseException('Failed to connect to database!');
}
}
/**
* Initializes the DB, if the database or table is missing.
*
* @return void
* @throws KlarnaException
*/
protected function initDB()
{
try {
$this->pdo->exec("CREATE DATABASE `{$this->dbName}`");
} catch (PDOException $e) {
//SQLite does not support this...
//throw new KlarnaException(
// 'Database non-existant, failed to create it!'
//);
}
$sql = <<* Config field pcURI needs to match format: * user:passwd@addr:port/dbName.dbTable
* Port can be omitted.
* * Acceptable characters:
* Username: [A-Za-z0-9_]
* Password: [A-Za-z0-9_]
* Address: [A-Za-z0-9_.]
* Port: [0-9]
* DB name: [A-Za-z0-9_]
* DB table: [A-Za-z0-9_]
* * To allow for more special characters, and to avoid having
* a regular expression that is too hard to understand, you can
* use an associative array:
*
* array(
* "user" => "myuser",
* "passwd" => "mypass",
* "dsn" => "localhost",
* "db" => "mydatabase",
* "table" => "mytable"
* );
*
*
* @category Payment
* @package KlarnaAPI
* @author MS Dev * * To allow for more special characters, and to avoid having
* a regular expression that is too hard to understand, you can
* use an associative array:
*
* array(
* "user" => "myuser",
* "passwd" => "mypass",
* "dsn" => "localhost",
* "db" => "mydatabase",
* "table" => "mytable"
* );
*
*
* @param string|array $uri Specified URI to database and table.
*
* @throws KlarnaException
* @return void
*/
protected function splitURI($uri)
{
if (is_array($uri)) {
$this->user = $uri['user'];
$this->passwd = $uri['passwd'];
$this->addr = $uri['dsn'];
$this->dbName = $uri['db'];
$this->dbTable = $uri['table'];
} else if (preg_match(
'/^([\w-]+):([\w-]+)@([\w\.-]+|[\w\.-]+:[\d]+)\/([\w-]+).([\w-]+)$/',
$uri,
$arr
) === 1
) {
/*
[0] => user:passwd@addr/dbName.dbTable
[1] => user
[2] => passwd
[3] => addr
[4] => dbName
[5] => dbTable
*/
if (count($arr) != 6) {
throw new Klarna_DatabaseException(
'URI is invalid! Missing field or invalid characters used!'
);
}
$this->user = $arr[1];
$this->passwd = $arr[2];
$this->addr = $arr[3];
$this->dbName = $arr[4];
$this->dbTable = $arr[5];
} else {
throw new Klarna_DatabaseException(
'URI to MySQL is not valid! ( user:passwd@addr/dbName.dbTable )'
);
}
}
/**
* Load pclasses
*
* @param string $uri pclass uri
*
* @throws KlarnaException
* @return void
*/
public function load($uri)
{
$this->splitURI($uri);
$this->connect();
$result = mysql_query(
"SELECT * FROM `{$this->dbName}`.`{$this->dbTable}`",
$this->link
);
if ($result === false) {
throw new Klarna_DatabaseException(
'SELECT query failed! ('.mysql_error().')'
);
}
while ($row = mysql_fetch_assoc($result)) {
$this->addPClass(new KlarnaPClass($row));
}
}
/**
* Save pclasses to database
*
* @param string $uri pclass uri
*
* @throws KlarnaException
* @return void
*/
public function save($uri)
{
$this->splitURI($uri);
$this->connect();
if (!is_array($this->pclasses) || count($this->pclasses) == 0) {
return;
}
foreach ($this->pclasses as $pclasses) {
foreach ($pclasses as $pclass) {
//Remove the pclass if it exists.
mysql_query(
"DELETE FROM `{$this->dbName}`.`{$this->dbTable}`
WHERE `id` = '{$pclass->getId()}'
AND `eid` = '{$pclass->getEid()}'"
);
//Insert it again.
$result = mysql_query(
"INSERT INTO `{$this->dbName}`.`{$this->dbTable}`
(`eid`,
`id`,
`type`,
`description`,
`months`,
`interestrate`,
`invoicefee`,
`startfee`,
`minamount`,
`country`,
`expire`
)
VALUES
('{$pclass->getEid()}',
'{$pclass->getId()}',
'{$pclass->getType()}',
'{$pclass->getDescription()}',
'{$pclass->getMonths()}',
'{$pclass->getInterestRate()}',
'{$pclass->getInvoiceFee()}',
'{$pclass->getStartFee()}',
'{$pclass->getMinAmount()}',
'{$pclass->getCountry()}',
'{$pclass->getExpire()}')", $this->link
);
if ($result === false) {
throw new Klarna_DatabaseException(
'INSERT INTO query failed! ('.mysql_error().')'
);
}
}
}
}
/**
* Clear the pclasses
*
* @param string $uri pclass uri
*
* @throws KlarnaException
* @return void
*/
public function clear($uri)
{
try {
$this->splitURI($uri);
unset($this->pclasses);
$this->connect();
mysql_query(
"DELETE FROM `{$this->dbName}`.`{$this->dbTable}`",
$this->link
);
} catch(Exception $e) {
throw new Klarna_DatabaseException(
$e->getMessage(), $e->getCode()
);
}
}
}
pclasses/.htaccess 0000666 00000000177 15137552047 0010201 0 ustar 00 * Loads/saves specified file, or default file, if {@link KlarnaConfig::$store} * is set to true.
* * You add settings using the ArrayAccess:
* $arr['field'] = $val or $arr->offsetSet('field', $val);
* * Available settings are:
* eid - Merchant ID (int) * secret - Shared secret (string) * country - Country constant or code (int|string) * language - Language constant or code (int|string) * currency - Currency constant or code (int|string) * mode - Klarna::BETA or Klarna::LIVE * ssl - Use HTTPS or HTTP. (bool) * candice - Status reporting to Klarna, to detect erroneous * integrations, etc. (bool) * pcStorage - Storage module, e.g. 'json' * pcURI - URI to where the PClasses are stored, e.g. * '/srv/shop/pclasses.json' * xmlrpcDebug - XMLRPC debugging (bool) * debug - Normal debugging (bool) * * @category Payment * @package KlarnaAPI * @author MS Dev
* This has no effect on transmitted data. * * @var bool|null */ public $isCompany = null; /** * Class constructor. * * Calls the set methods for all arguments. * * @param string $email Email address. * @param string $telno Phone number. * @param string $cellno Cellphone number. * @param string $fname First name. * @param string $lname Last name. * @param string $careof Care of, C/O. * @param string $street Street address. * @param string $zip Zip code. * @param string $city City. * @param string|int $country KlarnaCountry constant or two letter code. * @param string $houseNo House number, only used in DE and NL. * @param string $houseExt House extension, only used in NL. * * @throws KlarnaException */ public function __construct( $email = null, $telno = null, $cellno = null, $fname = null, $lname = null, $careof = "", $street = null, $zip = null, $city = null, $country = null, $houseNo = "", $houseExt = "" ) { //Set all string values to "" $this->company = ""; $this->telno = ""; $this->careof = ""; $this->cellno = ""; $this->city = ""; $this->email = ""; $this->fname = ""; $this->lname = ""; $this->zip = ""; if ($email !== null) { $this->setEmail($email); } if ($telno !== null) { $this->setTelno($telno); } if ($cellno !== null) { $this->setCellno($cellno); } if ($fname !== null) { $this->setFirstName($fname); } if ($lname !== null) { $this->setLastName($lname); } $this->setCareof($careof); if ($street !== null) { $this->setStreet($street); } if ($zip !== null) { $this->setZipCode($zip); } if ($city !== null) { $this->setCity($city); } if ($country !== null) { $this->setCountry($country); } $this->setHouseNumber($houseNo); $this->setHouseExt($houseExt); } /** * Returns the email address. * * @return string */ public function getEmail() { return $this->email; } /** * Sets the email address. * * @param string $email email address * * @return void */ public function setEmail($email) { if (!is_string($email)) { $email = strval($email); } $this->email = $email; } /** * Returns the phone number. * * @return string */ public function getTelno() { return $this->telno; } /** * Sets the phone number. * * @param string $telno telno * * @return void */ public function setTelno($telno) { if (!is_string($telno)) { $telno = strval($telno); } $this->telno = $telno; } /** * Returns the cellphone number. * * @return string */ public function getCellno() { return $this->cellno; } /** * Sets the cellphone number. * * @param string $cellno mobile number * * @return void */ public function setCellno($cellno) { if (!is_string($cellno)) { $cellno = strval($cellno); } $this->cellno = $cellno; } /** * Returns the first name. * * @return string */ public function getFirstName() { return $this->fname; } /** * Sets the first name. * * @param string $fname firstname * * @return void */ public function setFirstName($fname) { if (!is_string($fname)) { $fname = strval($fname); } $this->fname = $fname; } /** * Returns the last name. * * @return string */ public function getLastName() { return $this->lname; } /** * Sets the last name. * * @param string $lname lastname * * @return void */ public function setLastName($lname) { if (!is_string($lname)) { $lname = strval($lname); } $this->lname = $lname; } /** * Returns the company name. * * @return string */ public function getCompanyName() { return $this->company; } /** * Sets the company name. * If the purchase results in a company purchase, * reference person will be used from first and last name, * or the value set with {@link Klarna::setReference()}. * * @param string $company company name * * @see Klarna::setReference * @return void */ public function setCompanyName($company) { if (!is_string($company)) { $company = strval($company); } $this->company = $company; } /** * Returns the care of, C/O. * * @return string */ public function getCareof() { return $this->careof; } /** * Sets the care of, C/O. * * @param string $careof care of address * * @return void */ public function setCareof($careof) { if (!is_string($careof)) { $careof = strval($careof); } $this->careof = $careof; } /** * Returns the street address. * * @return string */ public function getStreet() { return $this->street; } /** * Sets the street address. * * @param string $street street address * * @return void */ public function setStreet($street) { if (!is_string($street)) { $street = strval($street); } $this->street = $street; } /** * Returns the zip code. * * @return string */ public function getZipCode() { return $this->zip; } /** * Sets the zip code. * * @param string $zip zip code * * @return void */ public function setZipCode($zip) { if (!is_string($zip)) { $zip = strval($zip); } $zip = str_replace(' ', '', $zip); //remove spaces $this->zip = $zip; } /** * Returns the city. * * @return string */ public function getCity() { return $this->city; } /** * Sets the city. * * @param string $city city * * @return void */ public function setCity($city) { if (!is_string($city)) { $city = strval($city); } $this->city = $city; } /** * Returns the country as a integer constant. * * @return int {@link KlarnaCountry} */ public function getCountry() { return $this->country; } /** * Returns the country as a two letter representation. * * @throws KlarnaException * @return string E.g. 'de', 'dk', ... */ public function getCountryCode() { return KlarnaCountry::getCode($this->country); } /** * Sets the country, use either a two letter representation or the integer * constant. * * @param int $country {@link KlarnaCountry} * * @throws KlarnaException * @return void */ public function setCountry($country) { if ($country === null) { throw new Klarna_ArgumentNotSetException('Country'); } if (is_numeric($country)) { if (!is_int($country)) { $country = intval($country); } $this->country = $country; return; } if (strlen($country) == 2 || strlen($country) == 3) { $this->setCountry(KlarnaCountry::fromCode($country)); return; } throw new KlarnaException("Failed to set country! ($country)"); } /** * Returns the house number.
* Only used in Germany and Netherlands.
* * @return string */ public function getHouseNumber() { return $this->houseNo; } /** * Sets the house number.
* Only used in Germany and Netherlands.
* * @param string $houseNo house number * * @return void */ public function setHouseNumber($houseNo) { if (!is_string($houseNo)) { $houseNo = strval($houseNo); } $this->houseNo = $houseNo; } /** * Returns the house extension.
* Only used in Netherlands.
* * @return string */ public function getHouseExt() { return $this->houseExt; } /** * Sets the house extension.
* Only used in Netherlands.
* * @param string $houseExt house extension * * @return void */ public function setHouseExt($houseExt) { if (!is_string($houseExt)) { $houseExt = strval($houseExt); } $this->houseExt = $houseExt; } /** * Returns an associative array representing this object. * * @return array */ public function toArray() { return array( 'email' => $this->getEmail(), 'telno' => $this->getTelno(), 'cellno' => $this->getCellno(), 'fname' => $this->getFirstName(), 'lname' => $this->getLastName(), 'company' => $this->getCompanyName(), 'careof' => $this->getCareof(), 'street' => $this->getStreet(), 'house_number' => $this->getHouseNumber(), 'house_extension' => $this->getHouseExt(), 'zip' => $this->getZipCode(), 'city' => $this->getCity(), 'country' => $this->getCountry(), ); } } Country.php 0000666 00000053276 15137552047 0006752 0 ustar 00 * @copyright 2012 Klarna AB (http://klarna.com) * @license http://opensource.org/licenses/BSD-2-Clause BSD-2 * @link http://integration.klarna.com/ */ /** * Country Constants class * * @category Payment * @package KlarnaAPI * @author MS Dev
* ISO3166_AT * * @var int */ const AT = 15; /** * Country constant for Denmark (DK).
* ISO3166_DK * * @var int */ const DK = 59; /** * Country constant for Finland (FI).
* ISO3166_FI * * @var int */ const FI = 73; /** * Country constant for Germany (DE).
* ISO3166_DE * * @var int */ const DE = 81; /** * Country constant for Netherlands (NL).
* ISO3166_NL * * @var int */ const NL = 154; /** * Country constant for Norway (NO).
* ISO3166_NO * * @var int */ const NO = 164; /** * Country constant for Sweden (SE).
* ISO3166_SE * * @var int */ const SE = 209; /** * Converts a country code, e.g. 'de' or 'deu' to the KlarnaCountry constant. * * @param string $val country code iso-alpha-2 or iso-alpha-3 * * @return int|null */ public static function fromCode($val) { $val = strtoupper($val); if (strlen($val) === 3) { if (self::$_tlcFlip === array()) { self::$_tlcFlip = array_flip(self::$_tlcMap); } if (!array_key_exists($val, self::$_tlcFlip)) { return null; } $val = self::$_tlcFlip[$val]; } if (array_key_exists($val, self::$_countries)) { return self::$_countries[$val]; } return null; } /** * Converts a KlarnaCountry constant to the respective country code. * * @param int $val KlarnaCountry constant * @param bool $alpha3 Whether to return a ISO-3166-1 alpha-3 code * * @return string|null */ public static function getCode($val, $alpha3 = false) { if (self::$_countryFlip === array()) { self::$_countryFlip = array_flip(self::$_countries); } if (!array_key_exists($val, self::$_countryFlip)) { return null; } $result = self::$_countryFlip[$val]; if ($alpha3) { return self::$_tlcMap[$result]; } return $result; } /** * Checks country against currency and returns true if they match. * * @param int $country {@link KlarnaCountry} * @param int $language {@link KlarnaLanguage} * * @deprecated Do not use. * * @return bool */ public static function checkLanguage($country, $language) { switch($country) { case KlarnaCountry::AT: case KlarnaCountry::DE: return ($language === KlarnaLanguage::DE); case KlarnaCountry::NL: return ($language === KlarnaLanguage::NL); case KlarnaCountry::FI: return ($language === KlarnaLanguage::FI); case KlarnaCountry::DK: return ($language === KlarnaLanguage::DA); case KlarnaCountry::NO: return ($language === KlarnaLanguage::NB); case KlarnaCountry::SE: return ($language === KlarnaLanguage::SV); default: //Country not yet supported by Klarna. return false; } } /** * Checks country against language and returns true if they match. * * @param int $country {@link KlarnaCountry} * @param int $currency {@link KlarnaCurrency} * * @deprecated Do not use. * * @return bool */ public static function checkCurrency($country, $currency) { switch($country) { case KlarnaCountry::AT: case KlarnaCountry::DE: case KlarnaCountry::NL: case KlarnaCountry::FI: return ($currency === KlarnaCurrency::EUR); case KlarnaCountry::DK: return ($currency === KlarnaCurrency::DKK); case KlarnaCountry::NO: return ($currency === KlarnaCurrency::NOK); case KlarnaCountry::SE: return ($currency === KlarnaCurrency::SEK); default: //Country not yet supported by Klarna. return false; } } /** * Get language for supplied country. Defaults to English. * * @param int $country KlarnaCountry constant * * @deprecated Do not use. * * @return int */ public static function getLanguage($country) { switch($country) { case KlarnaCountry::AT: case KlarnaCountry::DE: return KlarnaLanguage::DE; case KlarnaCountry::NL: return KlarnaLanguage::NL; case KlarnaCountry::FI: return KlarnaLanguage::FI; case KlarnaCountry::DK: return KlarnaLanguage::DA; case KlarnaCountry::NO: return KlarnaLanguage::NB; case KlarnaCountry::SE: return KlarnaLanguage::SV; default: return KlarnaLanguage::EN; } } /** * Get currency for supplied country * * @param int $country KlarnaCountry constant * * @deprecated Do not use. * * @return int|false */ public static function getCurrency($country) { switch($country) { case KlarnaCountry::AT: case KlarnaCountry::DE: case KlarnaCountry::NL: case KlarnaCountry::FI: return KlarnaCurrency::EUR; case KlarnaCountry::DK: return KlarnaCurrency::DKK; case KlarnaCountry::NO: return KlarnaCurrency::NOK; case KlarnaCountry::SE: return KlarnaCurrency::SEK; default: return false; } } private static $_tlcFlip = array(); /** * Cache for the flipped country array * * @var array */ private static $_countryFlip = array(); /** * Array containing all countries and their KRED Code * * @var array */ private static $_countries = array( 'AF' => 1, // AFGHANISTAN 'AX' => 2, // ÅLAND ISLANDS 'AL' => 3, // ALBANIA 'DZ' => 4, // ALGERIA 'AS' => 5, // AMERICAN SAMOA 'AD' => 6, // ANDORRA 'AO' => 7, // ANGOLA 'AI' => 8, // ANGUILLA 'AQ' => 9, // ANTARCTICA 'AG' => 10, // ANTIGUA AND BARBUDA 'AR' => 11, // ARGENTINA 'AM' => 12, // ARMENIA 'AW' => 13, // ARUBA 'AU' => 14, // AUSTRALIA 'AT' => 15, // AUSTRIA 'AZ' => 16, // AZERBAIJAN 'BS' => 17, // BAHAMAS 'BH' => 18, // BAHRAIN 'BD' => 19, // BANGLADESH 'BB' => 20, // BARBADOS 'BY' => 21, // BELARUS 'BE' => 22, // BELGIUM 'BZ' => 23, // BELIZE 'BJ' => 24, // BENIN 'BM' => 25, // BERMUDA 'BT' => 26, // BHUTAN 'BO' => 27, // BOLIVIA 'BA' => 28, // BOSNIA AND HERZEGOVINA 'BW' => 29, // BOTSWANA 'BV' => 30, // BOUVET ISLAND 'BR' => 31, // BRAZIL 'IO' => 32, // BRITISH INDIAN OCEAN TERRITORY 'BN' => 33, // BRUNEI DARUSSALAM 'BG' => 34, // BULGARIA 'BF' => 35, // BURKINA FASO 'BI' => 36, // BURUNDI 'KH' => 37, // CAMBODIA 'CM' => 38, // CAMEROON 'CA' => 39, // CANADA 'CV' => 40, // CAPE VERDE 'KY' => 41, // CAYMAN ISLANDS 'CF' => 42, // CENTRAL AFRICAN REPUBLIC 'TD' => 43, // CHAD 'CL' => 44, // CHILE 'CN' => 45, // CHINA 'CX' => 46, // CHRISTMAS ISLAND 'CC' => 47, // COCOS (KEELING) ISLANDS 'CO' => 48, // COLOMBIA 'KM' => 49, // COMOROS 'CG' => 50, // CONGO 'CD' => 51, // CONGO, THE DEMOCRATIC REPUBLIC OF THE 'CK' => 52, // COOK ISLANDS 'CR' => 53, // COSTA RICA 'CI' => 54, // COTE D'IVOIRE 'HR' => 55, // CROATIA 'CU' => 56, // CUBA 'CY' => 57, // CYPRUS 'CZ' => 58, // CZECH REPUBLIC 'DK' => 59, // DENMARK 'DJ' => 60, // DJIBOUTI 'DM' => 61, // DOMINICA 'DO' => 62, // DOMINICAN REPUBLIC 'EC' => 63, // ECUADOR 'EG' => 64, // EGYPT 'SV' => 65, // EL SALVADOR 'GQ' => 66, // EQUATORIAL GUINEA 'ER' => 67, // ERITREA 'EE' => 68, // ESTONIA 'ET' => 69, // ETHIOPIA 'FK' => 70, // FALKLAND ISLANDS (MALVINAS) 'FO' => 71, // FAROE ISLANDS 'FJ' => 72, // FIJI 'FI' => 73, // FINLAND 'FR' => 74, // FRANCE 'GF' => 75, // FRENCH GUIANA 'PF' => 76, // FRENCH POLYNESIA 'TF' => 77, // FRENCH SOUTHERN TERRITORIES 'GA' => 78, // GABON 'GM' => 79, // GAMBIA 'GE' => 80, // GEORGIA 'DE' => 81, // GERMANY 'GH' => 82, // GHANA 'GI' => 83, // GIBRALTAR 'GR' => 84, // GREECE 'GL' => 85, // GREENLAND 'GD' => 86, // GRENADA 'GP' => 87, // GUADELOUPE 'GU' => 88, // GUAM 'GT' => 89, // GUATEMALA 'GG' => 90, // GUERNSEY 'GN' => 91, // GUINEA 'GW' => 92, // GUINEA-BISSAU 'GY' => 93, // GUYANA 'HT' => 94, // HAITI 'HM' => 95, // HEARD ISLAND AND MCDONALD ISLANDS 'VA' => 96, // HOLY SEE (VATICAN CITY STATE) 'HN' => 97, // HONDURAS 'HK' => 98, // HONG KONG 'HU' => 99, // HUNGARY 'IS' => 100, // ICELAND 'IN' => 101, // INDIA 'ID' => 102, // INDONESIA 'IR' => 103, // IRAN, ISLAMIC REPUBLIC OF 'IQ' => 104, // IRAQ 'IE' => 105, // IRELAND 'IM' => 106, // ISLE OF MAN 'IL' => 107, // ISRAEL 'IT' => 108, // ITALY 'JM' => 109, // JAMAICA 'JP' => 110, // JAPAN 'JE' => 111, // JERSEY 'JO' => 112, // JORDAN 'KZ' => 113, // KAZAKHSTAN 'KE' => 114, // KENYA 'KI' => 115, // KIRIBATI 'KP' => 116, // KOREA, DEMOCRATIC PEOPLE'S REPUBLIC OF 'KR' => 117, // KOREA, REPUBLIC OF 'KW' => 118, // KUWAIT 'KG' => 119, // KYRGYZSTAN 'LA' => 120, // LAO PEOPLE'S DEMOCRATIC REPUBLIC 'LV' => 121, // LATVIA 'LB' => 122, // LEBANON 'LS' => 123, // LESOTHO 'LR' => 124, // LIBERIA 'LY' => 125, // LIBYAN ARAB JAMAHIRIYA 'LI' => 126, // LIECHTENSTEIN 'LT' => 127, // LITHUANIA 'LU' => 128, // LUXEMBOURG 'MO' => 129, // MACAO 'MK' => 130, // MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF 'MG' => 131, // MADAGASCAR 'MW' => 132, // MALAWI 'MY' => 133, // MALAYSIA 'MV' => 134, // MALDIVES 'ML' => 135, // MALI 'MT' => 136, // MALTA 'MH' => 137, // MARSHALL ISLANDS 'MQ' => 138, // MARTINIQUE 'MR' => 139, // MAURITANIA 'MU' => 140, // MAURITIUS 'YT' => 141, // MAYOTTE 'MX' => 142, // MEXICO 'FM' => 143, // MICRONESIA FEDERATED STATES OF 'MD' => 144, // MOLDOVA, REPUBLIC OF 'MC' => 145, // MONACO 'MN' => 146, // MONGOLIA 'MS' => 147, // MONTSERRAT 'MA' => 148, // MOROCCO 'MZ' => 149, // MOZAMBIQUE 'MM' => 150, // MYANMAR 'NA' => 151, // NAMIBIA 'NR' => 152, // NAURU 'NP' => 153, // NEPAL 'NL' => 154, // NETHERLANDS 'AN' => 155, // NETHERLANDS ANTILLES 'NC' => 156, // NEW CALEDONIA 'NZ' => 157, // NEW ZEALAND 'NI' => 158, // NICARAGUA 'NE' => 159, // NIGER 'NG' => 160, // NIGERIA 'NU' => 161, // NIUE 'NF' => 162, // NORFOLK ISLAND 'MP' => 163, // NORTHERN MARIANA ISLANDS 'NO' => 164, // NORWAY 'OM' => 165, // OMAN 'PK' => 166, // PAKISTAN 'PW' => 167, // PALAU 'PS' => 168, // PALESTINIAN TERRITORY OCCUPIED 'PA' => 169, // PANAMA 'PG' => 170, // PAPUA NEW GUINEA 'PY' => 171, // PARAGUAY 'PE' => 172, // PERU 'PH' => 173, // PHILIPPINES 'PN' => 174, // PITCAIRN 'PL' => 175, // POLAND 'PT' => 176, // PORTUGAL 'PR' => 177, // PUERTO RICO 'QA' => 178, // QATAR 'RE' => 179, // REUNION 'RO' => 180, // ROMANIA 'RU' => 181, // RUSSIAN FEDERATION 'RW' => 182, // RWANDA 'SH' => 183, // SAINT HELENA 'KN' => 184, // SAINT KITTS AND NEVIS 'LC' => 185, // SAINT LUCIA 'PM' => 186, // SAINT PIERRE AND MIQUELON 'VC' => 187, // SAINT VINCENT AND THE GRENADINES 'WS' => 188, // SAMOA 'SM' => 189, // SAN MARINO 'ST' => 190, // SAO TOME AND PRINCIPE 'SA' => 191, // SAUDI ARABIA 'SN' => 192, // SENEGAL 'CS' => 193, // SERBIA AND MONTENEGRO 'SC' => 194, // SEYCHELLES 'SL' => 195, // SIERRA LEONE 'SG' => 196, // SINGAPORE 'SK' => 197, // SLOVAKIA 'SI' => 198, // SLOVENIA 'SB' => 199, // SOLOMON ISLANDS 'SO' => 200, // SOMALIA 'ZA' => 201, // SOUTH AFRICA 'GS' => 202, // SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS 'ES' => 203, // SPAIN 'LK' => 204, // SRI LANKA 'SD' => 205, // SUDAN 'SR' => 206, // SURINAME 'SJ' => 207, // SVALBARD AND JAN MAYEN 'SZ' => 208, // SWAZILAND 'SE' => 209, // SWEDEN 'CH' => 210, // SWITZERLAND 'SY' => 211, // SYRIAN ARAB REPUBLIC 'TW' => 212, // TAIWAN PROVINCE OF CHINA 'TJ' => 213, // TAJIKISTAN 'TZ' => 214, // TANZANIA, UNITED REPUBLIC OF 'TH' => 215, // THAILAND 'TL' => 216, // TIMOR-LESTE 'TG' => 217, // TOGO 'TK' => 218, // TOKELAU 'TO' => 219, // TONGA 'TT' => 220, // TRINIDAD AND TOBAGO 'TN' => 221, // TUNISIA 'TR' => 222, // TURKEY 'TM' => 223, // TURKMENISTAN 'TC' => 224, // TURKS AND CAICOS ISLANDS 'TV' => 225, // TUVALU 'UG' => 226, // UGANDA 'UA' => 227, // UKRAINE 'AE' => 228, // UNITED ARAB EMIRATES 'GB' => 229, // UNITED KINGDOM 'US' => 230, // UNITED STATES 'UM' => 231, // UNITED STATES MINOR OUTLYING ISLANDS 'UY' => 232, // URUGUAY 'UZ' => 233, // UZBEKISTAN 'VU' => 234, // VANUATU 'VE' => 235, // VENEZUELA 'VN' => 236, // VIET NAM 'VG' => 237, // VIRGIN ISLANDS, BRITISH 'VI' => 238, // VIRGIN ISLANDS, US 'WF' => 239, // WALLIS AND FUTUNA 'EH' => 240, // WESTERN SAHARA 'YE' => 241, // YEMEN 'ZM' => 242, // ZAMBIA 'ZW' => 243 // ZIMBABWE ); private static $_tlcMap = array( 'AF' => 'AFG', 'AX' => 'ALA', 'AL' => 'ALB', 'DZ' => 'DZA', 'AS' => 'ASM', 'AD' => 'AND', 'AO' => 'AGO', 'AI' => 'AIA', 'AQ' => 'ATA', 'AG' => 'ATG', 'AR' => 'ARG', 'AM' => 'ARM', 'AW' => 'ABW', 'AU' => 'AUS', 'AT' => 'AUT', 'AZ' => 'AZE', 'BS' => 'BHS', 'BH' => 'BHR', 'BD' => 'BGD', 'BB' => 'BRB', 'BY' => 'BLR', 'BE' => 'BEL', 'BZ' => 'BLZ', 'BJ' => 'BEN', 'BM' => 'BMU', 'BT' => 'BTN', 'BO' => 'BOL', 'BQ' => 'BES', 'BA' => 'BIH', 'BW' => 'BWA', 'BV' => 'BVT', 'BR' => 'BRA', 'IO' => 'IOT', 'BN' => 'BRN', 'BG' => 'BGR', 'BF' => 'BFA', 'BI' => 'BDI', 'KH' => 'KHM', 'CM' => 'CMR', 'CA' => 'CAN', 'CV' => 'CPV', 'KY' => 'CYM', 'CF' => 'CAF', 'TD' => 'TCD', 'CL' => 'CHL', 'CN' => 'CHN', 'CX' => 'CXR', 'CC' => 'CCK', 'CO' => 'COL', 'KM' => 'COM', 'CG' => 'COG', 'CD' => 'COD', 'CK' => 'COK', 'CR' => 'CRI', 'CI' => 'CIV', 'HR' => 'HRV', 'CU' => 'CUB', 'CW' => 'CUW', 'CY' => 'CYP', 'CZ' => 'CZE', 'DK' => 'DNK', 'DJ' => 'DJI', 'DM' => 'DMA', 'DO' => 'DOM', 'EC' => 'ECU', 'EG' => 'EGY', 'SV' => 'SLV', 'GQ' => 'GNQ', 'ER' => 'ERI', 'EE' => 'EST', 'ET' => 'ETH', 'FK' => 'FLK', 'FO' => 'FRO', 'FJ' => 'FJI', 'FI' => 'FIN', 'FR' => 'FRA', 'GF' => 'GUF', 'PF' => 'PYF', 'TF' => 'ATF', 'GA' => 'GAB', 'GM' => 'GMB', 'GE' => 'GEO', 'DE' => 'DEU', 'GH' => 'GHA', 'GI' => 'GIB', 'GR' => 'GRC', 'GL' => 'GRL', 'GD' => 'GRD', 'GP' => 'GLP', 'GU' => 'GUM', 'GT' => 'GTM', 'GG' => 'GGY', 'GN' => 'GIN', 'GW' => 'GNB', 'GY' => 'GUY', 'HT' => 'HTI', 'HM' => 'HMD', 'VA' => 'VAT', 'HN' => 'HND', 'HK' => 'HKG', 'HU' => 'HUN', 'IS' => 'ISL', 'IN' => 'IND', 'ID' => 'IDN', 'IR' => 'IRN', 'IQ' => 'IRQ', 'IE' => 'IRL', 'IM' => 'IMN', 'IL' => 'ISR', 'IT' => 'ITA', 'JM' => 'JAM', 'JP' => 'JPN', 'JE' => 'JEY', 'JO' => 'JOR', 'KZ' => 'KAZ', 'KE' => 'KEN', 'KI' => 'KIR', 'KP' => 'PRK', 'KR' => 'KOR', 'KW' => 'KWT', 'KG' => 'KGZ', 'LA' => 'LAO', 'LV' => 'LVA', 'LB' => 'LBN', 'LS' => 'LSO', 'LR' => 'LBR', 'LY' => 'LBY', 'LI' => 'LIE', 'LT' => 'LTU', 'LU' => 'LUX', 'MO' => 'MAC', 'MK' => 'MKD', 'MG' => 'MDG', 'MW' => 'MWI', 'MY' => 'MYS', 'MV' => 'MDV', 'ML' => 'MLI', 'MT' => 'MLT', 'MH' => 'MHL', 'MQ' => 'MTQ', 'MR' => 'MRT', 'MU' => 'MUS', 'YT' => 'MYT', 'MX' => 'MEX', 'FM' => 'FSM', 'MD' => 'MDA', 'MC' => 'MCO', 'MN' => 'MNG', 'ME' => 'MNE', 'MS' => 'MSR', 'MA' => 'MAR', 'MZ' => 'MOZ', 'MM' => 'MMR', 'NA' => 'NAM', 'NR' => 'NRU', 'NP' => 'NPL', 'NL' => 'NLD', 'NC' => 'NCL', 'NZ' => 'NZL', 'NI' => 'NIC', 'NE' => 'NER', 'NG' => 'NGA', 'NU' => 'NIU', 'NF' => 'NFK', 'MP' => 'MNP', 'NO' => 'NOR', 'OM' => 'OMN', 'PK' => 'PAK', 'PW' => 'PLW', 'PS' => 'PSE', 'PA' => 'PAN', 'PG' => 'PNG', 'PY' => 'PRY', 'PE' => 'PER', 'PH' => 'PHL', 'PN' => 'PCN', 'PL' => 'POL', 'PT' => 'PRT', 'PR' => 'PRI', 'QA' => 'QAT', 'RE' => 'REU', 'RO' => 'ROU', 'RU' => 'RUS', 'RW' => 'RWA', 'BL' => 'BLM', 'SH' => 'SHN', 'KN' => 'KNA', 'LC' => 'LCA', 'MF' => 'MAF', 'PM' => 'SPM', 'VC' => 'VCT', 'WS' => 'WSM', 'SM' => 'SMR', 'ST' => 'STP', 'SA' => 'SAU', 'SN' => 'SEN', 'RS' => 'SRB', 'SC' => 'SYC', 'SL' => 'SLE', 'SG' => 'SGP', 'SX' => 'SXM', 'SK' => 'SVK', 'SI' => 'SVN', 'SB' => 'SLB', 'SO' => 'SOM', 'ZA' => 'ZAF', 'GS' => 'SGS', 'SS' => 'SSD', 'ES' => 'ESP', 'LK' => 'LKA', 'SD' => 'SDN', 'SR' => 'SUR', 'SJ' => 'SJM', 'SZ' => 'SWZ', 'SE' => 'SWE', 'CH' => 'CHE', 'SY' => 'SYR', 'TW' => 'TWN', 'TJ' => 'TJK', 'TZ' => 'TZA', 'TH' => 'THA', 'TL' => 'TLS', 'TG' => 'TGO', 'TK' => 'TKL', 'TO' => 'TON', 'TT' => 'TTO', 'TN' => 'TUN', 'TR' => 'TUR', 'TM' => 'TKM', 'TC' => 'TCA', 'TV' => 'TUV', 'UG' => 'UGA', 'UA' => 'UKR', 'AE' => 'ARE', 'GB' => 'GBR', 'US' => 'USA', 'UM' => 'UMI', 'UY' => 'URY', 'UZ' => 'UZB', 'VU' => 'VUT', 'VE' => 'VEN', 'VN' => 'VNM', 'VG' => 'VGB', 'VI' => 'VIR', 'WF' => 'WLF', 'EH' => 'ESH', 'YE' => 'YEM', 'ZM' => 'ZMB', 'ZW' => 'ZWE' ); } Encoding.php 0000666 00000014350 15137552047 0007023 0 ustar 00 * @copyright 2012 Klarna AB (http://klarna.com) * @license http://opensource.org/licenses/BSD-2-Clause BSD-2 * @link http://integration.klarna.com/ */ defined ('_JEXEC') or die(); require_once 'Exceptions.php'; /** * Encoding class * * @category Payment * @package KlarnaAPI * @author MS Dev
* Use "" or null when unspecified.
* * @var int */ const FEMALE = 0; /** * Indicates that the person is a male.
* Use "" or null when unspecified.
* * @var int */ const MALE = 1; //Order status constants /** * This signifies that the invoice or reservation is accepted. * * @var int */ const ACCEPTED = 1; /** * This signifies that the invoice or reservation is pending, will be set * to accepted or denied. * * @var int */ const PENDING = 2; /** * This signifies that the invoice or reservation is denied. * * @var int */ const DENIED = 3; //Get_address constants /** * A code which indicates that all first names should be returned with the * address. * * Formerly refered to as GA_OLD. * * @var int */ const GA_ALL = 1; /** * A code which indicates that only the last name should be returned with * the address. * * Formerly referd to as GA_NEW. * * @var int */ const GA_LAST = 2; /** * A code which indicates that the given name should be returned with * the address. If no given name is registered, this will behave as * {@link KlarnaFlags::GA_ALL GA_ALL}. * */ const GA_GIVEN = 5; //Article/goods constants /** * Quantity measured in 1/1000s. * * @var int */ const PRINT_1000 = 1; /** * Quantity measured in 1/100s. * * @var int */ const PRINT_100 = 2; /** * Quantity measured in 1/10s. * * @var int */ const PRINT_10 = 4; /** * Indicates that the item is a shipment fee. * * Update_charge_amount (1) * * @var int */ const IS_SHIPMENT = 8; /** * Indicates that the item is a handling fee. * * Update_charge_amount (2) * * @var int */ const IS_HANDLING = 16; /** * Article price including VAT. * * @var int */ const INC_VAT = 32; //Miscellaneous /** * Signifies that this is to be displayed in the checkout.
* Used for part payment.
* * @var int */ const CHECKOUT_PAGE = 0; /** * Signifies that this is to be displayed in the product page.
* Used for part payment.
* * @var int */ const PRODUCT_PAGE = 1; /** * Signifies that the specified address is billing address. * * @var int */ const IS_BILLING = 100; /** * Signifies that the specified address is shipping address. * * @var int */ const IS_SHIPPING = 101; //Invoice and Reservation /** * Indicates that the purchase is a test invoice/part payment. * * @var int */ const TEST_MODE = 2; /** * PClass id/value for invoices. * * @see KlarnaPClass::INVOICE. * @var int */ const PCLASS_INVOICE = -1; //Invoice /** * Activates an invoices automatically, requires setting in Klarna Online. * * If you designate this flag an invoice is created directly in the active * state, i.e. Klarna will buy the invoice immediately. * * @var int */ const AUTO_ACTIVATE = 1; /** * Creates a pre-pay invoice. * * @var int * * @deprecated Do not use. */ const PRE_PAY = 8; /** * Used to flag a purchase as sensitive order. * * @var int */ const SENSITIVE_ORDER = 1024; /** * Used to return an array with long and short ocr number. * * @see Klarna::addTransaction() * @var int */ const RETURN_OCR = 8192; /** * Specifies the shipment type as normal. * * @var int */ const NORMAL_SHIPMENT = 1; /** * Specifies the shipment type as express. * * @var int */ const EXPRESS_SHIPMENT = 2; //Mobile (Invoice) flags /** * Marks the transaction as Klarna mobile. * * @var int */ const M_PHONE_TRANSACTION = 262144; /** * Sends a pin code to the phone sent in pno. * * @var int */ const M_SEND_PHONE_PIN = 524288; //Reservation flags /** * Signifies that the amount specified is the new amount. * * @var int */ const NEW_AMOUNT = 0; /** * Signifies that the amount specified is to be added. * * @var int */ const ADD_AMOUNT = 1; /** * Sends the invoice by mail when activating a reservation. * * @var int */ const RSRV_SEND_BY_MAIL = 4; /** * Sends the invoice by e-mail when activating a reservation. * * @var int */ const RSRV_SEND_BY_EMAIL = 8; /** * Used for partial deliveries, this flag saves the reservation number so * it can be used again. * * @var int */ const RSRV_PRESERVE_RESERVATION = 16; /** * Used to flag a purchase as sensitive order. * * @var int */ const RSRV_SENSITIVE_ORDER = 32; /** * Marks the transaction as Klarna mobile. * * @var int */ const RSRV_PHONE_TRANSACTION = 512; /** * Sends a pin code to the mobile number. * * @var int */ const RSRV_SEND_PHONE_PIN = 1024; }