Tokenización

Paguelofacil ofrece la posibilidad de crear una mejor experiencia de pago, cuando tus clientes realiza su primera compra en tu tienda, nosotros tokenizamos su tarjeta y al momento de realizar un segundo pago, sólo envíanos este token (Código de Operación de la primera compra) para procesar sus siguientes compras.


  

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/
Pruebas
https://sandbox.paguelofacil.com/

  

Procesamiento una transacción a traves de un token

Para realizar una transacción a través de un token debes haber realizado una autorización y/o captura aprobada por cualquiera de nuestros métodos de  pago, debes conocer el CodOper de esta transacción y el monto que deseas procesar, luego hacer el llamado al API y procesar la respuesta del servicio una vez sea procesada.

Descripción de parámetros

Parámetro Tipo Requerido Descripción
cclw

String


Ej.: A7BFCAF7B6……….

Si Este es el código web que recibe de parte de Paguelofacil y que identifica a su comercio
amount

 Numeric, Money
 


Ej.: 10.00 – 1450.15 – 9.14

Si El monto o valor total de la transacción a realizar.
NO PONER COMAS (,) o separador de miles.
taxAmount

 Numeric, Money
 


Ej.: 10.00 – 1450.15 – 9.14

Si Declaras cuanto de ese monto es ITBMS
NO PONER COMAS (,) o separador de miles.
email  String MaxLength:100
 
Si  Email del Tarjeta habiente
phone  Numeric MaxLength:16
 
Si  Teléfono del Tarjeta habiente
codOper  String MaxLength:100
 
Si Código de operación de la transacción autorizada
address  String MaxLength:100 No  Dirección del la tarjeta
concept  String MaxLength:100 
 
Si  Concepto de la transacción
description  String MaxLength:150 Si  Descripción de la transacción
ipCheck  Ip (0.0.0.0)  No  Dirección Ip del Comprador, está información es analizada para fraude de la transacción
lang  String MaxLength:2 No

 Idioma de la transacción. Valores posibles:

  • EN para Inglés
  • ES para Español
customFieldValues

 Array de campos con formato: (id, label, value)

No  Información adicional de la transacción. Serán retornados cuando implementas el api de consulta de transacciones

Paso 1. Petición de Recurrente a través de un token

Realiza la petición  indicándonos en la URL que es una "RECURRENT".

                    
//Ejemplo de REVERSE_CAPTURE
$urlConfig = "https://secure.paguelofacil.com/rest/processTx/RECURRENT";

$cclw = '004D3EF3780409D107C59C85664B800FA63FFE09247A7731B8464CCE837F3C2233F973F7308DB9A7069BD460BEC62C6E6054DD1F2DDF7F22067F857FB9E031AA ';
$amount=3.50;//El monto o valor total de la transacción a realizar. No puede ser mayor a la transacción Capturada
$description='Nueva Orden 524';//MaxLength:150 ;Es la descripción o el motivo de la transacción en proceso
$concepto='Pago en Tiendas decobre.com';
$codoper = 'STS-LU1ZGW16QA';
$name='alam';//String MaxLength:25 Nombre del tarjeta habiente
$lastname='brito';//String MaxLength:25 Apellido del Tarjeta habiente
$email='alambrito@correo.com';//String MaxLength:100 Email del
$address='testing new address';//String MaxLength:100 Dirección del Tarjeta
$phone='60201236';//Numeric MaxLength:16 Teléfono del Tarjeta habiente


$data = array(
    "cclw" =>  $cclw,
    "amount" => $amount,
    "taxAmount" => 1.00,
    "email" => $email,
    "phone" => $phone,
    "address" => $address,
    "concept" => $concepto,
    "description" => $description,
    "codOper" => $codoper,
    "lang" => 'ES', //EN
    "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"]],
);


$json=json_encode($data);

$ch = curl_init();
curl_setopt($ch,CURLOPT_URL, $urlConfig);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json','authorization:WT5hTaUcpa4J3h4AmrZa2EXXJs8boUVa|DIRd852djHbq2j5Fca5VDUkDbExTBCVf'));
curl_setopt($ch,CURLOPT_POSTFIELDS,$json);

$result = curl_exec($ch);

echo "<br>";
echo "Respuesta de paguelo Facil";
echo "<br>";

$result = json_decode($result, true);
                    
                

Paso 2. Respuesta de una petición de Recurrente a través de un token

                    
{ 
   "headerStatus":{ 
      "code":200,
      "description":"Success"
   },
   "serverTime":"2019-10-03T16:48:58",
   "message":null,
   "data":{ 
      "date":"2019-10-03T16:48:58",
      "authStatus":"00",
      "cardType":"VISA",
      "type":"VISA",
      "userName":"Nombre Apellido",
      "idtx":502732,
      "cardToken":"SANDBOX-80",
      "userLogn":"dev",
      "idUsr":48395,
      "totalPay":"30.0",
      "binInfo":{ 
         "credit_card":{ 
            "issuer":{ 
               "name":"Bank"
            },
            "country":"PA"
         }
      },
      "name":null,
      "displayNum":"6988",
      "operationType":"RECURRENT",
      "returnUrl":"https://sandbox.paguelofacil.com/PF/#/default-receipt/SANDBOX_REC-NUIMBZLRNZ5",
      "requestPayAmount":30.0,
      "email":"alambrito@correo.com",
      "codOper":"SANDBOX_REC-NUIMBZLRNZ5",
      "status":1, // 1 Aprobada, 0 No aprobada
      "messageSys":"VER UNAVAILBLE"
   },
   "success":true
}

                    
                

Parámetros de respuesta

Nombre Tipo Formato Descripción
headerStatus JSON   Header Status, Indica el estado de la consulta
     code Integer   Código del estado de la respuesta
     description String   Descripción del estado de la respuesta
serverTime Date as String yyyy-MM-dd'T'HH:mm:ss Current Server Time
message String   Mensaje de la respuesta
data String | JSON | JsonArray   Contenido de la respuesta del servicio
     date DateTime yyyy-MM-dd'T'HH:mm:ss Fecha de la transacción
     authStatus String   Estado de sesión de la transacción
     cardType String VISA / MASTERCARD Tipo de tarjeta usada para la transacción
     type String VISA / MASTERCARD Proveedor de la tarjeta usada para la transacción
     idtx Integer   Id identificador de la transacción
     cardToken String   Token generado de la transacción
     totalPay String   Monto total de la transacción
     binInfo JSON   Información del provvedor de la tarjeta (El retorno de estos datos puede variar según el proveedor)
     name String   Nombre del tarjetahabiente
     displayNum String   Últimos digitos de la tarjeta
     operationType String   Tipo de operación
     returnUrl String   La dirección URL de retorno
     requestPayAmount Numeric   Monto a pagar de la petición
     email String   Correo del cliente
     codOper String   Código de operación de la transacción
     status Boolean   Indica si la transacción se procesó exitosamente o no
     messageSys Boolean   Indica el mensaje del sistema
success Boolean   Retorna true si el headerStatus es SUCCESS

Tarjetas de Pruebas

Con estos números de Tarjetas Visa y Mastercard, podrás realizar transacciones aprobadas en cualquiera de nuestros servicios. En cuanto a las fechas de vencimiento te funcionan cualquier mes y año mayor o igual a la fecha actual y para el código de seguridad (CVV2, CVC2) cualquiera tres digitos númericos.

4059310181757001
4916012776136988
4716040174085053
4143766247546688
4929019201087046

5517747952039692
5451819737278230
5161216979741515
5372362326060103
5527316088871226

5038460000000019
CVV: 475
Fecha: 04-21
PIN: 1234