Integración de código

Documentación de Integración
Código Fuente y Plugins

Recuerda que para integrar el código debes estar registrado y haberte dado de alta

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 tenga la tienda configurado el TPV de BidoBido.
En este momento comienza la integración con el TPV de BidoBido. 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 "Código Fuente".
Debes configurar el código php 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 esta 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 en el "Código Fuente":

	//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).

RESUMEN

En la sección "Código Fuente" tendrás 2 scripts por cada lenguaje de programación (en estos momentos solo está disponible PHP), que tendrás que 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', no hace falta configurarlo, tan solo descargarlo, subirlo al servidor e indicar su ruta en 'pagar_bidobido.php' ($url_pago_oculto).

ERRORES

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:

Error1.-Los valores de los parámetros no coinciden en tipo de error (entero, cadena...) o no tienen la longitud adecuada.
Error2.-No existe empresa ni terminal.
Error3.-No coincide la firma.
Error4.-Transacción repetida, ya realizada o fallida.
Error5.-Transacción repetida no realizada.