Manual técnico de Web Checkout
Botón de Pagos Checkout es un sistema de pagos delegado que permite crear un pago en el sistema de Botón de pagos, este método se utiliza cuando los comercios quieren delegar a Botón de Pagos la gestión del pago.
El sistema de pagos permite almacenar la venta y aprobarla mediante las funcionalidades de Botón de Pagos previa auditada de la venta, sistema de pago automático, siempre debe autorizar el pago.
El sistema desarrollado se integra al sistema actual y usa las mismas funcionalidades de este sistema, la tecnología de desarrollo que se usa es Web MVC, con lo cual la integración se acoplo al sistema actual.
Nota importante
Para que el sistema funcione correctamente se debe crear un producto ficticio en ambiente de pruebas y producción, este producto sirve para integrarse con el sistema de ventas de lacompay.
Ambiente Pruebas
El producto para ambiente de pruebas es el 251
Ambiente Producción
El producto para ambiente de pruebas es el 460
La configuración se debe parametrizar como lo muestra la imagen y esto se debe tener en cuenta para cada despliegue.
Diagrama de Actividades
Apis de Exposición.
El api de pruebas se encuentra en la siguiente URL:
http://lacompay-001-site9.gtempurl.com/checkout/Default/Gateway
Creación de Orden
Para crear la orden en lacompay se debe enviar los siguientes parámetros por POST
<form method=”post” action=”http://lacompay-001-site1.gtempurl.com/checkout/Default/Gateway “>
<input type=”hidden” name=”merchantId” value=”24″>
<input type=”hidden” name=”referenceCode” value=”2923″>
<input type=”hidden” name=”description” value=”Benetton – Hot”>
<input type=”hidden” name=”amount” value=”80000″>
<input type=”hidden” name=”signature” value=”f92025c5a53c6e0eebfbae49765f70fc”>
<input type=”hidden” name=”accountId” value=”511886″>
<input type=”hidden” name=”currency” value=”COP”>
<input type=”hidden” name=”buyerEmail” value=”tucorreo@mimail.com“>
<input type=”hidden” name=”test” value=”0″>
<input type=”hidden” name=”confirmationUrl” value=”http://www.google.com”>
<input type=”hidden” name=”responseUrl” value=”http://www.google.com”>
<input type=”hidden” name=”shippingAddress” value=”Calle 180″>
<input type=”hidden” name=”shippingCountry” value=”CO”>
<input type=”hidden” name=”shippingCity” value=”Bogota”>
<input type=”hidden” name=”billingAddress” value=”Calle 180″>
<input type=”hidden” name=”billingCountry” value=”CO”>
<input type=”hidden” name=”billingCity” value=”Bogota”>
<input type=”hidden” name=”extra1″ value=”WOOCOMMERCE”>
<input name=”Submit” type=”submit” value=”Enviar” >
</form>
merchantId = Representa los datos de identificación en lacompay, para prueba debe ser “24“
referenceCode = Código de referencia en WOOCOMMERCE
description = Descripción del producto que va a comprar
amount = Valor de la venta
signature = Llave de encriptación de la compra, por el momento no se está validando
accountId = Representa los datos de identificación en lacompay, para prueba debe ser “511886“
currency = Moneda de la compra
buyerEmail = Correo electrónico del comprador – WOOCOMMERCE
test = dato de prueba
confirmationUrl = Url donde se enviará la respuesta después de aprobar, esta página solo recibir parámetros por post y no debe tener front, esta página es solo para actualizar el estado de la orden en WOOCOMMERCE
responseUrl = Url donde se enviará la respuesta después de crear la orden en lacompay, esta página deber recibir parámetros por post y debe tener front.
shippingAddress = Dirección de envió, corresponde a WOOCOMMERCE
shippingCountry = País de envió, corresponde a WOOCOMMERCE
shippingCity = Ciudad de envió, corresponde a WOOCOMMERCE
billingAddress = Dirección de facturación, corresponde a WOOCOMMERCE
billingCountry = País de facturación, corresponde a WOOCOMMERCE
billingCity = Ciudad de facturación, corresponde a WOOCOMMERCE
extra1 = Parámetro donde se envía quien es la fuente de la petición debe ser WOOCOMMERCE
Ejemplo
Cuando de en aceptar se redirigirá a la página que se haya configurado en el paso anterior, con el objeto de repuesta por parámetro post.
Objeto Respuesta:
{
“idVenta”: 1845,
“idProducto”: 251,
“nomProducto”: null,
“valorProducto”: 0,
“fechaCreacion”: “2017-01-19T19:35:44.9108676”,
“estado”: “Pendiente”,
“nombres”: “Rocky”,
“apellidos”: “Andre”,
“cedula”: 9431376,
“telefono”: 3114810158,
“celular”: 3114810158,
“dpto”: “13”,
“ciudad”: “13052”,
“direccion”: “Calle 123”,
“email”: “tucorreo@mimail.com”,
“franquicia”: “VISA”,
“nroTarjeta”: “B08346ECC99000BB7EF488847708C7715AA395BEC7B5EE36”,
“nroTarjetaCorta”: “B0*******EE36”,
“mesExpiracion”: 12,
“annioExpiracion”: 2018,
“codVerificacion”: “1E8EEDD2C7A9BF26”,
“cuotas”: 4,
“audio”: null,
“observacion”: null,
“valorVenta”: 40000,
“valorIva”: 0,
“valorNeto”: 0,
“bancoId”: 0,
“idUsuario”: 23,
“autorizacion”: null,
“codigoRespuesta”: null
}
De este objeto de respuesta lo importante es el campo estado, que te dice el estado de la orden y el campo autorización, si este campo tiene dato quiere decir que credibanco dio código de autorización.
Los estados que maneja la transacción son los siguientes:
public enum EstadoVenta
{
Anulada,
Aprobada,
Autorizado,
Finalizado,
// Fondos insuficientes
Guia,
Guia_Pendiente,
Guia_Devuelta,
Guia_Enviada,
Pendiente,
Rechazado,
Revisar,
Courrier,
Devuelto,
Reversada
}
Este estado se devuelve en el tag “estado”
Luego de registrar la transacción dirigirse al sitio web y autorizarla.
Método Consulta Alternativo
Método: GET
URL: http://lacompay-001-site1.gtempurl.com/api/AutorizeCreditCard/Get/1845
Parámetro: 1845 Código de Transacción en Lacompay devuelto en el método anterior.
{
“idVenta”: 1845,
“idProducto”: 251,
“nomProducto”: “PRUEBA COMPRA API”,
“valorProducto”: 1001,
“fechaCreacion”: “2017-01-19T19:35:44.91”,
“estado”: “Aprobada”,
“nombres”: “ROCKY”,
“apellidos”: “ANDRE”,
“cedula”: 9431376,
“telefono”: 3114810158,
“celular”: 3114810158,
“dpto”: “13”,
“ciudad”: “13052”,
“direccion”: “Calle 123”,
“email”: “tucorreo@mimail.com“,
“franquicia”: “VISA”,
“nroTarjeta”: “B08346ECC99000BB7EF488847708C7715AA395BEC7B5EE36”,
“nroTarjetaCorta”: “B0*******EE36”,
“mesExpiracion”: 12,
“annioExpiracion”: 2018,
“codVerificacion”: “1E8EEDD2C7A9BF26”,
“cuotas”: 4,
“audio”: null,
“observacion”: null,
“valorVenta”: 40000,
“valorIva”: 0,
“valorNeto”: 0,
“bancoId”: 0,
“idUsuario”: 23,
“autorizacion”: “536486”,
“codigoRespuesta”: “00”
}
Datos de prueba de la tarjeta de crédito.
