docsia es una aplicación que sirve de intermediario entre su aplicación y los sistemas de pago de Lacaixa y PayPal.

Funciona de la siguiente manera:

• La Web debe ser registrada en www.docsia.com

• Al registrarse se le dará unos datos únicos para poder conectar con docsia

• Podrá hacer peticiones POST a docsia y conectar a los diferentes sistemas de pago.

• docsia registrará su orden y después de verificar sus datos procederá a conectar con la pasarela solicitada. Luego de procesar la orden docsia redirigirá al usuario hasta su sitio Web y enviará una notificación post sobre el estado de la orden.

El registro se realiza por un administrador.

Los datos para el registro son:

1. Nombre: Nombre que representara la Web dentro del sistema de docsia
2. Web: Url  completa de la web
3. Url Success: URL a donde se redirigirán los usuarios después de completar su pago.
4. Url denied: URL a donde se redigirán los usuarios al no completar correctamente un pago. "Este aplica solo para TPV y es obligatorio"
5. Url notification: URL a la que se enviarán los datos del pago vía POST
6. Url del logo: URL de logo de la Web que se mostrará en la cabecera de PayPal.
7. Color: Color hexadecimal pero omitiendo el "#", este color será usado para personalizar un poco la pantalla de detalle de PayPal.

Una vez registrado se le mostrará unos datos que usara para generar una key valida para conectar con docsia y realizar pagos.

Los datos deben ser parecidos a estos:

<?php
$storeId=4;
$key=time();
$merchant="96bb7e817dd1dd41fd71";
$token=sha1($key.$merchant.$storeId);
?>

Este token debe generarse siempre que se envie el formulario

Donde:
$storeId: Es el id del comercio que se muestra arriba
$key: Es un integer generado con time
$merchant: Es el código de autorización del comercio

<form method='post' action="https://www.domiya.com/domino/domserpal.html" >
  <input type="hidden" name="test" value="1"><!-- Si es una prueba -->
  <input name="id" value="<?php echo $key;?>">
  <input name="terminal" value="<?php echo $storeId; ?>">
  <input  name="token" value="<?php echo $token; ?>">
  <input  name="item_description"  value="nombre del articulo">
  <input  name="custom"  value="dato a recibir en respuesta">
  <input  name="item_amount" value="20,00"><!-- Mantener decimales ",00" ó ".00" -->
  <input type="submit"  value="enviar">
</form>
                

<form method='post' action="https://www.domiya.com/domino/domser.html" >
  <input type="hidden" name="test" value="1"><!-- Si es una prueba -->
  <input name="id" value="<?php echo $key;?>">
  <input name="terminal" value="<?php echo $storeId; ?>">
  <input  name="token" value="<?php echo $token; ?>">
  <input  name="item_description"  value="nombre del articulo">
  <input  name="custom"  value="dato a recibir en respuesta">
  <input  name="item_amount" value="20,00"><!-- Mantener decimales ",00" ó ".00" -->
  <input type="submit"  value="enviar">
</form>
                

Las respuestas siempre serán un array parecido al siguiente, tener pendiente que los status son en mayúsculas

array(
    [amount] => 1.00
    [status] => Completada / Denegada  
    [custom] => 2NQ9KyKH21
    [method] => paypal
    [date] => 2014/11/07
    [hour] => 15:21:44
    [item_description] => Contrato del planBasíco
    [transaction_id] => 207
    [currency] => EUR
)


array(
    [amount] => 1.00
    [status] => Completada / Denegada
    [custom] => QYVd2kBT22
    [method] => domiya
    [date] => 2014/11/07
    [hour] => 16:29:05
    [item_description] => Contrato del planBasíco
    [transaction_id] => 226
    [currency] => EUR
)

Las respuestas siempre serán un array parecido al siguiente, tener pendiente que los status son en mayúsculas

array(
    [amount] => 1.00
    [status] => Completada / Denegada  
    [custom] => 2NQ9KyKH21
    [method] => paypal
    [date] => 2014/11/07
    [hour] => 15:21:44
    [item_description] => Contrato del planBasíco
    [transaction_id] => 207
    [currency] => EUR
)


array(
    [amount] => 1.00
    [status] => Completada / Denegada
    [custom] => QYVd2kBT22
    [method] => domiya
    [date] => 2014/11/07
    [hour] => 16:29:05
    [item_description] => Contrato del planBasíco
    [transaction_id] => 226
    [currency] => EUR
)