e-commerce Template for Clarion Mercado Pago / Mercado Libre

Transcripción

1 e-commerce Template for Clarion Mercado Pago / Mercado Libre Documentación Cómo Instalar el Template? 1. Ejecutar el instalador SetupeCommerce.exe. 2. Ingresá tus datos, con el Número de serie asignado. 3. Una vez finalizado, ya quedará registrado el Template en el Clarion listo para usar. 4. Para comenzar a utilizar el Template en una aplicación, deberá ir a las extensiones Globales, seleccionar Insert, y buscar como está en la imagen.

2 5. Aquí se deberá completar los datos: 1. Port Webserver, será el puerto donde estará escuchando el servidor que viene incorporado en el template; 2. URL para crear una aplicación en Mercado Pago, donde se especificarán datos como: Notifications URL, Redirect URI,etc. /custom-checkout/mercadopago-connect#create-app-connect

3 3. URL para crear una aplicación en Mercado Pago, donde se especificarán datos como: Notifications URL, Redirect URI,etc. 4. Notifications CallBack URL, es donde va a devolver el servidor de Mercado Pago, al Servidor del Template, cuando se realice algún tipo de operación, la que será registrada en la tabla NotificationsMP.TPS 5. La misma operatoria realizar para Mercado Libre 1. Configurar en MercadoLibre las Apps

4 6. Aquí se deberá completar los datos que se obtengan luego de haber configurado Mercado Pago y Mercado Libre; 7. Activate Server Notifications, pondrá activo el servidor al inicio de su aplicación, y estará a la escucha de las notificaciones; 8. Debug opciones, permite habilitar que muestre los mensajes, los progress de Mercado Pago o Mercado Libre, y el Server Notifications que estará a la escucha. Nombre de la Clase ecommerce Propiedades de la clase Propiedades de la Clase / Respuesta de los métodos

5 AccessToken AccessTokenML Respuesta del Token de MercadoPago Respuesta del Token de MercadoLibre Métodos / Configuración para Mercado Pago y Mercado Libre SuccessUrl PendingUrl FailureUrl NotificationUrl Url de Pago Exitoso Url de Pago Pendiente Url de Pago Fallido Url donde llegarán las notificaciones de Pago RedirectUri Url de redireccionamiento para la validación y autorización de Mercado Libre. Para trabajo local se recomienda siempre y cuando la propiedad PortWebServer sea igual a 88, sino, sería PortWebServer Puerto de escucha de la propiedad NotificactionUrl, por defecto en 88. Se recomienda dejarlo ahí. PageLink Respuesta del método CreatePayment, devuelve el link de Mercado Pago, del pago creado para poder realizar la cobranza. ItemId Respuesta del método CreateItemML, devuelve el Id del Item creado en Mercado Libre. METODOS PARA MERCADO PAGO Auth (STRING pclientid, STRING pclientsecret) ECommerceMP.Auth(ClientId,ClientSecret) Glo:AccessToken = ECommerceMP.AccessToken Solicita el Token de Acceso para Mercado Pago. Devuelve la respuesta en la propiedad AccessToken. CreatePayment (STRING paccesstoken, STRING ptitle, STRING pid, STRING pdescription, STRING pquantity, STRING punitprice, STRING pexternalreference)

6 ECommerceMP.CreatePayment(Glo:AccessToken, Titulo, Id, Descripcion, Cantidad, PrecioUnitario, ReferenciaExterna) Glo:PageLink = ECommerceMP.PageLink Solicita la creación de un link de cobranza, para poder realizar la cobranza. Devuelve la respuesta en la propiedad PageLink, con el link de cobranza. CreateDebt PROCEDURE(STRING paccesstoken, STRING ppayer , STRING pbackurl, STRING preason, STRING pexternalreference, STRING pfrecuency, STRING pfrecuencytype, STRING pamount, STRING pstartdate, STRING penddate) ECommerceMP.CreateDebt(Glo:AccessToken, Cliente, BackUrl, Motivo, ReferenciaExterna, FrecuenciaPago, FrecuenciaTipo, Monto, FechaInicio, FechaFin) Glo:PageLink = ECommerceMP.PageLink Solicita la creación de un link para débito automático, para poder realizar la cobranza de forma automática. Devuelve la respuesta en la propiedad PageLink. 1. Creas una preferencia de pago recurrente. 2. Muestras el botón o link a tu cliente.

7 3. Tu cliente autoriza la suscripción. 4. Recibes las notificaciones de los pagos. UrlConfiguration PROCEDURE(STRING psuccess, STRING pfailure, STRING ppending, STRING pnotificationurl, STRING predirecturi, BYTE pport) GetBalance PROCEDURE(STRING paccesstoken) ECommerceMP.GetBalance(Glo:AccessToken) Solicita el balance de cuenta de Mercado Pago, y devuelve en la tabla GetBalanceMP. METODOS PARA MERCADO LIBRE AuthML PROCEDURE(STRING pclientid, STRING pclientsecret, STRING puserid, STRING ppassword, STRING predirecturi) ECommerceMP.AuthML(ClientId,ClientSecret, UserId, Password, RedirectUri) Glo:AccessTokenML = ECommerceMP.AccessTokenML Solicita el Token de Acceso para Mercado Libre. Devuelve la respuesta en la propiedad AccessTokenML.

8 CreateItemML PROCEDURE(STRING paccesstoken,string ptitle, STRING pdescription, STRING pquantity, STRING punitprice, STRING pwarranty, STRING purlimage) ECommerceMP.CreateItemML(AccessTokenML, Title, Description, Quantity, UnitPrice, Warranty, UrlImage,OfficialStore,OfficialStoreId) OfficialStore Sí es TRUE, se debe indicar el OfficialStoreId; ambos son parámetros optativos. Glo:ItemML = ECommerceMP.ItemML Solicita la creación del item para Mercado Libre. Devuelve la respuesta en la propiedad ItemML. UpdateItemML PROCEDURE(STRING paccesstoken,string pitemid, STRING ptitle, STRING pquantity, STRING punitprice, STRING pwarranty, STRING purlimage) ECommerceMP.UpdateItemML(AccessTokenML, ItemId, Title, Quantity, UnitPrice, Warranty, UrlImage) Glo:ItemML = ECommerceMP.ItemML Solicita la modificación del item, donde podrá modificar los datos enviados para Mercado Libre. Devuelve la respuesta en la propiedad ItemML. UpdateTextItemML STRING ptext) PROCEDURE(STRING paccesstoken,string pitemid, ECommerceMP.UpdateTextItemML(AccessTokenML, ItemId, Text) Glo:ItemML = ECommerceMP.ItemML

9 Solicita la modificación del Texto del item para Mercado Libre. Devuelve la respuesta en la propiedad ItemML. UpdateStatusItemML PROCEDURE(STRING paccesstoken,string pitemid, STRING pstatus) ECommerceMP.UpdateStatusItemML(AccessTokenML, ItemId, Status) Glo:ItemML = ECommerceMP.ItemML Solicita la modificación del Status del item para Mercado Libre. Devuelve la respuesta en la propiedad ItemML. GetCategoriesML PROCEDURE() ECommerceMP.GetCategoriesML() Solicita las listas de categorías y devuelve en json. UTILIZANDO EL ecommercespooler Esta herramienta está diseñada para que Ud. Pueda desde cualquier aplicación utilizar ecommercespooler, por lo que, para poder ejecutar cualquier metodo y/ propiead, deberá hacer de la siguiente forma, a modo de ejemplo: Las configuraciones iniciales se guardan en el archivo ecommercespooler.ini [SERVER] PORT=88 NOTIFICATIONS= REDIRECTURI= SUCCESS= FAILURE= PENDING=

10 Ejemplo para solicitar el AccessToken Mercado Pago Glo:ClientId=' ' Glo:ClientSecret='HW3r33OzZ4qansBNKcpPe1EOSahsf1dxXZa' Access:Request.PrimeAutoInc() Req:Method='AUTH' Req:Parameters=CLIP(Glo:ClientId)&','&CLIP(Glo:ClientSecret) Req:Read=0 Access:Request.Insert() Glo:CodigoRequest=Req:CodigoRequest Req:CodigoRequest=Glo:CodigoRequest Access:Request.Fetch(Req:RequestKey) IF Req:Read=1 THEN Glo:RespuestaMP=Req:Answer END Ejemplo para crear un Link de Cobranza Mercado Pago Access:Request.PrimeAutoInc() Req:Method='CreateItem' Req:Parameters=CLIP(Glo:AccessToken)&',PAGO,'&GLO:ST.MakeGuid()&',PAGO FACTURA X,1,700,MOVIMIENTOCLIENTE CODIGO_MCLIENTE' Req:Read=0 Access:Request.Insert() Glo:CodigoRequest=Req:CodigoRequest Leer Respuesta Req:CodigoRequest=Glo:CodigoRequest Access:Request.Fetch(Req:RequestKey) IF Req:Read=1 THEN Glo:RespuestaMP=Req:Answer END En éste caso devolverá el link de cobranza. En donde, Req:Method, se solicitará el método a utilizar, en Req:Parameters, los parámetros, tal cual está explicado e indicado más arriba, Req:Read=0, significa que se envia por primera vez; una vez que el Spooler lo lea, lo pondrá en 1 y grabará su respuesta en Req:Answer, que dependiendo del método solicitado, será la respuesta posible que obtendrá. Como metodología, se recomienda utilizar: Req:Read=0 para decirle que es un comando nuevo; Req:Read=1 contesta el Spooler (Dato leido con respuesta); Req:Read=2 para decirle que la respuesta fue leída;