Ultimamente he estado implicado en un proyecto que requería hacer una pasarela de pago con PayPal de modo que me puse a buscar información al respecto y me he dado cuenta que resulta complicado obtener ejemplos funcionales por lo que he decidido hacer esta pequeña entrada para aquellos que se encuentren en mi misma situación lo tengan un poco más fácil.

Existen muchas forma de realizar un pago mediante paypal : Pago express , carro de la compra , pago estándar ... Dentro de cada uno de estos formatos existen muchos otras formas de realizar el pago. El más tradicional y el cual seguramente muchos de vosotros habréis usado es el pago estándar ya sea para pagar algún producto de una tienda online o para realizar una donación en los muchos sitios web que piden donaciones , de modo que este va a ser nuestro caso de estudio.

Pero antes de nada para aquellos que todavía no sepan que es Paypal os añado la definición propia de wikipedia :

PayPal es una empresa estadounidense perteneciente al sector del comercio electrónico por Internet que permite la transferencia de dinero entre usuarios que tengan correo electrónico, una alternativa al tradicional método en papel como los cheques o giros postales. PayPal también procesa peticiones de pago en comercio electrónico y otros servicios webs, por los que cobra un porcentaje. La mayor parte de su clientela proviene del sitio de subastas en línea eBay.

Primero hay que entender como funciona el flujo de datos en este tipo de transacciones para ello no hay nada mejor que una imagen procedente de PayPal : 

En la imagen podemos observar como partiendo de nuestro sitio web mediante un formulario que tendrá una serie de campos ocultos podemos acceder a paypal donde se realizará el pago , una vez se realiza el pago PayPal envía una notificación mediante su protocolo IPN (Instant Payment Notification o notificación instantánea de pago) a través de ella conoceremos el estado que ha tenido la transacción así como una serie de datos añadidos que permitirán que podemos tener un control absoluto sobre el estado del pago.

Ya que no puedo concentrar todas las posibilidades que tiene este método de pago voy a explicarlo a través de un pequeño código de ejemplo para que podáis tener más información de la que aparece en la documentación de paypal.

Algo que tenéis que tener en cuenta a la hora de desarrollar una pasarela de pago con PayPal es que debéis conocer el sandbox o entorno de prueba (https://www.sandbox.paypal.com/) , para poder utilizar la DEMO o modificar/usar estos scripts tenéis que daros de alta y crear compradores y vendedores ficticios.

Formulario.html

 
 






#GALLETAS5 ; Nombre: Galletas ; Valor : 5.00 , Cantidad : 2

 
 
 
#PIRULETAS3 ; Nombre: Piruletas ; Valor : 3.00 , Cantidad : 5

 
 
 
 

Como podréis observar el campo action del formulario nos lleva al sandbox de PayPal , es decir , al sitio de pruebas donde podremos testear nuestro script , en caso de querer realizar el testeo directamente con PayPal deberemos de eleminar el subdominio sandbox dejándolo como : https://www.paypal.com/cgi-bin/webscr.

Repecto a los demás campos:

• cmd > indica el tipo de fichero que va a recoger PayPal 
  _cart : varios items
  _donations : donaciones
  _xclick : boton de compra
• business > indica el identificador del negocio registrado en paypal. Ejemplo : buyer_1265883185_biz@gmail.com
• shopping_url > la dirección de nuestra tienda online . Ejemplo : http://www.fernandosalom.es
• currency_code > el tipo de moneda (USD , EUR ...)
• return > sera el enlace de vuelta a nuestro negocio que ofrece paypal
• notify_url > en esta pagina es donde recogeremos el estado del pago y un gran numeros de variables con informacion adicional en nuestro caso lo hemos llamado paypal_ipn.php
• rm > Indica el método que se va a utilizar para enviar la información de vuelta a nuestro sitio. RM=1 información enviada por GET , RM=2 información enviada por POST (En este caso usamos este método porque es un script php el que recoge los datos) . (Gracias Miguel)
• item_number_X > identificador del producto
• item_name_X > nombre del producto
• amount_X > precio del producto
• quantity_X > cantidad del producto

Paypal_ipn.php

 
<\?php

//Leer POST del sistema de PayPal y añadir 'cmd'
$req = 'cmd=_notify-validate';
foreach ($_POST as $key => $value) {
$value = urlencode(stripslashes($value));
$req .= "&$key=$value";
}
//header para el sistema de paypal
$header  = "POST /cgi-bin/webscr HTTP/1.0\r\n";
$header .= "Content-Type: application/x-www-form-urlencoded\r\n";
$header .= "Content-Length: " . strlen($req) . "\r\n\r\n";
//header para el correo
$headers = 'From: webmaster@ejemplo.com' . "\r\n" .
           'Reply-To: webmaster@ejemplo.com' . "\r\n" .
           'X-Mailer: PHP/' . phpversion();
//Si estamos usando el testeo de paypal:
$fp = fsockopen ('ssl://www.sandbox.paypal.com', 443, $errno, $errstr, 30);
//En caso de querer usar PayPal oficialmente:
//$fp = fsockopen ('ssl://www.paypal.com', 443, $errno, $errstr, 30);
if (!$fp) {
// ERROR DE HTTP
}else{
fputs ($fp, $header . $req);
while (!feof($fp)) {
$res = fgets ($fp, 1024);
if (strcmp ($res, "VERIFIED") == 0) {

//Almacenamos todos los valores recibidos por $_POST.
foreach($_POST as $key => $value){
        $recibido.= $key." = ". $value."\r\n";
}
//Enviamos por correo todos los datos , esto es solo para que veáis como funciona
//En un caso real accederíamos a una BBDD y almacenaríamos los datos.
// > Comprobando que payment_status es Completed
// > Comprobando que txn_id no ha sido previamente procesado
// > Comprobando que receiver_email es tu email primario de paypal
// > Comprobando que payment_amount/payment_currency son procesos de pago correctos

mail("micorreo", "NOTIFICACION DE PAGO", $recibido , $headers);
}else if (strcmp ($res, "INVALID") == 0) {
mail("micorreo", "NOTIFICACION DE PAGO INVALIDA", "invalido",$headers);
}
}fclose ($fp);
}
?>

Este script no se visualiza ya que no hacemos un acceso directo a él sino que es PayPal el que lo ejecuta para notificarnos los datos de la transacción , es por ello que en este script he hecho que nos envíe un correo con los datos de la operación si han sido válidos o no. Para ello lo único que debemos modificar es el texto micorreo por nuestro correo electrónico.

Este no es el procedimiento adecuado para recoger estos datos ya que lo que deberíamos de hacer es crear un script con su correspondiente BBDD que comprobará los datos y los insertará para tener un registro de todas las transacciones.

Si deseáis preguntar algo comentarlo y lo contestaré conforme tenga tiempo , a continuación os dejo una serie de enlaces de interés sobre este tema.

> DEMO de este ejemplo en funcionamiento Recordar que debéis de daros de alta en el SANDBOX y crear un comprador ficticio para que os funcione

> Documentación para pagos estándares