Captura

Una vez realizada una autorización y estes seguro que deseas aceptar la transacción realiza una captura. Cuando realices la captura se trasladan los fondos del tarjeta habiente a tu cuenta en 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/
Pruebas
https://sandbox.paguelofacil.com/
Servicio POST
/rest/processTx/{TRANSACCION_TYPE}

  

Capturar una Autorización

Para realizar una captura debes haber realizado una autorización, solo debes realizar una petición con la solicitud de captura de fondos y procesar la respuesta una vez 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.
codOper  String MaxLength:100
 
Si Código de operación de la transacción autorizada
description  String MaxLength:150 Si  Descripción 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

Petición de Captura

Realiza la petición de la captura indicándonos en la URL que es una "CAPTURE".

                    
//Ejemplo de CAPTURE

$urlConfig = "https://sandbox.paguelofacil.com/rest/processTx/CAPTURE";

$cclw = 'D17B05A095489D1176560B4666A283454185F353F401D0201CC5C16F92535DF6B1DEBA18E79442CC0D6F75FD024207680AFBDFD6CF015478BF30CBEF9160A08D';
$amount=3.50;//El monto o valor total de la transacción a realizar. NO PONER
$descrition='Nro-Order-523';//MaxLength:150 ;Es la descripción o el motivo de la transacción en proceso
$CodOper = 'AUTH-LU1ZGW16QA';

    $data = array(
        "cclw" =>  $cclw ,
        "amount" => $amount,
        "codOper" => $CodOper,
        "description" => $descrition,
        "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 "
";
echo "Respuesta de paguelo Facil";
 echo "
";

$result = json_decode($result, true);

var_dump($result);
                    
                
                    
const request = require("request");

let callCapture = () => {

    let payload = {
        cclw: 'D17B05A095489D1176560B4666A283454185F353F401D0201CC5C16F92535DF6B1DEBA18E79442CC0D6F75FD024207680AFBDFD6CF015478BF30CBEF9160A08D ',
        amount: 3.50,//El monto o valor total de la transacción a realizar. NO PONER
        codOper: 'AUTH-LU1ZGW16QA',
        description: 'Nro-Order-523',//MaxLength:150 ;Es la descripción o el motivo de la transacción en proceso,
        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"}}
    };

    let options = {
        method: 'POST',
        url: 'https://secure.paguelofacil.com/rest/processTx/CAPTURE',
        headers: {
            "authorization": 'WT5hTaUcpa4J3h4AmrZa2EXXJs8boUVa|DIRd852djHbq2j5Fca5VDUkDbExTBCVf',
            "content-type": 'application/json'
        },
        body: payload,
        json: true
    };

    request(options, (error, response, body) => {
        if (error) throw new Error(error);

        console.log("Response Capture Service: ", body);
        console.log("Business logic...");
    });
};
                    
                

Respuesta de una Captura

//Ejemplo de Respuesta Capture
{{ 
   "headerStatus":{ 
      "code":200,
      "description":"Success"
   },
   "serverTime":"2019-10-03T16:42:49",
   "message":null,
   "data":{ 
      "date":"2019-10-03T16:42:49",
      "authStatus":"00",
      "cardType":"VISA",
      "type":"VISA",
      "userName":"Nombre Apellido",
      "idtx":502730,
      "cardToken":"SANDBOX-80",
      "userLogn":"dev",
      "idUsr":48395,
      "totalPay":"3.5",
      "binInfo":{ 
         "credit_card":{ 
            "issuer":{ 
               "name":"Bank"
            },
            "country":"PA"
         }
      },
      "displayNum":"6988",
      "operationType":"CAPTURE",
      "returnUrl":"https:\/\/sandbox.paguelofacil.com\/PF\/#\/default-receipt\/SANDBOX_CAP-8FPEBXJDXUE",
      "requestPayAmount":3.5,
      "email":"alambrito@correo.com",
      "codOper":"SANDBOX_CAP-8FPEBXJDXUE",
      "status":1, // 1 Capturada, 0 no capturada
      "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