Guía rápida para negocios

Guía rápida para negocios

Versión 1.3 Enero 2014

1. Introducción

¡Bienvenido a MYMOID! Gracias a MYMOID, el pago por móvil que se adapta a ti, tu negocio estará preparado para aceptar pagos móvil rápidamente. En esta guía te facilitamos los pasos a seguir para realizar la integración del botón de pago de MYMOID en tu comercio electrónico, pero recuerda que en la "Guía de integración avanzada de negocios" está toda la información para tu departamento técnico.

2. Pasos para la integración

Paso 1: Registrarse como negocio en MYMOID

Si aún no has realizado el registro como negocio en la web de MYMOID, escribe a [email protected] con los siguientes datos:

• Nombre de la empresa
• Cif
• Persona de contacto
• Correo electrónico
• Teléfono

Paso 2: Obtener los códigos para la integración de MYMOID

Al completar el formulario de registro se le enviarán, a través de un correo electrónico, los códigos necesarios para la integración:

• Identificador de aplicación
• Clave secreta de aplicación

Paso 3: Integrar el botón en la plantilla del sitio web

Añade el siguiente código a la plantilla de tu página web, sustituyendo los valores entre llaves por los datos obtenidos en el paso anterior, además de la información necesaria para realizar el pago.

<form action="" method="POST">
<script src="https://checkout.mymoid.com/scripts/mymoid-button.js"
 class="mymopay-button"
 data-amount="{#Cantidad#}"
 data-currency="{#Moneda#}"
 data-reference="{#Referencia#}"
 data-concept="{#Concepto#}"
 data-applicationId="{#Id de aplicación#}"
 data-appSecret="{#Clave secreta de aplicación#}"
 data-urlRedirectSuccess="{#Url de pago completado#}"
 data-sandbox="false">
</script>
</form>

Campos a configurar en el botón:

• Cantidad: Total de la operación. Los dos últimos dígitos se cuentan como decimales. Por ejemplo, la cantidad 1000 corresponde a 10,00.
• Moneda: Código de moneda. Valores posibles: { EUR }
• Referencia (150 caracteres): Referencia de la operación. Este valor debe ser único por cada operación y puede ser utilizado para identificarla dentro del sistema de tu negocio.
• Concepto (100 caracteres): Concepto de la compra.
• Id de aplicación: Identificador del botón.
• Clave secreta de aplicación
• Id de Negocio: Identificador del negocio que realiza la venta.
• URL de pago completado (Opcional): Página de destino a la que se redirige la web cuando el pago ha sido completado.
• Sandbox (Opcional): Activa el modo de prueba del botón.

Paso 4: Recibir notificaciones de compras realizadas

Se enviará una notificación de cada compra que realicen tus clientes con MYMOID al correo electrónico que nos facilitaste en el formulario de registro de negocios. Sin embargo, también se puede hacer mediante otro proceso conocido como "Llamada HTTP asíncrona".

• Llamada HTTP asíncrona:

Una vez que que hayamos verificado que el pago se ha realizado, realizaremos una petición HTTP asíncrona de tipo POST a la url de callback que envíes a nuestro departamento de soporte. Si este parámetro no está definido sólo se recibirá la notificación mediante email.

Ejemplo 1: Pago realizado
En el caso de que todo el proceso haya sido correcto, la petición llevará la siguiente información:

{
 "user": {
 "publicId":"776d8ac07408a22b8c627574213f95ef5a64f884ebf4843408e0a5838db9c9d1"
 },
 "paymentOrder": {
   "reference": "PAGO PAY 23",
   "concept": "concept",
   "amount": 344323,
   "currency": "EUR",
   "paymentOrderId":"29d37134cfca504b2bf86ec630bc54cf093797746005c71e50ae9db67ca2bd21",
   "status": "PAID"
   },
  "application": {
   "name": "MYMOID API",
   "id":"3a08a54559eadeb11c7d2e9bd16f7637dbf7065b3b302157874d33a5460f3aff"
  }
 }

Ejemplo 2: Error en el pago
Cuando se produce un error se envía una descripción en la respuesta, además la orden queda activa en estado "AVAILABLE" para poder reintentar el pago.

{
 "user": {
  "publicId":"776d8ac07408a22b8c627574213f95ef5a64f884ebf4843408e0a5838db9c9d1"
 },
 "paymentOrder": {
  "reference": "PAGO PAY 23",
  "concept": "concept",
  "amount": 344323,
  "currency": "EUR",
  "paymentOrderId":"fc015d8297a124800f879e869c5d9e049e37fcf1ab937df9841fd768e6ba5144",
  "status": "AVAILABLE"
 },
 "application": {
  "name": "MYMOID API",
  "id":"3a08a54559eadeb11c7d2e9bd16f7637dbf7065b3b302157874d33a5460f3aff"
 },
 "error": {
  "message": "Invalid card number",
  "code": "Validator.invalidCardNumber"
  }
 }

3. Modo Sandbox

Antes de la integración final del botón en tu sitio web, se pueden realizar pruebas en un entorno donde las operaciones son ficticias, dirigido a desarrolladores que necesitan un mayor control de lo que va sucediendo en el proceso. Para activar el modo sandbox se deben realizar los siguientes pasos:

1. Configurar el botón con los parámetros para el entorno sandbox: Además de la información relativa al pago y los datos propios de tu negocio, es muy importante incluir la siguiente línea y cambiar el atributo “src” del script de carga:

   <script src=” https://sandbox-checkout.mymoid.com/scripts/mymoid-button.js” … … data-sandbox="true">

2. Abrir el botón Para crear una orden de pago y poder continuar con el siguiente paso, hay que introducir el siguiente número de teléfono: +34 603368376

3. Completar el pago de forma correcta o incorrecta Una vez introducido el número para pruebas, aparecerá la pantalla de esperando con dos botones en la parte inferior. El botón de “pago OK” completa el pago simulando el proceso que se debería realizar en el móvil del usuario. El botón de “pago KO” simula el proceso como si el usuario hubiera tenido un problema en el momento del pago.