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

    <%@ LANGUAGE="VBScript" %>
    <!--#include file="clsSHA1.asp"   -->
    <%
    ' Conversión del script pagar_bidobido.php a lenguaje ASP 
    '  script para el envio de pago
    '  establece un numero aleatorio para identificar la transaccion Ž
    identificador_transaccion = FIX(1000000000000 * Rnd )
    '  cantidad a pagar x 100
    cantx100="440" 
    '  moneda que se va a utilizar EUR = 1 
    monedabido = "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 = "xxxxxxxx" 
    '  contrasena especifica para el metodo de pago que te hemos proporcionado 
    contrasena_metodo_pago = "xxxxxxxx" 
    ...

• Variables como $identificador_transaccion y $cantidad son valores que ésta página -pagar_bidobido.asp- 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.asp deberás especificar las urls ok y ko de tu tienda, además de la ubicación de url_oculta.asp, 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.asp?transaccion=".$identificador_transaccion; 
    ' url a la que redirigira bidobido despues de una transaccion correcta 
    url_pago_ok="http://www.tuweb.com/url_todo_correcto.asp?transaccion=".$identificador_transaccion; 
    ' url a la que redirigira bidobido despues de una transaccion incorrecta 
    url_pago_ko="http://www.tuweb.com/url_todo_incorrecto.asp?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.asp: 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.asp' para el funcionamiento completo del proceso.
• url_oculta.asp: Script necesario para completar el funcionamiento del pago con 'pagar_bidobido.asp', hace falta configurarlo, tan solo poner el identificador_bidobido y password, despues, subirlo al servidor e indicar su ruta en 'pagar_bidobido.asp' ($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: