NOTA IMPORTANTE: Ha habido un cambio y ahora ya no será necesario hacer el flujo de pago rechazado y pago aprobado. No será necesario hacer ningún cambio en el desarrollo, simplemente pasar por alto la pregunta Q4.
¡Bienvenido al examen de certificación de integración QR Vendedor (modo atendido) de Mercado Pago!
Queremos que formes parte de nuestra comunidad de desarrolladores certificados y para ello te invitamos a que realices este examen.
Para lograr obtener esta certificación será necesario que desarrolles un ejercicio práctico y funcional implementando este ejemplo que simula ser un Softwade de Punto de venta que permite crear una sucursal, una caja y una orden, así como validar el pago de la misma, cumpliendo con los estándares de calidad de nuestro equipo de integraciones.
Desde Mercado Pago validaremos tus respuestas para determinar si se cumplió con lo solicitado en el ejercicio. Te recomendamos leer este documento en su totalidad antes de comenzar.
- Front End: HTML, JavaScript/JQuery
- Backend: PHP (aunque podrías adaptar fácilmente el código a otros lenguajes a tu elección)
- Servidores: Configuraciones básicas para puesta en marcha de un servicio web en el lenguaje de backend que elijas.
- Interacción con API REST
- GitHub
- Necesitarás subir el ejercicio a un servidor como Heroku o algún servidor que permita disponibilizar estos archivos públicamente en internet. El desarrollo tendrá una parte de front y otra parte de back.
- El lenguaje del código Backend de este ejercicio está desarrollado en PHP pero lo hemos hecho para que puedas adaptarlo fácilmente a cualquier otro lenguaje de programación.
Requisitos previos: https://www.mercadopago.cl/developers/es/guides/qr-code/general-considerations/pre-requisites/
Sucursales y cajas: https://www.mercadopago.cl/developers/es/guides/qr-code/general-considerations/stores-pos/
Introducción QR Vendedor modo atendido: https://www.mercadopago.cl/developers/es/guides/qr-code/qr-attended/qr-attended-part-a/
Integrar el modo atendido: https://www.mercadopago.cl/developers/es/guides/qr-code/qr-attended/qr-attended-part-b/
Video-tutoriales: https://www.youtube.com/playlist?list=PLCazXKuqZp3hGVY3bBhEO0ItFhIic5UpK
Este ejercicio se basa en hacer funcional el ejemplo que compartimos en este repositorio y que funcione de forma completa desde un servidor Web público, puede ser basado en Heroku o cualquier otra plataforma.
¿Qué debe hacer este ejercicio?
- Crear una sucursal
- Crear un POS/QR
- Crea una orden y simula un pago APROBADO mediante la tarjeta de crédito Master Card para lograr un pago EXITOSO. Ver (*)
- YA NO ES NECESARIO HACER SIMULACIÓN DE PAGO RECHAZADO.
- Escuchar las notificaciones para confirmar el pago de la orden. Puedes hacerlo mediante el ejemplo proporcionado o usar otras plataformas como Hookbin.com o similar. Lo importante es que el ejercicio obtenga el resultado esperado.
- Escuchar el servicio merchant_orders para confirmar el pago de la orden
- Modifica la página index.html en ingresa tu DNI/RUT o número de identificación de tu carnet en el comentario que hace mención a ello.
Los JSON resultantes de las llamadas del ejercicio deberás copiarlos y pegados en el formulario de validación del ejercicio.
Para que todo ello funcione deberás comprobar de realizar los cambios o los añadidos necesarios en el código para que todo funcione.
Dentro del código encontrarás comentado mediante el siguiente texto las acciones que deberás revisar:
// REVISA AQUÍ:
Esto principalmente será en los archivos:
/assets/js/acme.js /api/ (revisar todos los index.php y functions.php que contiene algunas variables globales)
En este video te mostramos un flujo completo del resultado esperado del ejercicio: https://youtu.be/SYzYz6m0cCE
Credenciales de usuarios de TEST para las pruebas. Las cuentas de test son Argentinas pero puedes estar en otro país sin problemas:
VENDEDOR:
- access_token: APP_USR-7026946692817220-061822-8b7c9e20631faac22d9e4cfa92a37265-586728271
- collector_id: 586728271
- country_id: MLA
COMPRADOR (para usar desde la app de Mercado Pago):
- email: test_user_66671705@testuser.com
- password: qatest3881
Datos para ingresar en las pruebas:
Sucursal:
- name: Sucursal + espacio + número de DNI sin puntos ni rayas, por ejemplo: Sucursal 218545556
- street_name: Sinclair
- street_number: 2929
- country: Argentina
- State: Capital Federal
- City: Palermo
- latitude: -34.5756022
- longitude: -58.4249225
- external_id: de la sucursal deberá ser: suc + número de DNI sin puntos ni rayas + número correlatvo por cada prueba 001, por ejemplo: suc218545556001
- address_reference: Piso 1
POS/QR:
- name: POS + espacio + número de DNI sin puntos ni rayas, por ejemplo: POS 218545556
- fixed_amount: Es importante para que el QR esté integrado que este dato sea true.
- external_store_id: El mismo external_id creado en la sucursal
- external_id: El external_id del pos deberá ser: [pos]+[número de DNI sin puntos ni rayas]+[número correlatvo por cada prueba 001], por ejemplo: pos218545556001
ORDEN:
- store_id: Es el ID resultante de crear la sucursal, o también llamado STORE_ID (no es el external_id de la sucursal)
- external_pos_id: Es el external_id creado en el POS
- external_reference: El external_reference deberá ser: ref + tu número de DNI sin puntos ni rayas + número correlatvo por cada prueba 001, por ejemplo: ref218545556001. Muy importante a tener en cuenta, cada vez que hagas un flujo completo en el ejercicio aumenta el número correlativo de la external_reference. Seería al equivalente al número de orden de una compra.
- notification_url: Este campo debe tener una url correcta. El servicio de recepción de notificacinones deberá ser accesible públicamente por inernet.
- El monto total de la orden debe coincidir con $ 660.
- Recuerda poner APRO en el titular de la tarjeta para simular pagos aprobados y OTHE para simular pagos rechazados como se indica en la documentación: https://www.mercadopago.com.ar/developers/es/guides/qr-code/final-steps/integration-test/#bookmark_tarjetas_de_prueba
Una vez realices el ejercicio completo y sea funcional deberás cumplimentar el siguiente formulario:
https://bit.ly/examen-QR-Vendedor-MP
La respuesta del resultado del ejercicio será inmediato.
Si no apruebas recibirás un correo en el que te indicaremos dónde cometistes los fallos para que puedas volver a repetirlo, en caso de aprobar el examen estarás automáticamente certificado en esta modalidad. Al cabo de unos días recibirás un correo que te daría acceso a nuestra comunidad en Slack para desarrolladores certificados en inStore, así como te enviaremos el certificado y tu integrator-id (en caso de no tenerlo).
- Esta es una prueba individual y la evaluación se realizará de forma individual.
- No se aceptará que los participantes se compartan respuestas ni código.
- Tampoco podrá reutilizarse el hospedaje del sitio, sino que cada uno deberá levantar y compartir su propio sitio público con el ejemplo.