Pago Cash

Es uno de los otros servicio que tiene Paguelofacil para la comodidad de nuestros clientes afiliados, abarcando aquellos clientes que no poseen una tarjeta de crédito.
Pago-Cash consiste en que los clientes pueden pagar los servicios de su comercio a travez de la red de kioscos Punto Pago y automáticamente se le ve relejado en su cuenta de Paguelofacil.

Prerrequisitos

CCLW
Llaves de conexión al API
Certificado SSL
TLS 1.3 o superior

Base URL de ambientes

Producción
https://secure.paguelofacil.com/
https://api.pfserver.net/
Pruebas
https://sandbox.paguelofacil.com/
https://api-sand.pfserver.net/
Servicio POST
/webservices/rest/regCashTx

 

Flujo de Pago

Proceso PagoCash

 

Solicitar un Código (Request)

Debes hacer la solicitud de un PP de pago, indicando la información correspondiente del pago

Ejemplo, php del código de generación de PP.



 $restUrl = "https://sandbox.paguelofacil.com/webservices/rest/regCashTx";
 
 $amount = "1.00"; //amount total for transaction
 $email = "alabrito@gmail.com"; //customer email
 $phone = "+50766666666"; //customer phone
 $description = "Pay for cash"; //Description for pay
 $cclw = "18054582121180545821211805458212118054582121180545821211805458212118054582121"; //Paguelofacil code
 
 $cashExpired = null;
 //$cashExpired = 10; //duration in minutes for link payment (ex: 10 minutes)
 
  $data = Array(
      "amount" => $amount,
      "email" => $email,
      "phone" => $phone,
      "concept" => $description,
      "idUsrRegTx" => null,
      "cclw" => $cclw,
      "cashExpired" => $cashExpired,
      "customFieldValues"  => [["id"=>"idOrder","nameOrLabel"=>"Nro de Orden","value"=>"OD-234567"],
                            ["id"=>"idUser","nameOrLabel"=>"User","value"=>"24"],
                              ["id"=>"idTx","nameOrLabel"=>"Txtx","value"=>"678643"],
                                ["id"=>"reference","nameOrLabel"=>"Referencia","value"=>"6754"],
                            ["id"=>"activo","nameOrLabel"=>"estado","value"=>"true"]],
    );
 
 $jsonR = json_encode($data);
      
         

$ch = curl_init ();
curl_setopt ($ch, CURLOPT_URL,  $restUrl);      
curl_setopt ($ch, CURLOPT_POST, true);
curl_setopt ($ch, CURLOPT_AUTOREFERER, true);
curl_setopt ($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt ($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json','Accept: */*'));
curl_setopt ($ch, CURLOPT_POSTFIELDS, $jsonR);

$result = curl_exec($ch);
            
if($result){
    $result = json_decode($result,true); //transform response in array
    
    if(array_key_exists("code",$result['headerStatus']) == 200){
        //is processed the request
        //ex for response message: 1|PP735886

        $data = $result['data'];
        $code = substr($data, 2); //operation code
        $status = substr($data, 0, -9); //status 1|0 -> for the code generation
        
        echo $code; // show the code for pagocash
        
    }
    else{
        //dont get a code for paguelofacil
        //show an error message
        die("service error message");
    }
}
else{
    //cannot connect with the service in paguelofacil (error message)
    die("connection error message");
}
                   

Respuesta (URL de Retorno)

Paguelofacil  envia la respuesta una vez su cliente haya realizado el pago a través del kiosco de punto de pago, la respuesta la recibe a la url de retorno través de una variable REQUEST "CodOper".

En la respuesta se envía el monto recibido en cada operación. Una transacción puede tener varias operaciones por parte del usuario, debido a que el usuario puede hacer uso del mismo código tantas veces como sea necesario hasta completar el monto de la transacción, siempre que el código de operación (PP) se mantenga vigente. 

Cada operación que realice el usuario en la máquina se registra como una nueva transacción en Paguelofacil y una vez que completa el monto este código no puede ser utilizado. En la respuesta siempre se envía el código de operación "CodOper" que se emitió en el request.

Es necesario que al momento de procesar la respuesta valide que el monto pagado "TotalPay" sea igual o mayor  al monto solicitado "amount" para completar la compra (en ocasiones puede ser mayor ej. 10.35 el usuario paga 11.00). En el caso de que el monto sea menor, se aconseja permitir varias transacciones por pedido y acumular los montos recibidos y una vez que las transacciones completen el monto del pedido proceder a completarlo.

Parámetros de respuesta

Parámetro Descripción
TotalPay Monto Pagado por el usuario, este monto se debe validar porque es posible que realice varios pagos para completar el monto total.
Fecha Fecha de la transacción en formato dd/mm/yyyy
Hora Hora de la transacción en formato HH:MM.SS
CodOper Numero de Operación alfanumérico