Onsite

Números de Tarjetas de crédito que salen aprobadas en la plataforma de pruebas

 

  • 4059310181757001

  • 4916012776136988

  • 4716040174085053

  • 4143766247546688

  • 4929019201087046

  • 4024007183324093

 

  • 5451819737278230

  • 5517747952039692

  • 5161216979741515

  • 5372362326060103

  • 5527316088871226

Cualquier otra tarjeta será denegada siempre, en la plataforma de pruebas.

Integración Onsite. 

El API Server to server permite una integración optima y la mejor experiencia de usuario. Con este tipo de integración, su página podrá invocar un servicio REST para el procesamiento inmediato de una tarjeta, permitiendo que usted cree la experiencia de usuario complete. Con este método, mantendrá siempre al usuario dentro de su sitio y controlara todas las respuestas en pantalla.

Prerrequisitos:

  1. Obtener las llaves de conexión de parte de Paguelofacil CCLW.
  2. TLS ó su antecesor SSL son protocolos criptográficos que proporcionan comunicaciones seguras por una red.

 

URL de Conexión:

Parámetros de entrada:

NombreTipoDescripción
CCLWString
Ej.: A7BFCAF7B6……….
Este es el código web que recibe de parte de Paguelofacil y que identifica a su comercio
txType

String MaxLength:4

  • AUTH
  • SALE
  • CAPT
Define el tipo de transacción
  • AUTH: Realiza una autorización sobre una tarjeta. Congela los fondos por un periodo máximo de 5 días.
  • SALE: Es una venta directa e inmediata, es decir autoriza y captura la transacción de una vez.
  • CAPT: Captura una previa Autorización
CDSCString MaxLength:150Es la descripción o el motivo de la transacción en proceso
CMTN Numeric, Money
Ej.: 10.00 – 1450.15 – 9.14
 El monto o valor total de la transacción a realizar.
NO PONER COMAS (,) o separador de miles.
CCNum Credit Card – Numeric MaxLength:16 Ej.: 4111111111111111 Numero complete de la tarjeta de crédito, sin guiones ni comas ni espacios
ExpMonth Numeric Ej.: 15 Mes de expiración de la tarjeta, siempre 2 dígitos
ExpYear Numeric Ej.:02 Año de expiración de la tarjeta.
 CVV2 Numeric MaxLength:3 Ej.: 548 Código de Seguridad de la tarjeta
Name String MaxLength:25 Nombre del tarjeta habiente
LastName String MaxLength:25 Apellido del Tarjeta habiente
Email String MaxLength:100 Email del Tarjeta habiente
Address String MaxLength:100 Dirección del Tarjeta Habiente
Tel Numeric MaxLength:16 Teléfono del Tarjeta habiente
SecretHash String Ej. Hash(secretdata, "SHA-512") Hash secreto que permite verificar que la petición es válida. Hash en SHA-512

Respuesta (Procesada):

La cadena JSON está compuesta por los siguientes valores:

Nombre Descripción VALOR
Status Define el estado final de la transacción Approved para una transacción aprobada Declined para una transacción declinada
Amount El monto de la transacción Valor numeric del tipo: 2.50
Response_Text Respuesta textual del Sistema Cadena de texto según el caso, por ejemplo: NO SUCH ISSUER / CVV2 MISMATCH /VER UNAVAILBLE
 AUTH_TOKEN  Token único a guardar para referenciar la transacción. En caso de ser una autorización este es el valor a enviar para la captura.  Valor alfanumérico del tipo: 02BD7MU45FSGDSF231
 CODOPER  Código único de operación de referencia en Paguelofacil  Valor alfanumérico del tipo: STS-3269785747
 Date  Fecha de la operación en formato MESDIAAÑO  Ej. 060215
 Time  Hora de la operación en format 24H  Ej. 142932
 CardType  Tipo de tarjeta utilizada  MC para Mastercard /VISA para VISA
 Name  Nombre del tarjeta habiente
 LastName  Apellidos del tarjeta habiente
 Email  Email del tarjeta habiente

Petición en PHP: (Ejemplo)

/* EJEMPLO de solicitud en PHP */

$hash = $credi_card.$credi_card_cvc.$email;
$data = array(
"CCLW" => $cclw ,
"txType" => 'SALE',
"CMTN" => $amount,
"CDSC" => $descrition,
"CCNum" => $credit_card,
"ExpMonth" => $credit_card_month,
"ExpYear" => $credit_card_year,
"CVV2" => $credit_card_cvc,
"Name" => $name,
"LastName" => $lastname,
"Email" => $email,
"Address" => $address,
"Tel" => $phone,
"SecretHash" => hash('sha512', $hash),
);
$postR="";
foreach($data as $mk=>$mv) { $postR .= "&".$mk."=".$mv; }
$ch = curl_init();
curl_setopt($ch,CURLOPT_URL, "https://secure.paguelofacil.com/rest/ccprocessing/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt( $ch, CURLOPT_AUTOREFERER, true );
curl_setopt( $ch, CURLOPT_FOLLOWLOCATION, true );
curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/x-www-form-urlencoded','Accept: */*'));
curl_setopt($ch,CURLOPT_POSTFIELDS,$postR);
$result = curl_exec($ch);

Transacción Aprobada:

Transacción Denegada:

/* EJEMPLO APROBADA*/
/******** JSON *********/
////ONSITE/////
{
"Status":"Approved",
"Amount":"1.0",
"RespText":"VER UNAVAILBLE",
"RespCode":"00", //En aprobadas siempre será 00
"AUTH_TOKEN":"02AFR535KEM3G8DHYB2",
"CODOPER":"STS-P0SAU2WAAG7",
"Date":"040418",
"Time":"131009",
"CardType":"VISA",
"Name":"ALAM",
"LastName":"BRITO",
"Email":"alam@brito.com"}"
/* EJEMPLO DENEGADA*/
/******** JSON *********/
/// ONSITE  /////
{
"Status":"Declined",
"Amount":"0.0",
"RespText":"NO SUCH ISSUER",
"RespCode":"15",
"AUTH_TOKEN":"027FR52QE3YEBLXT54Q",
"CODOPER":"STS-UMLYHLRRAPA",
"Date":"040418",
"Time":"130402",
"CardType":"VISA",
"Name":"alam",
"LastName":"brito",
"Email":"alam@brito.com"
}

Errores:

Error faltan parámetros:

/* EJEMPLO ERROR EN PARAMETRO FALTANTE */
/******** JSON *********/
////ONSITE/////

{
"error":"Missing Arguments"
}

Solución:

  • Verifique que el nombre de cada parámetro de entrada coincide exactamente con los proporcionados en esta documentación.

Error en boolean false:

/* EJEMPLO ERROR EN PARAMETROS */
/******** JSON *********/

////ONSITE/////


boolean false

Solución:

  • Verifique que el url del servicio coincide exactamente con los proporcionados en esta documentación.
  • Verifique que está haciendo el llamado al servicio a través de TLS ó SSL.

Error en valor de un parámetros:

/* EJEMPLO ERROR EN PARAMETROS */
/******** JSON *********/
////ONSITE/////

{
"error":"credit card number lenght fail check"
}

Solución:

  • Verifique que los valores de cada parámetro de entrada coincide exactamente con los proporcionados en esta documentación.
  • Error "MERCHANT NOT VALID", solicite nuevamente el CCLW y verifique los datos.
  • Error "MERCHANT SUSPENDED", su comercio ha sido desactivado por falta de procesamiento solicite la reactivación.
  • Error "AMOUNT LESS THAN MINIMUM", el monto de la transacción mínimo es $ 1.00.
  • Error "AMOUNT GREATER THAN MAXIMUN", el monto máximo de transacción permitido a su comercio es menor al monto.
  • Error "TX DUPLICATE", ya ha sido procesada una transacción con los mismos parámetros en menos de 5 minutos.
  • Error "LIMIT DAY, LIMIT MONTH, ", sus limites transaccionales mensual o diario han sido excedidos.
  • Error "INVALID SERVICE GATEWAY OR DATA GATEWAY ", su cuenta ha sido suspendida por el banco, por favor comuniquese con nostros para mayor información.

Listo! Ya puede empezar a utilizar tu integración Onsite y recibir tus pagos a  través de Paguelo Facil.