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.
- Servicio POST
- /webservices/rest/regCashTx
Flujo de Pago
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 |