Reverso de una Captura

POST https://sandbox.paguelofacil.com/rest/processTx/REVERSE_CAPTURE

Reverso de una Captura

Paguelofacil ofrece la posibilidad de realizar un reverso y/o reembolso de una transacción capturada. Este reverso puede ser por el total o un monto menor de los fondos capturados en la tarjeta de tu comprador.

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ímo es de $ 1.00 y la moneda permitida es USD.

Reversar una transacción de captura

Para realizar un reverso de una captura, debes conocer el CodOper de la Captura y el monto que deseas reversar el cual no puede ser mayor a la transacción de captura, luego hacer el llamado al API y procesar la respuesta del servicio una vez sea procesada.

Descripción de parámetros

ParámetroTipoRequeridoDescripción
cclwString


Ej.: A7BFCAF7B6……….
SiEste 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

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

String MaxLength:100


SiCódigo de operación de la transacción autorizada
description

String MaxLength:150


SiDescripción de la transacción
langString MaxLength:2No

Idioma de la transacción. Valores posibles:

* EN para Inglés
* ES para Español

customFieldValues

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

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

Petición de Autorización

Realiza la petición de reverso indicándonos en la URL que es una REVERSE_CAPTURE.

//Ejemplo de REVERSE_CAPTURE

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

$cclw = 'D17B05A095489D1176560B4666A283454185F353F401D0201CC5C16F92535DF6B1DEBA18E79442CC0D6F75FD024207680AFBDFD6CF015478BF30CBEF9160A08D ';
$amount=3.50;//El monto o valor total de la transacción a realizar. No puede ser mayor a la transacción Capturada
$description='Devolución de la Order 523';//MaxLength:150 ;Es la descripción o el motivo de la transacción en proceso
$CodOper = 'STS-LU1ZGW16QA';

$data = array(
cclw => $cclw ,
amount => $amount,
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 = curlinit();
curl
setopt($ch,CURLOPTURL, $urlConfig);
curl
setopt($ch, CURLOPTPOST, true);
curl
setopt($ch,CURLOPTRETURNTRANSFER,true);
curl
setopt($ch, CURLOPTHTTPHEADER, 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);

Respuesta de un Reverso de Captura

INFO — Al realizar la petición recibiras la respuesta en formato JSON. Debes obtener la variable Status la cual si es recibida como 1 los fondos fueron reversados.

Transacción Aprovada

//Ejemplo de Respuesta Reverso de Captura

{ headerStatus:{ code:200,description:Success },
serverTime:2019-09-24T09:48:23,
message:null,
data:{
date:2019-09-24T09:48:23,
authStatus:00,
cardType:MC,
type:MC,
userName:Nombre Apellido,
idtx:502410,
cardToken:SANDBOX-34,
userLogn:dev,
idUsr:48395,
totalPay:4.5,
binInfo:{credit_card:{issuer:{name:Bank},country:PA}},
displayNum:1226,
operationType:REVERSE_CAPTURE,
returnUrl:https://sandbox.paguelofacil.com/PF/#/default-receipt/SANDBOX_STS-J6JCR4W4TIM,
requestPayAmount:4.5,
email:oeneikaphotos@gmail.com,
codOper:SANDBOX_STS-J6JCR4W4TIM,
status:1,
messageSys:VER UNAVAILBLE},
success:true}

Transacción Denegada

//Ejemplo de Respuesta Reverso de Captura

{headerStatus:{
code:604,
description:AMOUNT GREATER THAN MAXIMUN},
serverTime:2019-09-24T09:56:10,
message:null,
data:{},
success:false}

Parámetros de respuesta

NombreTipoFormatoDescripción
headerStatusJSONHeader Status, Indica el estado de la consulta
codeIntegerCódigo del estado de la respuesta
descriptionStringDescripción del estado de la respuesta
serverTimeDate as Stringyyyy-MM-dd'T'HH:mm:ssCurrent Server Time
messageStringMensaje de la respuesta
dataStringJSONJsonArray
dateDateTimeyyyy-MM-dd'T'HH:mm:ssFecha de la transacción
authStatusStringEstado de sesión de la transacción
cardTypeStringVISA / MASTERCARDTipo de tarjeta usada para la transacción
typeStringVISA / MASTERCARDProveedor de la tarjeta usada para la transacción
idtxIntegerId identificador de la transacción
cardTokenStringToken generado de la transacción
totalPayStringMonto total de la transacción
binInfoJSONInformación del provvedor de la tarjeta (El retorno de estos datos puede variar según el proveedor)
nameStringNombre del tarjetahabiente
displayNumStringÚltimos digitos de la tarjeta
operationTypeStringTipo de operación
returnUrlStringLa dirección URL de retorno
requestPayAmountNumericMonto a pagar de la petición
emailStringCorreo del cliente
codOperStringCódigo de operación de la transacción
statusBooleanIndica si la transacción se procesó exitosamente o no
messageSysBooleanIndica el mensaje del sistema
successBooleanRetorna true si el headerStatus es SUCCESS

Request Body

{"cclw"=>"2413555b2fd551e5d7988bb335cc16cec4a73178a9edfd3b229bcce72e9ee22c67b907d9124ee59662f47e00f4956b00f95d25d401170713b0f2091a6e29d95e", "amount"=>11.0, "description"=>"Devolución de la Orden 523", "codOper"=>"SANDBOX_CAP-ZAHRSG7O0AA"}

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

{"headerStatus":{"code":604,"description":"AMOUNT GREATER THAN MAXIMUN"},"serverTime":"2022-02-15T11:59:18","message":null,"requestId":"aa1a0def-ba34-4857-a662-8149ff6b65c5","data":{},"success":false}