add_field('business', 'somebody@domain.com');
* $p->add_field('first_name', $_POST['first_name']);
* ... (add all your fields in the same manor)
* $p->submit_paypal_post();
*
* To process an IPN, have your IPN processing file contain:
*
* $p = new PaymentHelper;
* if ($p->validate_ipn()) {
* ... (IPN is verified. Details are in the ipn_data() array)
* }
*
*
* In case you are new to paypal, here is some information to help you:
*
* 1. Download and read the Merchant User Manual and Integration Guide from
* http://www.paypal.com/en_US/pdf/integration_guide.pdf. This gives
* you all the information you need including the fields you can pass to
* paypal (using add_field() with this class) aswell as all the fields
* that are returned in an IPN post (stored in the ipn_data() array in
* this class). It also diagrams the entire transaction process.
*
* 2. Create a "sandbox" account for a buyer and a seller. This is just
* a test account(s) that allow you to test your site from both the
* seller and buyer perspective. The instructions for this is available
* at https://developer.paypal.com/ as well as a great forum where you
* can ask all your paypal integration questions. Make sure you follow
* all the directions in setting up a sandbox test environment, including
* the addition of fake bank accounts and credit cards.
*
*******************************************************************************
*/
class PaymentHelper {
var $paypal_url; // Paypal url
var $last_error; // holds the last error encountered
var $ipn_log; // bool: log IPN results to text file?
var $ipn_log_file; // filename of the IPN log
var $ipn_response; // holds the IPN response from paypal
var $ipn_data = array(); // array contains the POST values for IPN
var $fields = array(); // array holds the fields to submit to paypal
var $errores_tpv = array(
"SIS0007" => "Error al desmontar el XML de entrada",
"SIS0008"=> "Error falta Ds_Merchant_MerchantCode",
"SIS0009"=> "Error de formato en Ds_Merchant_MerchantCode",
"SIS0010"=> "Error falta Ds_Merchant_Terminal",
"SIS0011"=> "Error de formato en Ds_Merchant_Terminal",
"SIS0014"=> "Error de formato en Ds_Merchant_Order",
"SIS0015"=> "Error falta Ds_Merchant_Currency",
"SIS0016"=> "Error de formato en Ds_Merchant_Currency",
"SIS0018"=> "Error falta Ds_Merchant_Amount",
"SIS0019"=> "Error de formato en Ds_Merchant_Amount",
"SIS0020"=> "Error falta Ds_Merchant_MerchantSignature",
"SIS0021"=> "Error la Ds_Merchant_MerchantSignature viene vacÃa",
"SIS0022"=> "Error de formato en Ds_Merchant_TransactionType",
"SIS0023"=> "Error Ds_Merchant_TransactionType desconocido",
"SIS0026"=> "Error No existe el comercio / terminal enviado",
"SIS0027"=> "Error Moneda enviada por el comercio es diferente a la que tiene asignada para ese terminal",
"SIS0028"=> "Error Comercio / terminal estaÌ dado de baja",
"SIS0030"=> "Error en un pago con tarjeta ha llegado un tipo de operacioÌn no valido",
"SIS0031"=> "MeÌtodo de pago no definido",
"SIS0034"=> "Error de acceso a la Base de Datos ",
"SIS0038"=> "Error en java",
"SIS0040"=> "Error el comercio / terminal no tiene ninguÌn meÌtodo de pago asignado",
"SIS0041"=> "Error en el caÌlculo de la firma de datos del comercio",
"SIS0042"=> "La firma enviada no es correcta",
"SIS0046"=> "El BIN de la tarjeta no estaÌ dado de alta",
"SIS0051"=> "Error nuÌmero de pedido repetido",
"SIS0054"=> "Error no existe operacioÌn sobre la que realizar la devolucioÌn",
"SIS0055"=> "Error no existe maÌs de un pago con el mismo nuÌmero de pedido",
"SIS0056"=> "La operacioÌn sobre la que se desea devolver no estaÌ autorizada",
"SIS0057"=> "El importe a devolver supera el permitido",
"SIS0058"=> "Inconsistencia de datos, en la validacioÌn de una confirmacioÌn",
"SIS0059"=> "Error no existe operacioÌn sobre la que realizar la devolucioÌn",
"SIS0060"=> "Ya existe una confirmacioÌn asociada a la preautorizacioÌn",
"SIS0061"=> "La preautorizacioÌn sobre la que se desea confirmar no estaÌ autorizada",
"SIS0062"=> "El importe a confirmar supera el permitido",
"SIS0063"=> "Error. NuÌmero de tarjeta no disponible",
"SIS0064"=> "Error. El nuÌmero de tarjeta no puede tener maÌs de 19 posiciones",
"SIS0065"=> "Error. El nuÌmero de tarjeta no es numeÌrico",
"SIS0066"=> "Error. Mes de caducidad no disponible",
"SIS0067"=> "Error. El mes de la caducidad no es numeÌrico",
"SIS0068"=> "Error. El mes de la caducidad no es vaÌlido",
"SIS0069"=> "Error. Año de caducidad no disponible",
"SIS0070"=> "Error. El Año de la caducidad no es numeÌrico",
"SIS0071"=> "Tarjeta caducada",
"SIS0072"=> "OperacioÌn no anulable",
"SIS0074"=> "Error falta Ds_Merchant_Order",
"SIS0075"=> "Error el Ds_Merchant_Order tiene menos de 4 posiciones o maÌs de 12",
"SIS0076"=> "Error el Ds_Merchant_Order no tiene las cuatro primeras posiciones numeÌricas",
"SIS0078"=> "MeÌtodo de pago no disponible",
"SIS0079"=> "Error al realizar el pago con tarjeta",
"SIS0081"=> "La sesioÌn es nueva, se han perdido los datos almacenados",
"SIS0089"=> "El valor de Ds_Merchant_ExpiryDate no ocupa 4 posiciones",
"SIS0092"=> "El valor de Ds_Merchant_ExpiryDate es nulo",
"SIS0093"=> "Tarjeta no encontrada en la tabla de rangos",
"SIS0112"=> "Error. El tipo de transaccioÌn especificado en Ds_Merchant_Transaction_Type no esta permitido",
"SIS0115"=> "Error no existe operacioÌn sobre la que realizar el pago de la cuota",
"SIS0116"=> "La operacioÌn sobre la que se desea pagar una cuota no es una operacioÌn vaÌlida",
"SIS0117"=> "La operacioÌn sobre la que se desea pagar una cuota no estaÌ autorizada",
"SIS0118"=> "Se ha excedido el importe total de las cuotas",
"SIS0119"=> "Valor del campo Ds_Merchant_DateFrecuency no vaÌlido",
"SIS0120"=> "Valor del campo Ds_Merchant_CargeExpiryDate no vaÌlido",
"SIS0121"=> "Valor del campo Ds_Merchant_SumTotal no vaÌlido",
"SIS0122"=> "Valor del campo Ds_merchant_DateFrecuency o Ds_Merchant_SumTotal tiene formato incorrecto",
"SIS0123"=> "Se ha excedido la fecha tope para realizar transacciones",
"SIS0124"=> "No ha transcurrido la frecuencia miÌnima en un pago recurrente sucesivo",
"SIS0132"=> "La fecha de ConfirmacioÌn de AutorizacioÌn no puede superar en maÌs de 7 diÌas a la de PreautorizacioÌn",
"SIS0139"=> "Error el pago recurrente inicial estaÌ duplicado SIS0142 Tiempo excedido para el pago",
"SIS0216"=> "Error Ds_Merchant_CVV2 tiene mas de 3/4 posiciones",
"SIS0217"=> "Error de formato en Ds_Merchant_CVV2",
"SIS0221"=> "Error el CVV2 es obligatorio",
"SIS0222"=> "Ya existe una anulacioÌn asociada a la preautorizacioÌn",
"SIS0223"=> "La preautorizacioÌn que se desea anular no estaÌ autorizada",
"SIS0225"=> "Error no existe operacioÌn sobre la que realizar la anulacioÌn",
"SIS0226"=> "Inconsistencia de datos, en la validacioÌn de una anulacioÌn",
"SIS0227"=> "Valor del campo Ds_Merchan_TransactionDate no vaÌlido",
"SIS0252"=> "El comercio no permite el enviÌo de tarjeta",
"SIS0253"=> "La tarjeta no cumple el check-digit",
"SIS9915"=> "El pago fue cancelado por el cliente",
"SIS0261"=> "OperacioÌn detenida por superar el control de restricciones en la entrada al SIS SIS0274 Tipo de operacioÌn desconocida o no permitida por esta entrada al SIS"
);
var $respuesta_tpv = array(
"0101" => "Tarjeta Caducada",
"0102" => "Tarjeta en excepcioÌn transitoria o bajo sospecha de fraude",
"0116" => "Disponible Insuficiente",
"0118" => "Tarjeta no Registrada",
"0180" => "Tarjeta ajena al servicio",
"0184" => "Error en la autenticacioÌn del titular",
"0190" => "DenegacioÌn sin especificar motivo",
"0191" => "Fecha de caducidad erroÌnea",
"0202" => "Tarjeta en excepcioÌn transitoria o bajo sospecha de fraude con retirada de tarjeta",
"0290" => "Rechazado por la entidad bancaria sin motivo",
"0912" => "Emisor no Disponible",
"9912" => "Emisor no Disponible",
"0904" => "Comercio no registrado en FUC",
"9064" => "NuÌmero de posiciones de la tarjeta incorrecto",
"9078" => "No existe meÌtodo de pago vaÌlido para esa tarjeta",
"9093" => "Tarjeta no existente",
"9218" => "El comercio no permite op. seguras por entrada /operaciones",
"9253" => "Tarjeta no cumple el check-digit",
"9256" => "El comercio no puede realizar preautorizaciones",
"9257" => "Esta tarjeta no permite operativa de preautorizaciones",
"9261" => "OperacioÌn detenida por superar el control de restricciones en la entrada al SIS",
"9913" => "Error en la confirmacioÌn que el comercio enviÌa al TPV Virtual (solo aplicable en la opcioÌn de sincronizacioÌn SOAP)",
"9914" => "Confirmacion KO del comercio (solo aplicable en la opcioÌn de sincronizacioÌn SOAP)",
"9928" => "AnulacioÌn de autorizacioÌn en diferido realizada por el SIS (proceso batch)",
"9929" => "AnulacioÌn de autorizacioÌn en diferido realizada por el comercio",
"9915" => "Cancelado por el usuario"
);
function __construct() {
// initialization constructor. Called when class is created.
$this->paypal_url = 'https://www.paypal.com/cgi-bin/webscr';
$this->last_error = '';
// Anael: Cuidado con este archivo porque no está en uso, debe ir a una carpeta fuera de /clases/
$this->ipn_log_file = 'ipn_log.txt';
$this->ipn_log = true;
$this->ipn_response = '';
// populate $fields array with a few default values. See the paypal
// documentation for a list of fields and their data types. These defaul
// values can be overwritten by the calling script.
}
function add_field($field, $value) {
// adds a key=>value pair to the fields array, which is what will be
// sent to paypal as POST variables. If the value is already in the
// array, it will be overwritten.
$this->fields["$field"] = $value;
}
function submit_paypal_post($curl = false, $showHtml=true) {
// this function actually generates an entire HTML page consisting of
// a form with hidden elements which is submitted to paypal via the
// BODY element's onLoad attribute. We do this so that you can validate
// any POST vars from you custom form before submitting to paypal. So
// basically, you'll have your own form which is submitted to your script
// to validate the data, which in turn calls this function to create
// another hidden form and submit to paypal.
// The user will briefly see a message on the screen that reads:
// "Please wait, your order is being processed..." and then immediately
// is redirected to paypal.
if (!$curl) {
echo "\n";
echo "Procesando pago...\n";
echo "\n";
if($showHtml){
echo "
Por favor, espera
";
echo "Estamos pasando a la pasarela de pago seguro...
\n";
}
echo "\n";
echo "\n";
}
else {
// Hacemos un curl enviando los datos por POST
$vars = [];
foreach ($this->fields as $name => $value) {
$vars[$name] = $value;
}
$ch = curl_init($this->paypal_url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($vars));
curl_setopt($ch, CURLOPT_TIMEOUT, 20);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
return $result;
}
}
function dump_fields() {
// Used for debugging, this function will output all the field/value pairs
// that are currently defined in the instance of the class using the
// add_field() function.
echo "PaymentHelper->dump_fields() Output:
";
echo "
| Field Name |
Value |
";
ksort($this->fields);
foreach ($this->fields as $key => $value) {
echo "| $key | ".urldecode($value)." |
";
}
echo "
";
echo "\n";
}
}