La operativa de integración ha de quedar muy clara antes de tocar cualquier tipo de código y programación en tu tienda, por eso vamos a explicar los pasos que seguirá una compra con el TPV de BidoBido integrado:

• El cliente realiza una compra, normalmente confirmando un carrito o cesta de la compra. Dicha operación lleva asociado un pago.
• El cliente escoge entre todos los métodos de pago que haya configurado la tienda en el TPV de BidoBido.
• En este momento comienza la integración con el TPV. Debes conectar el action del formulario donde el cliente ha seleccionado el TPV de BidoBido (o la página donde recojas datos) a una nueva página llamada pagar_bidobido.php cuyo código tienes en la pestaña ”Descarga”.
• Debes configurar el código que ofrecemos para que se ajuste a tus necesidades y recoja variables que nosotros declaramos:

<?php
//script para el envio de pago
//establece un numero aleatorio para identificar la transaccion
$identificador_transaccion=rand(10,99).time();
//cantidad a pagar
$cantidad=5;
//moneda que se va a utilizar EUR = 1
$moneda = "1";
//el terminal que te hemos proporcionado
$terminal=1;
//tipo de transaccion a realizar, de momento a 0
$tipo_transaccion="0";
//idioma Espanol=1
$idioma_usuario="1";
//identificador que te hemos proporcionado
$identificador_bidobido=58143218;
//contrasena especifica para el metodo de pago que te hemos proporcionado  
$contrasena_metodo_pago="password123";
...

• Variables como $identificador_transaccion y $cantidad son valores que ésta página -pagar_bidobido.php- tiene que recoger del formulario de tu tienda online. Así que deberás modificar el script para recoger esos valores por $_POST, un ejemplo:

 $identificador_transaccion=$_POST['identificador_transaccion'];
 $cantidad=$_POST['cantidad'];
 ...

• Otra variables como $identificador_bidobido, $terminal y $contrasena_metodo_pago te las facilitaremos nosotros con el alta para que las cumplimentes adecuadamente.
• Además y como último paso de configuración en pagar_bidobido.php deberás especificar las urls ok y ko de tu tienda, además de la ubicación de url_oculta.php, que es el segundo script que ofrecemos zip del plugin:

 //url oculta en tu sistema en la que se realizaran todas las acciones
$url_pago_oculto="http://www.tuweb.com/url_oculta.php?transaccion=".$orden_transaccion;
 
//url a la que redirigira bidobido despues de una transaccion correcta  
$url_pago_ok="http://www.tuweb.com/url_todo_correcto.php?transaccion=".$orden_transaccion;
 
//url a la que redirigira bidobido despues de una transaccion incorrecta  
$url_pago_ko="http://www.tuweb.com/url_todo_incorrecto.php?transaccion=".$orden_transaccion;
...

• Esos scripts ok y ko son donde debes indicarle al usuario que todo ha ido correctamente y seguir con la creación del envío o si ha surgido algún error en el pago (respectivamente).

Nota: Para que la integración del plugin sea correcta hay que crear una tabla MySQL donde se van a guardar los detalles de cada transacción. En este punto vas a tener que usar una herramienta (phpMyAdmin, consola de MySQL o similar) para conectarte a MySQL e indicarle que vas a crear una tabla nueva dentro de tu base de datos. Una vez dentro de la herramienta ejecuta este SQL:

--
-- Estructura de tabla para la tabla `bidobido_transacciones`
--
CREATE TABLE IF NOT EXISTS `bidobido_transacciones` (
 `transaccion_id` bigint(20) NOT NULL,
 `cantidad` decimal(8,2) NOT NULL,
 `moneda` varchar(3) collate utf8_unicode_ci NOT NULL,
 `fecha_transaccion` datetime NOT NULL,
 `estado` tinyint(4) NOT NULL DEFAULT '0' COMMENT '0:sin realizar,1:aceptado,2:finalizado',
 `session` varchar(32) collate utf8_unicode_ci NOT NULL,
PRIMARY KEY (`transaction_id`)
) ENGINE=MyISAM;

En la sección “Descarga” tendrás los scripts para integrar en tu tienda online:

• pagar_bidobido.php: Recogerá valores específicos de la compra (precio, id de transacción) y junto con los valores que te hemos facilitado en el alta del TPV de BidoBido (identificador_bidobido, password…) realizará el pago devolviendo un ok o un ko. Necesita 'url_oculta.php' para el funcionamiento completo del proceso.
• url_oculta.php: Script necesario para completar el funcionamiento del pago con 'pagar_bidobido.php', hace falta configurarlo, tan solo poner el identificador_bidobido y password, despues, subirlo al servidor e indicar su ruta en 'pagar_bidobido.php' ($url_pago_oculto).

En ocasiones el TPV puede devolver algún tipo de error si la operación no se ha realizado con éxito, los códigos de error más frecuentes son los siguientes: