get('site_id'); ?>
* @param string $name
* @return mixed null if $name was not recognised
*/
function get($name) {
if (!$name || !is_string($name)) {
return null;
}
// V1/shortcut notation compatibility
$name = (substr($name, 0, 5) != 'vads_') ? 'vads_' . $name : $name;
if ($name == 'vads_key_test') {
return $this->keyTest;
} elseif ($name == 'vads_key_prod') {
return $this->keyProd;
} elseif ($name == 'vads_platform_url') {
return $this->platformUrl;
} elseif ($name == 'vads_redirect_enabled') {
return $this->redirectEnabled;
} elseif (array_key_exists($name, $this->requestParameters)) {
return $this->requestParameters[$name]
->getValue();
} else {
return null;
}
}
/**
* General setter.
* Set an api variable with its name and the provided value. Automatically add 'vads_' to the name if necessary.
* Example : set('site_id', '12345678'); ?>
* @param string $name
* @param mixed $value
* @return boolean true on success
*/
function set($name, $value) {
if (!$name || !is_string($name)) {
return false;
}
// V1/shortcut notation compatibility
$name = (substr($name, 0, 5) != 'vads_') ? 'vads_' . $name : $name;
// Convert the parameters if they are not encoded in utf8
if($this->encoding !== "UTF-8") {
$value = iconv($this->encoding, "UTF-8", $value);
}
// Search appropriate setter
if ($name == 'vads_key_test') {
return $this->setCertificate($value, 'TEST');
} elseif ($name == 'vads_key_prod') {
return $this->setCertificate($value, 'PRODUCTION');
} elseif ($name == 'vads_platform_url') {
return $this->setPlatformUrl($value);
} elseif ($name == 'vads_redirect_enabled') {
return $this->setRedirectEnabled($value);
} elseif (array_key_exists($name, $this->requestParameters)) {
return $this->requestParameters[$name]
->setValue($value);
} else {
return false;
}
}
/**
* Set target url of the payment form
* @param string $url
* @return boolean
*/
function setPlatformUrl($url) {
if (!preg_match('#https?://([^/]+/)+#', $url)) {
return false;
}
$this->platformUrl = $url;
return true;
}
/**
* Enable/disable redirect_* parameters
* @param mixed $enabled false, '0', a null or negative integer or 'false' to disable
* @return boolean
*/
function setRedirectEnabled($enabled) {
$this->redirectEnabled = !(!$enabled || $enabled == '0'
|| strtolower($enabled) == 'false');
return true;
}
/**
* Set TEST or PRODUCTION certificate
* @param string $key
* @param string $mode
* @return boolean true if the certificate could be set
*/
function setCertificate($key, $mode) {
// Check format
if (!preg_match('#\d{16}#', $key)) {
return false;
}
if ($mode == 'TEST') {
$this->keyTest = $key;
} elseif ($mode == 'PRODUCTION') {
$this->keyProd = $key;
} else {
return false;
}
return true;
}
/**
* Add product infos as request parameters.
* @param string $label
* @param int $amount
* @param int $qty
* @param string $ref
* @param string $type
* @return boolean true if product infos are set correctly
*/
function addProduct($label, $amount, $qty, $ref, $type) {
$index = $this->get("nb_products") ? $this->get("nb_products") : 0;
$ok = true;
// Add product infos as request parameters
$ok &= $this->_addRequestField("vads_product_label" . $index, "Product label", '#^[^<>"+-]{0,255}$#', false, 255, $label);
$ok &= $this->_addRequestField("vads_product_amount" . $index, "Product amount", '#^[1-9]\d*$#', false, 12, $amount);
$ok &= $this->_addRequestField("vads_product_qty" . $index, "Product quantity", '#^[1-9]\d*$#', false, 255, $qty);
$ok &= $this->_addRequestField("vads_product_ref" . $index, "Product reference", '#^[A-Za-z0-9]{0,64}$#', false, 64, $ref);
$ok &= $this->_addRequestField("vads_product_type" . $index, "Product type", "#^".implode("|", $this->ACCORD_CATEGORIES)."$#",
false, 30, $type);
// Increment the number of products
$ok &= $this->set("nb_products", $index + 1);
return $ok;
}
/**
* Return certificate according to current mode, false if mode was not set
* @return string|boolean
* @access private
*/
function _getCertificate() {
switch ($this->requestParameters['vads_ctx_mode']
->getValue()) {
case 'TEST':
return $this->keyTest;
break;
case 'PRODUCTION':
return $this->keyProd;
break;
default:
return false;
break;
}
}
/**
* Generate signature from a list of VadsField
* @param array[string]VadsField $fields
* @return string
* @access private
*/
function _generateSignatureFromFields($fields = null, $hashed = true) {
$params = array();
$fields = ($fields !== null) ? $fields : $this->requestParameters;
foreach ($fields as $field) {
if ($field->isRequired() || $field->isFilled()) {
$params[$field->getName()] = $field->getValue();
}
}
return $this->sign($params, $this->_getCertificate(), $hashed);
}
/**
* Public static method to compute a vads signature. Parameters must be in utf-8.
* @param array[string]string $parameters payment gateway request/response parameters
* @param string $key shop certificate
* @param boolean $hashed set to false to get the raw, unhashed signature
* @access public
* @static
*/
function sign($parameters, $key, $hashed= true) {
$signContent = "";
ksort($parameters);
foreach ($parameters as $name => $value) {
if (substr($name, 0, 5) == 'vads_') {
$signContent .= $value . '+';
}
}
$signContent .= $key;
$sign = $hashed ? sha1($signContent) : $signContent;
return $sign;
}
// **************************************
// REQUEST PREPARATION FUNCTIONS
// **************************************
/**
* Unset the value of optionnal fields if they are unvalid
*/
function clearInvalidOptionnalFields() {
$fields = $this->getRequestFields();
foreach ($fields as $field) {
if (!$field->isValid() && !$field->isRequired()) {
$field->setValue(null);
}
}
}
/**
* Check all payment fields
* @param array $errors will be filled with the name of invalid fields
* @return boolean
*/
function isRequestReady(&$errors = null) {
$errors = is_array($errors) ? $errors : array();
$fields = $this->getRequestFields();
foreach ($fields as $field) {
if (!$field->isValid()) {
$errors[] = $field->getName();
}
}
return sizeof($errors) == 0;
}
/**
* Return the list of fields to send to the payment gateway
* @return array[string]VadsField a list of VadsField or false if a parameter was invalid
* @see VadsField
*/
function getRequestFields() {
$fields = $this->requestParameters;
// Filter redirect_parameters if redirect is disabled
if (!$this->redirectEnabled) {
$redirectFields = array(
'vads_redirect_success_timeout',
'vads_redirect_success_message',
'vads_redirect_error_timeout',
'vads_redirect_error_message');
foreach ($redirectFields as $fieldName) {
unset($fields[$fieldName]);
}
}
foreach ($fields as $fieldName => $field) {
if (!$field->isFilled() && !$field->isRequired()) {
unset($fields[$fieldName]);
}
}
// Compute signature
$fields['signature']->setValue($this->_generateSignatureFromFields($fields));
// Return the list of fields
return $fields;
}
/**
* Return the url of the payment page with urlencoded parameters (GET-like url)
* @return boolean|string
*/
function getRequestUrl() {
$fields = $this->getRequestFields();
$url = $this->platformUrl . '?';
foreach ($fields as $field) {
if ($field->isFilled()) {
$url .= $field->getName() . '=' . rawurlencode($field->getValue())
. '&';
}
}
$url = substr($url, 0, -1); // remove last &
return $url;
}
/**
* Return the html form to send to the payment gateway
* @param string $enteteAdd
* @param string $inputType
* @param string $buttonValue
* @param string $buttonAdd
* @param string $buttonType
* @return string
*/
function getRequestHtmlForm($enteteAdd = '', $inputType = 'hidden',
$buttonValue = 'Aller sur la plateforme de paiement', $buttonAdd = '',
$buttonType = 'submit') {
$html = "";
$html .= '';
return $html;
}
/**
* Return the html code of the form fields to send to the payment page
* @param string $inputAttributes
* @return string
*/
function getRequestFieldsHtml($inputAttributes = 'type="hidden"') {
$fields = $this->getRequestFields();
$html = '';
$format = '\n";
foreach ($fields as $field) {
if ($field->isFilled()) {
// Convert special chars to HTML entities to avoid data troncation
$value = htmlspecialchars($field->getValue(), ENT_QUOTES, 'UTF-8');
$html .= sprintf($format, $field->getName(), $value);
}
}
return $html;
}
// **************************************
// RESPONSE ANALYSIS FUNCTIONS
// **************************************
/**
* Prepare to analyse check url or return url call
* @param array[string]string $parameters $_REQUEST by default
* @param string $ctx_mode
* @param string $key_test
* @param string $key_prod
*/
function loadResponse($parameters = null, $ctx_mode = null, $key_test = null,
$key_prod = null) {
$parameters = is_null($parameters) ? $_REQUEST : $parameters;
$parameters = VadsApi::uncharm($parameters);
// Load site credentials if provided
if (!is_null($ctx_mode)) {
$this->set('vads_ctx_mode', $ctx_mode);
}
if (!is_null($key_test)) {
$this->set('vads_key_test', $key_test);
}
if (!is_null($key_prod)) {
$this->set('vads_key_prod', $key_prod);
}
$this->response = new VadsResponse();
$this->response->load($parameters, $this->_getCertificate());
}
/**
* Return a VadsResponse object representing the result of the payment.
* You can provide arguments to load data as in loadResponse.
* @see VadsApi::loadResponse
* @return VadsResponse
*/
function getResponse($parameters = null, $ctx_mode = null, $key_test = null,
$key_prod = null) {
//TODO ? redondance avec loadResponse
if (is_null($this->response)) {
$this->loadResponse($parameters, $ctx_mode, $key_test, $key_prod);
}
return $this->response;
}
/**
* PHP is not yet a sufficiently advanced technology to be indistinguishable from magic...
* so don't use magic_quotes, they mess up with the gateway response analysis.
*
* @param array $potentiallyMagicallyQuotedData
*/
function uncharm($potentiallyMagicallyQuotedData) {
if (get_magic_quotes_gpc()) {
$sane = array();
foreach ($potentiallyMagicallyQuotedData as $k => $v) {
$saneKey = stripslashes($k);
$saneValue = is_array($v) ? VadsApi::uncharm($v) : stripslashes($v);
$sane[$saneKey] = $saneValue;
}
} else {
$sane = $potentiallyMagicallyQuotedData;
}
return $sane;
}
}
/**
* Class representing the result of a transaction (sent by the check url or by the client return)
* @package VadsApi
*/
class VadsResponse {
/**
* Raw response parameters array
* @var array
* @access private
*/
var $raw_response = array();
/**
* Certificate used to check the signature
* @see VadsApi::sign
* @var boolean
* @access private
*/
var $certificate;
/**
* Value of vads_result
* @var string
* @access private
*/
var $code;
/**
* Translation of $code (vads_result)
* @var string
* @access private
*/
var $message;
/**
* Value of vads_extra_result
* @var string
* @access private
*/
var $extraCode;
/**
* Translation of $extraCode (vads_extra_result)
* @var string
* @access private
*/
var $extraMessage;
/**
* Value of vads_auth_result
* @var string
* @access private
*/
var $authCode;
/**
* Translation of $authCode (vads_auth_result)
* @var string
* @access private
*/
var $authMessage;
/**
* Value of vads_warranty_result
* @var string
* @access private
*/
var $warrantyCode;
/**
* Translation of $warrantyCode (vads_warranty_result)
* @var string
* @access private
*/
var $warrantyMessage;
/**
* Associative array containing human-readable translations of response codes. Initialized to french translations.
* @var array
* @access private
*/
var $translation = array(
'no_code' => '',
'no_translation' => '',
'results' => array(
'00' => 'Paiement réalisé avec succès',
'02' => 'Le commerçant doit contacter la banque du porteur',
'05' => 'Paiement refusé',
'17' => 'Annulation client',
'30' => 'Erreur de format de la requête',
'96' => 'Erreur technique lors du paiement'),
'extra_results_default' => array(
'empty' => 'Pas de contrôle effectué',
'00' => 'Tous les contrôles se sont déroulés avec succès',
'02' => 'La carte a dépassé l’encours autorisé',
'03' => 'La carte appartient à la liste grise du commerçant',
'04' => 'Le pays d’émission de la carte appartient à la liste grise du commerçant',
'05' => 'L’adresse IP appartient à la liste grise du commerçant',
'99' => 'Problème technique rencontré par le serveur lors du traitement d’un des contrôles locaux'),
'extra_results_30' => array(
'00' => 'signature',
'01' => 'version',
'02' => 'merchant_site_id',
'03' => 'transaction_id',
'04' => 'date',
'05' => 'validation_mode',
'06' => 'capture_delay',
'07' => 'config',
'08' => 'payment_cards',
'09' => 'amount',
'10' => 'currency',
'11' => 'ctx_mode',
'12' => 'language',
'13' => 'order_id',
'14' => 'order_info',
'15' => 'cust_email',
'16' => 'cust_id',
'17' => 'cust_title',
'18' => 'cust_name',
'19' => 'cust_address',
'20' => 'cust_zip',
'21' => 'cust_city',
'22' => 'cust_country',
'23' => 'cust_phone',
'24' => 'url_success',
'25' => 'url_refused',
'26' => 'url_referral',
'27' => 'url_cancel',
'28' => 'url_return',
'29' => 'url_error',
'30' => 'identifier',
'31' => 'contrib',
'32' => 'theme_config',
'34' => 'redirect_success_timeout',
'35' => 'redirect_success_message',
'36' => 'redirect_error_timeout',
'37' => 'redirect_error_message',
'38' => 'return_post_params',
'39' => 'return_get_params',
'40' => 'card_number',
'41' => 'expiry_month',
'42' => 'expiry_year',
'43' => 'card_cvv',
'44' => 'card_info',
'45' => 'card_options',
'46' => 'page_action',
'47' => 'action_mode',
'48' => 'return_mode',
'50' => 'secure_mpi',
'51' => 'secure_enrolled',
'52' => 'secure_cavv',
'53' => 'secure_eci',
'54' => 'secure_xid',
'55' => 'secure_cavv_alg',
'56' => 'secure_status',
'60' => 'payment_src',
'61' => 'user_info',
'62' => 'contracts',
'70' => 'empty_params',
'99' => 'other'),
'auth_results' => array(
'00' => 'transaction approuvée ou traitée avec succès',
'02' => 'contacter l’émetteur de carte',
'03' => 'accepteur invalide',
'04' => 'conserver la carte',
'05' => 'ne pas honorer',
'07' => 'conserver la carte, conditions spéciales',
'08' => 'approuver après identification',
'12' => 'transaction invalide',
'13' => 'montant invalide',
'14' => 'numéro de porteur invalide',
'30' => 'erreur de format',
'31' => 'identifiant de l’organisme acquéreur inconnu',
'33' => 'date de validité de la carte dépassée',
'34' => 'suspicion de fraude',
'41' => 'carte perdue',
'43' => 'carte volée',
'51' => 'provision insuffisante ou crédit dépassé',
'54' => 'date de validité de la carte dépassée',
'56' => 'carte absente du fichier',
'57' => 'transaction non permise à ce porteur',
'58' => 'transaction interdite au terminal',
'59' => 'suspicion de fraude',
'60' => 'l’accepteur de carte doit contacter l’acquéreur',
'61' => 'montant de retrait hors limite',
'63' => 'règles de sécurité non respectées',
'68' => 'réponse non parvenue ou reçue trop tard',
'90' => 'arrêt momentané du système',
'91' => 'émetteur de cartes inaccessible',
'96' => 'mauvais fonctionnement du système',
'94' => 'transaction dupliquée',
'97' => 'échéance de la temporisation de surveillance globale',
'98' => 'serveur indisponible routage réseau demandé à nouveau',
'99' => 'incident domaine initiateur'),
'warranty_results' => array(
'YES' => 'Le paiement est garanti',
'NO' => 'Le paiement n\'est pas garanti',
'UNKNOWN' => 'Suite à une erreur technique, le paiment ne peut pas être garanti'));
//TODO not tested. not used.
// /**
// * Replace current translation entries with provided ones
// * @param array $translation
// */
// function loadTranslation($translation) {
// return $this->translation = $this->_recurseLoadTranslation($this->translation, $translation);
// }
//
// /**
// * Recursively load a $loaded translation array into the $original translation array
// * @param array $original
// * @param array $loaded
// */
// function _recurseLoadTranslation($original, $loaded) {
// foreach ($original as $key => $value) {
// if (is_array($value)) {
// $original[$key] = $this->_recurseLoadTranslation($original[$key], $array[$key]);
// }
// else if(array_key_exists($value, $loaded)) {
// $original[$key] = $loaded[$value];
// }
// }
// return $original;
// }
/**
* Load response codes and translations from a parameter array.
* @param array[string]string $raw
* @param boolean $authentified
*/
function load($raw, $certificate) {
$this->raw_response = is_array($raw) ? $raw : array();
$this->certificate = $certificate;
// Get codes
$code = $this->_findInArray('vads_result', $raw, null);
$extraCode = $this->_findInArray('vads_extra_result', $raw, null);
$authCode = $this->_findInArray('vads_auth_result', $raw, null);
$warrantyCode = $this->_findInArray('vads_warranty_code', $raw, null);
// Common translations
$noCode = $this->translation['no_code'];
$noTrans = $this->translation['no_translation'];
// Result and extra result
if ($code == null) {
$message = $noCode;
$extraMessage = ($extraCode == null) ? $noCode : $noTrans;
} else {
$message = $this->_findInArray($code, $this->translation['results'],
$noTrans);
if ($extraCode == null) {
$extraMessage = $noCode;
} elseif ($code == 30) {
$extraMessage = $this->_findInArray($extraCode,
$this->translation['extra_results_30'], $noTrans);
} else {
$extraMessage = $this->_findInArray($extraCode,
$this->translation['extra_results_default'], $noTrans);
}
}
// auth_result
if ($authCode == null) {
$authMessage = $noCode;
} else {
$authMessage = $this->_findInArray($authCode,
$this->translation['auth_results'], $noTrans);
}
// warranty_result
if ($warrantyCode == null) {
$warrantyMessage = $noCode;
} else {
$warrantyMessage = $this->_findInArray($warrantyCode,
$this->translations['warranty_results'], $noTrans);
}
$this->code = $code;
$this->message = $message;
$this->authCode = $authCode;
$this->authMessage = $authMessage;
$this->extraCode = $extraCode;
$this->extraMessage = $extraMessage;
$this->warrantyCode = $warrantyCode;
$this->warrantyMessage = $warrantyMessage;
}
/**
* Check response signature
* @return boolean
*/
function isAuthentified() {
return VadsApi::sign($this->raw_response, $this->certificate)
== $this->get('signature');
}
/**
* Return the signature computed from the received parameters, for log/debug purposes.
* @param boolean $hashed apply sha1, false by default
* @return string
*/
function getComputedSignature($hashed = false) {
return VadsApi::sign($this->raw_response, $this->certificate, $hashed);
}
/**
* Check if the payment was successful (waiting confirmation or captured)
* @return boolean
*/
function isAcceptedPayment() {
return $this->code == '00';
}
/**
* Check if the payment is waiting confirmation (successful but the amount has not been transfered and is not yet guaranteed)
* @return boolean
*/
function isPendingPayment() {
return $this->get('auth_mode') == 'MARK';
}
/**
* Check if the payment process was interrupted by the client
* @return boolean
*/
function isCancelledPayment() {
return $this->code == '17';
}
/**
* Return the value of a response parameter.
* @param string $name
* @return string
*/
function get($name) {
// Manage shortcut notations by adding 'vads_'
if (!array_key_exists($name, $this->raw_response)) {
$name = 'vads_' . $name;
}
return @$this->raw_response[$name];
}
/**
* Return the paid amount converted from cents (or currency equivalent) to a decimal value
* @return float
*/
function getFloatAmount() {
$currency = VadsApi::findCurrencyByNumCode($this->get('currency'));
return $currency->convertAmountToFloat($this->get('amount'));
}
/**
* Return a short description of the payment result, useful for logging
* @return string
*/
function getLogString() {
$log = $this->code . ' : ' . $this->message;
if ($this->code == '30') {
$log .= ' (' . $this->extraCode . ' : ' . $this->extraMessage . ')';
}
return $log;
}
/**
* Return a formatted string to output as a response to the check url call
* @param string $case shortcut code for current situations. Most useful : payment_ok, payment_ko, auth_fail
* @param string $extraMessage some extra information to output to the payment gateway
* @return string
*/
function getOutputForGateway($case = '', $extraMessage = "") {
$success = false;
$message = '';
// Messages prédéfinis selon le cas
$cases = array(
'payment_ok' => array(true, 'Paiement valide traité'),
'payment_ko' => array(true, 'Paiement invalide traité'),
'payment_ok_already_done' => array(
true,
'Paiement valide traité, déjà enregistré'),
'order_not_found' => array(false, 'Impossible de retrouver la commande'),
'payment_ko_on_order_ok' => array(
false,
'Code paiement invalide reçu pour une commande déjà validée'),
'auth_fail' => array(false, 'Echec authentification'),
'ok' => array(true, ''),
'ko' => array(false, ''));
if (array_key_exists($case, $cases)) {
$success = $cases[$case][0];
$message = $cases[$case][1];
}
$message .= ' ' . $extraMessage;
$message = str_replace("\n", '', $message);
$response = '';
$response .= '';
return $response;
}
/**
* Private shortcut function
* @param string $value
* @param array[string]string $translations
* @param string $defaultTransation
* @access private
*/
function _findInArray($key, $array, $default) {
if (is_array($array) && array_key_exists($key, $array)) {
return $array[$key];
}
return $default;
}
}
/**
* Class representing a field of the form to send to the payment gateway
* @package VadsApi
*/
class VadsField {
/**
* Field's name. Matches the html input attribute
* @var string
* @access private
*/
var $name;
/**
* Field's label in english, to be used by translation systems
* @var string
* @access private
*/
var $label;
/**
* Field's maximum length. Matches the html text input attribute
* @var int
* @access private
*/
var $length;
/**
* PCRE regular expression the field value must match
* @var string
* @access private
*/
var $regex;
/**
* Whether the form requires the field to be set (even to an empty string)
* @var boolean
* @access private
*/
var $required;
/**
* Field's value. Null or string
* @var string
* @access private
*/
var $value = null;
/**
* Constructor
* @param string $name
* @param string $label
* @param string $regex
* @param boolean $required
* @param string $value
* @return VadsField
*/
function VadsField($name, $label, $regex, $required = false, $length = 255) {
$this->name = $name;
$this->label = $label;
$this->regex = $regex;
$this->required = $required;
$this->length = $length;
}
/**
* Setter for value
* @param mixed $value
* @return boolean true if the value is valid
*/
function setValue($value) {
$value = ($value === null) ? null : (string) $value;
// We save value even if invalid (in case the validate function is too restrictive, it happened once) ...
$this->value = $value;
if (!$this->validate($value)) {
// ... but we return a "false" warning
return false;
}
return true;
}
/**
* Checks the current value
* @return boolean false if the current value is invalid or null and required
*/
function isValid() {
return $this->validate($this->value);
}
/**
* Check if a value is valid for this field
* @param string $value
* @return boolean
*/
function validate($value) {
if ($value === null && $this->isRequired()) {
return false;
}
if ($value !== null && !preg_match($this->regex, $value)) {
return false;
}
return true;
}
/**
* Setter for the required attribute
* @param boolean $required
*/
function setRequired($required) {
$this->required = (boolean) $required;
}
/**
* Is the field required in the payment request ?
* @return boolean
*/
function isRequired() {
return $this->required;
}
/**
* Return the current value of the field.
* @return string
*/
function getValue() {
return $this->value;
}
/**
* Return the name (html attribute) of the field.
* @return string
*/
function getName() {
return $this->name;
}
/**
* Return the english human-readable name of the field.
* @return string
*/
function getLabel() {
return $this->label;
}
/**
* Return the maximum length of the field's value.
* @return number
*/
function getLength() {
return $this->length;
}
/**
* Has a value been set ?
* @return boolean
*/
function isFilled() {
return !is_null($this->getValue());
}
}
/**
* Class representing a currency, used for converting alpha/numeric iso codes and float/integer amounts
* @package VadsApi
*
*/
class VadsCurrency {
var $alpha3;
var $num;
var $decimals;
function VadsCurrency($alpha3, $num, $decimals = 2) {
$this->alpha3 = $alpha3;
$this->num = $num;
$this->decimals = $decimals;
}
function convertAmountToInteger($float) {
$coef = pow(10, $this->decimals);
return round(intval($float) * $coef);
}
function convertAmountToFloat($integer) {
$coef = pow(10, $this->decimals);
return floatval($integer) / $coef;
}
}
// No closing tag payzen/.htaccess 0000666 00000000177 15137405540 0007665 0 ustar 00 ' . JText::_ ('VMPAYMENT_' . $this->_name . '_PLEASE_WAIT') . '
'; $form .= '' . JText::_ ('VMPAYMENT_' . $this->_name . '_CLICK_BUTTON_IF_NOT_REDIRECTED') . '
'; $form .= '' . JText::_ ($msg) . '
'; } else { $html = '| ' . JText::_ ($msg) . ' |
get('site_id'); ?>
* @param string $name
* @return mixed null if $name was not recognised
*/
function get($name) {
if (!$name || !is_string($name)) {
return null;
}
// V1/shortcut notation compatibility
$name = (substr($name, 0, 5) != 'vads_') ? 'vads_' . $name : $name;
if ($name == 'vads_key_test') {
return $this->keyTest;
} elseif ($name == 'vads_key_prod') {
return $this->keyProd;
} elseif ($name == 'vads_platform_url') {
return $this->platformUrl;
} elseif ($name == 'vads_redirect_enabled') {
return $this->redirectEnabled;
} elseif (array_key_exists($name, $this->requestParameters)) {
return $this->requestParameters[$name]
->getValue();
} else {
return null;
}
}
/**
* General setter.
* Set an api variable with its name and the provided value. Automatically add 'vads_' to the name if necessary.
* Example : set('site_id', '12345678'); ?>
* @param string $name
* @param mixed $value
* @return boolean true on success
*/
function set($name, $value) {
if (!$name || !is_string($name)) {
return false;
}
// V1/shortcut notation compatibility
$name = (substr($name, 0, 5) != 'vads_') ? 'vads_' . $name : $name;
// Convert the parameters if they are not encoded in utf8
if($this->encoding !== "UTF-8") {
$value = iconv($this->encoding, "UTF-8", $value);
}
// Search appropriate setter
if ($name == 'vads_key_test') {
return $this->setCertificate($value, 'TEST');
} elseif ($name == 'vads_key_prod') {
return $this->setCertificate($value, 'PRODUCTION');
} elseif ($name == 'vads_platform_url') {
return $this->setPlatformUrl($value);
} elseif ($name == 'vads_redirect_enabled') {
return $this->setRedirectEnabled($value);
} elseif (array_key_exists($name, $this->requestParameters)) {
return $this->requestParameters[$name]
->setValue($value);
} else {
return false;
}
}
/**
* Set target url of the payment form
* @param string $url
* @return boolean
*/
function setPlatformUrl($url) {
if (!preg_match('#https?://([^/]+/)+#', $url)) {
return false;
}
$this->platformUrl = $url;
return true;
}
/**
* Enable/disable redirect_* parameters
* @param mixed $enabled false, '0', a null or negative integer or 'false' to disable
* @return boolean
*/
function setRedirectEnabled($enabled) {
$this->redirectEnabled = !(!$enabled || $enabled == '0'
|| strtolower($enabled) == 'false');
return true;
}
/**
* Set TEST or PRODUCTION certificate
* @param string $key
* @param string $mode
* @return boolean true if the certificate could be set
*/
function setCertificate($key, $mode) {
// Check format
if (!preg_match('#\d{16}#', $key)) {
return false;
}
if ($mode == 'TEST') {
$this->keyTest = $key;
} elseif ($mode == 'PRODUCTION') {
$this->keyProd = $key;
} else {
return false;
}
return true;
}
/**
* Add product infos as request parameters.
* @param string $label
* @param int $amount
* @param int $qty
* @param string $ref
* @param string $type
* @return boolean true if product infos are set correctly
*/
function addProduct($label, $amount, $qty, $ref, $type) {
$index = $this->get("nb_products") ? $this->get("nb_products") : 0;
$ok = true;
// Add product infos as request parameters
$ok &= $this->_addRequestField("vads_product_label" . $index, "Product label", '#^[^<>"+-]{0,255}$#', false, 255, $label);
$ok &= $this->_addRequestField("vads_product_amount" . $index, "Product amount", '#^[1-9]\d*$#', false, 12, $amount);
$ok &= $this->_addRequestField("vads_product_qty" . $index, "Product quantity", '#^[1-9]\d*$#', false, 255, $qty);
$ok &= $this->_addRequestField("vads_product_ref" . $index, "Product reference", '#^[A-Za-z0-9]{0,64}$#', false, 64, $ref);
$ok &= $this->_addRequestField("vads_product_type" . $index, "Product type", "#^".implode("|", $this->ACCORD_CATEGORIES)."$#",
false, 30, $type);
// Increment the number of products
$ok &= $this->set("nb_products", $index + 1);
return $ok;
}
/**
* Return certificate according to current mode, false if mode was not set
* @return string|boolean
* @access private
*/
function _getCertificate() {
switch ($this->requestParameters['vads_ctx_mode']
->getValue()) {
case 'TEST':
return $this->keyTest;
break;
case 'PRODUCTION':
return $this->keyProd;
break;
default:
return false;
break;
}
}
/**
* Generate signature from a list of VadsField
* @param array[string]VadsField $fields
* @return string
* @access private
*/
function _generateSignatureFromFields($fields = null, $hashed = true) {
$params = array();
$fields = ($fields !== null) ? $fields : $this->requestParameters;
foreach ($fields as $field) {
if ($field->isRequired() || $field->isFilled()) {
$params[$field->getName()] = $field->getValue();
}
}
return $this->sign($params, $this->_getCertificate(), $hashed);
}
/**
* Public static method to compute a vads signature. Parameters must be in utf-8.
* @param array[string]string $parameters payment gateway request/response parameters
* @param string $key shop certificate
* @param boolean $hashed set to false to get the raw, unhashed signature
* @access public
* @static
*/
function sign($parameters, $key, $hashed= true) {
$signContent = "";
ksort($parameters);
foreach ($parameters as $name => $value) {
if (substr($name, 0, 5) == 'vads_') {
$signContent .= $value . '+';
}
}
$signContent .= $key;
$sign = $hashed ? sha1($signContent) : $signContent;
return $sign;
}
// **************************************
// REQUEST PREPARATION FUNCTIONS
// **************************************
/**
* Unset the value of optionnal fields if they are unvalid
*/
function clearInvalidOptionnalFields() {
$fields = $this->getRequestFields();
foreach ($fields as $field) {
if (!$field->isValid() && !$field->isRequired()) {
$field->setValue(null);
}
}
}
/**
* Check all payment fields
* @param array $errors will be filled with the name of invalid fields
* @return boolean
*/
function isRequestReady(&$errors = null) {
$errors = is_array($errors) ? $errors : array();
$fields = $this->getRequestFields();
foreach ($fields as $field) {
if (!$field->isValid()) {
$errors[] = $field->getName();
}
}
return sizeof($errors) == 0;
}
/**
* Return the list of fields to send to the payment gateway
* @return array[string]VadsField a list of VadsField or false if a parameter was invalid
* @see VadsField
*/
function getRequestFields() {
$fields = $this->requestParameters;
// Filter redirect_parameters if redirect is disabled
if (!$this->redirectEnabled) {
$redirectFields = array(
'vads_redirect_success_timeout',
'vads_redirect_success_message',
'vads_redirect_error_timeout',
'vads_redirect_error_message');
foreach ($redirectFields as $fieldName) {
unset($fields[$fieldName]);
}
}
foreach ($fields as $fieldName => $field) {
if (!$field->isFilled() && !$field->isRequired()) {
unset($fields[$fieldName]);
}
}
// Compute signature
$fields['signature']->setValue($this->_generateSignatureFromFields($fields));
// Return the list of fields
return $fields;
}
/**
* Return the url of the payment page with urlencoded parameters (GET-like url)
* @return boolean|string
*/
function getRequestUrl() {
$fields = $this->getRequestFields();
$url = $this->platformUrl . '?';
foreach ($fields as $field) {
if ($field->isFilled()) {
$url .= $field->getName() . '=' . rawurlencode($field->getValue())
. '&';
}
}
$url = substr($url, 0, -1); // remove last &
return $url;
}
/**
* Return the html form to send to the payment gateway
* @param string $enteteAdd
* @param string $inputType
* @param string $buttonValue
* @param string $buttonAdd
* @param string $buttonType
* @return string
*/
function getRequestHtmlForm($enteteAdd = '', $inputType = 'hidden',
$buttonValue = 'Aller sur la plateforme de paiement', $buttonAdd = '',
$buttonType = 'submit') {
$html = "";
$html .= '';
return $html;
}
/**
* Return the html code of the form fields to send to the payment page
* @param string $inputAttributes
* @return string
*/
function getRequestFieldsHtml($inputAttributes = 'type="hidden"') {
$fields = $this->getRequestFields();
$html = '';
$format = '\n";
foreach ($fields as $field) {
if ($field->isFilled()) {
// Convert special chars to HTML entities to avoid data troncation
$value = htmlspecialchars($field->getValue(), ENT_QUOTES, 'UTF-8');
$html .= sprintf($format, $field->getName(), $value);
}
}
return $html;
}
// **************************************
// RESPONSE ANALYSIS FUNCTIONS
// **************************************
/**
* Prepare to analyse check url or return url call
* @param array[string]string $parameters $_REQUEST by default
* @param string $ctx_mode
* @param string $key_test
* @param string $key_prod
*/
function loadResponse($parameters = null, $ctx_mode = null, $key_test = null,
$key_prod = null) {
$parameters = is_null($parameters) ? $_REQUEST : $parameters;
$parameters = VadsApi::uncharm($parameters);
// Load site credentials if provided
if (!is_null($ctx_mode)) {
$this->set('vads_ctx_mode', $ctx_mode);
}
if (!is_null($key_test)) {
$this->set('vads_key_test', $key_test);
}
if (!is_null($key_prod)) {
$this->set('vads_key_prod', $key_prod);
}
$this->response = new VadsResponse();
$this->response->load($parameters, $this->_getCertificate());
}
/**
* Return a VadsResponse object representing the result of the payment.
* You can provide arguments to load data as in loadResponse.
* @see VadsApi::loadResponse
* @return VadsResponse
*/
function getResponse($parameters = null, $ctx_mode = null, $key_test = null,
$key_prod = null) {
//TODO ? redondance avec loadResponse
if (is_null($this->response)) {
$this->loadResponse($parameters, $ctx_mode, $key_test, $key_prod);
}
return $this->response;
}
/**
* PHP is not yet a sufficiently advanced technology to be indistinguishable from magic...
* so don't use magic_quotes, they mess up with the gateway response analysis.
*
* @param array $potentiallyMagicallyQuotedData
*/
function uncharm($potentiallyMagicallyQuotedData) {
if (get_magic_quotes_gpc()) {
$sane = array();
foreach ($potentiallyMagicallyQuotedData as $k => $v) {
$saneKey = stripslashes($k);
$saneValue = is_array($v) ? VadsApi::uncharm($v) : stripslashes($v);
$sane[$saneKey] = $saneValue;
}
} else {
$sane = $potentiallyMagicallyQuotedData;
}
return $sane;
}
}
/**
* Class representing the result of a transaction (sent by the check url or by the client return)
* @package VadsApi
*/
class VadsResponse {
/**
* Raw response parameters array
* @var array
* @access private
*/
var $raw_response = array();
/**
* Certificate used to check the signature
* @see VadsApi::sign
* @var boolean
* @access private
*/
var $certificate;
/**
* Value of vads_result
* @var string
* @access private
*/
var $code;
/**
* Translation of $code (vads_result)
* @var string
* @access private
*/
var $message;
/**
* Value of vads_extra_result
* @var string
* @access private
*/
var $extraCode;
/**
* Translation of $extraCode (vads_extra_result)
* @var string
* @access private
*/
var $extraMessage;
/**
* Value of vads_auth_result
* @var string
* @access private
*/
var $authCode;
/**
* Translation of $authCode (vads_auth_result)
* @var string
* @access private
*/
var $authMessage;
/**
* Value of vads_warranty_result
* @var string
* @access private
*/
var $warrantyCode;
/**
* Translation of $warrantyCode (vads_warranty_result)
* @var string
* @access private
*/
var $warrantyMessage;
/**
* Associative array containing human-readable translations of response codes. Initialized to french translations.
* @var array
* @access private
*/
var $translation = array(
'no_code' => '',
'no_translation' => '',
'results' => array(
'00' => 'Paiement réalisé avec succès',
'02' => 'Le commerçant doit contacter la banque du porteur',
'05' => 'Paiement refusé',
'17' => 'Annulation client',
'30' => 'Erreur de format de la requête',
'96' => 'Erreur technique lors du paiement'),
'extra_results_default' => array(
'empty' => 'Pas de contrôle effectué',
'00' => 'Tous les contrôles se sont déroulés avec succès',
'02' => 'La carte a dépassé l’encours autorisé',
'03' => 'La carte appartient à la liste grise du commerçant',
'04' => 'Le pays d’émission de la carte appartient à la liste grise du commerçant',
'05' => 'L’adresse IP appartient à la liste grise du commerçant',
'99' => 'Problème technique rencontré par le serveur lors du traitement d’un des contrôles locaux'),
'extra_results_30' => array(
'00' => 'signature',
'01' => 'version',
'02' => 'merchant_site_id',
'03' => 'transaction_id',
'04' => 'date',
'05' => 'validation_mode',
'06' => 'capture_delay',
'07' => 'config',
'08' => 'payment_cards',
'09' => 'amount',
'10' => 'currency',
'11' => 'ctx_mode',
'12' => 'language',
'13' => 'order_id',
'14' => 'order_info',
'15' => 'cust_email',
'16' => 'cust_id',
'17' => 'cust_title',
'18' => 'cust_name',
'19' => 'cust_address',
'20' => 'cust_zip',
'21' => 'cust_city',
'22' => 'cust_country',
'23' => 'cust_phone',
'24' => 'url_success',
'25' => 'url_refused',
'26' => 'url_referral',
'27' => 'url_cancel',
'28' => 'url_return',
'29' => 'url_error',
'30' => 'identifier',
'31' => 'contrib',
'32' => 'theme_config',
'34' => 'redirect_success_timeout',
'35' => 'redirect_success_message',
'36' => 'redirect_error_timeout',
'37' => 'redirect_error_message',
'38' => 'return_post_params',
'39' => 'return_get_params',
'40' => 'card_number',
'41' => 'expiry_month',
'42' => 'expiry_year',
'43' => 'card_cvv',
'44' => 'card_info',
'45' => 'card_options',
'46' => 'page_action',
'47' => 'action_mode',
'48' => 'return_mode',
'50' => 'secure_mpi',
'51' => 'secure_enrolled',
'52' => 'secure_cavv',
'53' => 'secure_eci',
'54' => 'secure_xid',
'55' => 'secure_cavv_alg',
'56' => 'secure_status',
'60' => 'payment_src',
'61' => 'user_info',
'62' => 'contracts',
'70' => 'empty_params',
'99' => 'other'),
'auth_results' => array(
'00' => 'transaction approuvée ou traitée avec succès',
'02' => 'contacter l’émetteur de carte',
'03' => 'accepteur invalide',
'04' => 'conserver la carte',
'05' => 'ne pas honorer',
'07' => 'conserver la carte, conditions spéciales',
'08' => 'approuver après identification',
'12' => 'transaction invalide',
'13' => 'montant invalide',
'14' => 'numéro de porteur invalide',
'30' => 'erreur de format',
'31' => 'identifiant de l’organisme acquéreur inconnu',
'33' => 'date de validité de la carte dépassée',
'34' => 'suspicion de fraude',
'41' => 'carte perdue',
'43' => 'carte volée',
'51' => 'provision insuffisante ou crédit dépassé',
'54' => 'date de validité de la carte dépassée',
'56' => 'carte absente du fichier',
'57' => 'transaction non permise à ce porteur',
'58' => 'transaction interdite au terminal',
'59' => 'suspicion de fraude',
'60' => 'l’accepteur de carte doit contacter l’acquéreur',
'61' => 'montant de retrait hors limite',
'63' => 'règles de sécurité non respectées',
'68' => 'réponse non parvenue ou reçue trop tard',
'90' => 'arrêt momentané du système',
'91' => 'émetteur de cartes inaccessible',
'96' => 'mauvais fonctionnement du système',
'94' => 'transaction dupliquée',
'97' => 'échéance de la temporisation de surveillance globale',
'98' => 'serveur indisponible routage réseau demandé à nouveau',
'99' => 'incident domaine initiateur'),
'warranty_results' => array(
'YES' => 'Le paiement est garanti',
'NO' => 'Le paiement n\'est pas garanti',
'UNKNOWN' => 'Suite à une erreur technique, le paiment ne peut pas être garanti'));
//TODO not tested. not used.
// /**
// * Replace current translation entries with provided ones
// * @param array $translation
// */
// function loadTranslation($translation) {
// return $this->translation = $this->_recurseLoadTranslation($this->translation, $translation);
// }
//
// /**
// * Recursively load a $loaded translation array into the $original translation array
// * @param array $original
// * @param array $loaded
// */
// function _recurseLoadTranslation($original, $loaded) {
// foreach ($original as $key => $value) {
// if (is_array($value)) {
// $original[$key] = $this->_recurseLoadTranslation($original[$key], $array[$key]);
// }
// else if(array_key_exists($value, $loaded)) {
// $original[$key] = $loaded[$value];
// }
// }
// return $original;
// }
/**
* Load response codes and translations from a parameter array.
* @param array[string]string $raw
* @param boolean $authentified
*/
function load($raw, $certificate) {
$this->raw_response = is_array($raw) ? $raw : array();
$this->certificate = $certificate;
// Get codes
$code = $this->_findInArray('vads_result', $raw, null);
$extraCode = $this->_findInArray('vads_extra_result', $raw, null);
$authCode = $this->_findInArray('vads_auth_result', $raw, null);
$warrantyCode = $this->_findInArray('vads_warranty_code', $raw, null);
// Common translations
$noCode = $this->translation['no_code'];
$noTrans = $this->translation['no_translation'];
// Result and extra result
if ($code == null) {
$message = $noCode;
$extraMessage = ($extraCode == null) ? $noCode : $noTrans;
} else {
$message = $this->_findInArray($code, $this->translation['results'],
$noTrans);
if ($extraCode == null) {
$extraMessage = $noCode;
} elseif ($code == 30) {
$extraMessage = $this->_findInArray($extraCode,
$this->translation['extra_results_30'], $noTrans);
} else {
$extraMessage = $this->_findInArray($extraCode,
$this->translation['extra_results_default'], $noTrans);
}
}
// auth_result
if ($authCode == null) {
$authMessage = $noCode;
} else {
$authMessage = $this->_findInArray($authCode,
$this->translation['auth_results'], $noTrans);
}
// warranty_result
if ($warrantyCode == null) {
$warrantyMessage = $noCode;
} else {
$warrantyMessage = $this->_findInArray($warrantyCode,
$this->translations['warranty_results'], $noTrans);
}
$this->code = $code;
$this->message = $message;
$this->authCode = $authCode;
$this->authMessage = $authMessage;
$this->extraCode = $extraCode;
$this->extraMessage = $extraMessage;
$this->warrantyCode = $warrantyCode;
$this->warrantyMessage = $warrantyMessage;
}
/**
* Check response signature
* @return boolean
*/
function isAuthentified() {
return VadsApi::sign($this->raw_response, $this->certificate)
== $this->get('signature');
}
/**
* Return the signature computed from the received parameters, for log/debug purposes.
* @param boolean $hashed apply sha1, false by default
* @return string
*/
function getComputedSignature($hashed = false) {
return VadsApi::sign($this->raw_response, $this->certificate, $hashed);
}
/**
* Check if the payment was successful (waiting confirmation or captured)
* @return boolean
*/
function isAcceptedPayment() {
return $this->code == '00';
}
/**
* Check if the payment is waiting confirmation (successful but the amount has not been transfered and is not yet guaranteed)
* @return boolean
*/
function isPendingPayment() {
return $this->get('auth_mode') == 'MARK';
}
/**
* Check if the payment process was interrupted by the client
* @return boolean
*/
function isCancelledPayment() {
return $this->code == '17';
}
/**
* Return the value of a response parameter.
* @param string $name
* @return string
*/
function get($name) {
// Manage shortcut notations by adding 'vads_'
if (!array_key_exists($name, $this->raw_response)) {
$name = 'vads_' . $name;
}
return @$this->raw_response[$name];
}
/**
* Return the paid amount converted from cents (or currency equivalent) to a decimal value
* @return float
*/
function getFloatAmount() {
$currency = VadsApi::findCurrencyByNumCode($this->get('currency'));
return $currency->convertAmountToFloat($this->get('amount'));
}
/**
* Return a short description of the payment result, useful for logging
* @return string
*/
function getLogString() {
$log = $this->code . ' : ' . $this->message;
if ($this->code == '30') {
$log .= ' (' . $this->extraCode . ' : ' . $this->extraMessage . ')';
}
return $log;
}
/**
* Return a formatted string to output as a response to the check url call
* @param string $case shortcut code for current situations. Most useful : payment_ok, payment_ko, auth_fail
* @param string $extraMessage some extra information to output to the payment gateway
* @return string
*/
function getOutputForGateway($case = '', $extraMessage = "") {
$success = false;
$message = '';
// Messages prédéfinis selon le cas
$cases = array(
'payment_ok' => array(true, 'Paiement valide traité'),
'payment_ko' => array(true, 'Paiement invalide traité'),
'payment_ok_already_done' => array(
true,
'Paiement valide traité, déjà enregistré'),
'order_not_found' => array(false, 'Impossible de retrouver la commande'),
'payment_ko_on_order_ok' => array(
false,
'Code paiement invalide reçu pour une commande déjà validée'),
'auth_fail' => array(false, 'Echec authentification'),
'ok' => array(true, ''),
'ko' => array(false, ''));
if (array_key_exists($case, $cases)) {
$success = $cases[$case][0];
$message = $cases[$case][1];
}
$message .= ' ' . $extraMessage;
$message = str_replace("\n", '', $message);
$response = '';
$response .= '';
return $response;
}
/**
* Private shortcut function
* @param string $value
* @param array[string]string $translations
* @param string $defaultTransation
* @access private
*/
function _findInArray($key, $array, $default) {
if (is_array($array) && array_key_exists($key, $array)) {
return $array[$key];
}
return $default;
}
}
/**
* Class representing a field of the form to send to the payment gateway
* @package VadsApi
*/
class VadsField {
/**
* Field's name. Matches the html input attribute
* @var string
* @access private
*/
var $name;
/**
* Field's label in english, to be used by translation systems
* @var string
* @access private
*/
var $label;
/**
* Field's maximum length. Matches the html text input attribute
* @var int
* @access private
*/
var $length;
/**
* PCRE regular expression the field value must match
* @var string
* @access private
*/
var $regex;
/**
* Whether the form requires the field to be set (even to an empty string)
* @var boolean
* @access private
*/
var $required;
/**
* Field's value. Null or string
* @var string
* @access private
*/
var $value = null;
/**
* Constructor
* @param string $name
* @param string $label
* @param string $regex
* @param boolean $required
* @param string $value
* @return VadsField
*/
function VadsField($name, $label, $regex, $required = false, $length = 255) {
$this->name = $name;
$this->label = $label;
$this->regex = $regex;
$this->required = $required;
$this->length = $length;
}
/**
* Setter for value
* @param mixed $value
* @return boolean true if the value is valid
*/
function setValue($value) {
$value = ($value === null) ? null : (string) $value;
// We save value even if invalid (in case the validate function is too restrictive, it happened once) ...
$this->value = $value;
if (!$this->validate($value)) {
// ... but we return a "false" warning
return false;
}
return true;
}
/**
* Checks the current value
* @return boolean false if the current value is invalid or null and required
*/
function isValid() {
return $this->validate($this->value);
}
/**
* Check if a value is valid for this field
* @param string $value
* @return boolean
*/
function validate($value) {
if ($value === null && $this->isRequired()) {
return false;
}
if ($value !== null && !preg_match($this->regex, $value)) {
return false;
}
return true;
}
/**
* Setter for the required attribute
* @param boolean $required
*/
function setRequired($required) {
$this->required = (boolean) $required;
}
/**
* Is the field required in the payment request ?
* @return boolean
*/
function isRequired() {
return $this->required;
}
/**
* Return the current value of the field.
* @return string
*/
function getValue() {
return $this->value;
}
/**
* Return the name (html attribute) of the field.
* @return string
*/
function getName() {
return $this->name;
}
/**
* Return the english human-readable name of the field.
* @return string
*/
function getLabel() {
return $this->label;
}
/**
* Return the maximum length of the field's value.
* @return number
*/
function getLength() {
return $this->length;
}
/**
* Has a value been set ?
* @return boolean
*/
function isFilled() {
return !is_null($this->getValue());
}
}
/**
* Class representing a currency, used for converting alpha/numeric iso codes and float/integer amounts
* @package VadsApi
*
*/
class VadsCurrency {
var $alpha3;
var $num;
var $decimals;
function VadsCurrency($alpha3, $num, $decimals = 2) {
$this->alpha3 = $alpha3;
$this->num = $num;
$this->decimals = $decimals;
}
function convertAmountToInteger($float) {
$coef = pow(10, $this->decimals);
return round(intval($float) * $coef);
}
function convertAmountToFloat($integer) {
$coef = pow(10, $this->decimals);
return floatval($integer) / $coef;
}
}
// No closing tag