Captura
POST https://sandbox.paguelofacil.com/rest/processTx/CAPTURE
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.
IMPORTANTE — PagueloFacil tiene credenciales para ambiente de pruebas y credenciales para ambiente de producción que permiten integrar los métodos de pago, no se deben confundir al momento de realizar las configuraciones, cada ambiente requiere de sus credenciales. El monto mínimo es de $ 1.00 y la moneda permitida es USD.
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
.
PHP
//Ejemplo de CAPTURE
$urlConfig = [https://sandbox.paguelofacil.com/rest/processTx/CAPTURE
](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 = curlinit();
curlsetopt($ch,CURLOPTURL, $urlConfig);
curlsetopt($ch, CURLOPTPOST, true);
curlsetopt($ch,CURLOPTRETURNTRANSFER,true);
curlsetopt($ch, CURLOPTHTTPHEADER, array('Content-Type: application/json','authorization: WT5hTaUcpa4J3h4AmrZa2EXXJs8boUVa|DIRd852djHbq2j5Fca5VDUkDbExTBCVf'));
curlsetopt($ch,CURLOPT_POSTFIELDS,$json);
$result = curl_exec($ch);
echo
;
echo Respuesta de paguelo Facil
;
echo
;
$result = json_decode($result, true);
var_dump($result);
NODE
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
INFO — Al realizar la petición recibirás la respuesta en formato JSON. Debes obtener la variable Status
la cual si es recibida como 1
los fondos fueron capturados.
//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](mailto: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 |
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 |
Request Body
{"cclw"=>"2413555b2fd551e5d7988bb335cc16cec4a73178a9edfd3b229bcce72e9ee22c67b907d9124ee59662f47e00f4956b00f95d25d401170713b0f2091a6e29d95e", "amount"=>10.0, "codOper"=>"SANDBOX_AUTH-OGOIAGHUNZ", "description"=>"test"}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Authorization | string |
RESPONSES
status: OK
{"headerStatus":{"code":615,"description":"INVALID SERVICE GATEWAY OR DATA GATEWAY"},"serverTime":"2022-03-23T08:33:12","message":"Invalid Service.","requestId":"2c7d31a9-fa77-4257-9ebc-23058af25f09","data":{},"success":false}