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.
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
|
Si | Este es el código web que recibe de parte de Paguelofacil y que identifica a su comercio |
amount |
Numeric, Money
|
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:
|
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 axios = require("axios");
const callCapture = async () => {
const 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
};
const options = {
headers: {
"authorization": 'WT5hTaUcpa4J3h4AmrZa2EXXJs8boUVa|DIRd852djHbq2j5Fca5VDUkDbExTBCVf',
"content-type": 'application/json'
}
};
console.log("Start CAPTURE");
await axios.post('https://secure.paguelofacil.com/rest/processTx/CAPTURE', payload, options)
.then((response) => {
console.log("Response Capture Service:");
console.log(response.data);
console.log("Business logic...");
}).catch((error) => {
console.log(error);
}).then(() => {
console.log("End CAPTURE");
});
};
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 | |
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 |