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.jsp 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:

<%@page language="java" contentType="text/html; charset=ISO-8859-15" pageEncoding="ISO-8859-15"	import="java.util.*,java.lang.*"%>
<%@page import="java.text.NumberFormat" %>
<%@page import="bidobido.*" %>
<%@page import="java.net.*" %>
<%
//Bidobido Payment Module Copyright (c) 2009 bidobido   
//http://www.bidobido.com
//script para el envio de pago 
//Creamos un número aleatorio de 7 dígitos para identificar la transaccion 
//Esto es un ejemplo, puedes usar el identificador de transacción que desees
int identificador_transaccion=(int)(Math.random()*10000000);
//Recogemos la cantidad a pagar 
//String cantidad=request.getParameter("cantidad");
String cantidad="10";
//moneda que se va a utilizar EUR = 1 
String moneda = "1";
//el terminal que te hemos proporcionado 
int terminal=1;
//tipo de transaccion a realizar, de momento a 0 
String tipo_transaccion="0";
//idioma, Espanol=1 
String idioma_usuario="1";
//identificador que te hemos proporcionado 
int identificador_bidobido=11111111; 
//contrasena especifica para el metodo de pago que te hemos proporcionado 
String contrasena_metodo_pago="xxxxxxx"; 
...

• Variables como $identificador_transaccion y $cantidad son valores que ésta página -pagar_bidobido.jsp- tiene que recoger del formulario de tu tienda online. Así que deberás modificar el script para recoger esos valores por $_POST.
• 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.jsp deberás especificar las urls ok y ko de tu tienda, además de la ubicación de url_oculta.jsp, que es el segundo script que ofrecemos zip del plugin:

//url oculta en tu sistema en la que se realizaran todas las acciones 
String url_pago_oculto="http://www.tuweb.com/url_oculta.jsp?transaccion="+identificador_transaccion; 
//url a la que redirigira bidobido despues de una transaccion correcta 
String url_pago_ok="http://www.tuweb.com/url_todo_correcto.jsp?transaccion="+identificador_transaccion; 
//url a la que redirigira bidobido despues de una transaccion incorrecta 
String url_pago_ko="http://www.tuweb.com/url_todo_incorrecto.jsp?transaccion="+identificador_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.jsp: 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.jsp' para el funcionamiento completo del proceso.
• url_oculta.jsp: Script necesario para completar el funcionamiento del pago con 'pagar_bidobido.jsp', hace falta configurarlo, tan solo poner el identificador_bidobido y password, despues, subirlo al servidor e indicar su ruta en 'pagar_bidobido.jsp' ($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: