Migrando de la API versión 1.0.0 a la versión 2.0.0

Fecha de modificación: Lun., 26 Feb., 2018 at 9:49 AM

En febrero de 2017 lanzamos una nueva versión de la API de Conekta, la versión 2.0.0. En este momento más de 900 compañías ya están procesando con la nueva versión y disfrutando de sus beneficios.  La API 2.0.0 cambia por completo la estructura de nuestra plataforma. De manera que sea mas fácil de usar y un servicio mejor.


¿Por qué el cambio?

Quizás no recuerdas, pero la API 1.0.0 tiene mas de dos años de su lanzamiento. El mercado ha cambiado y por consecuencia, nosotros también.


¿Cuales son los beneficios?

  • OXXO PAY: Pagos con Oxxo en tiempo real y sin necesidad de impresión. Continúa leyendo sobre las ventajas de OXXO PAY aquí.
  • Manejo de errores: Lista completa de errores a corregir desde la primera petición realizada.
  • Validación de parámetros: Nos aseguramos que los atributos enviados sean válidos y ahora nosotros realizamos el cálculo de montos por ti.
  • Análisis de antifraude: Ahora tenemos verticales personalizadas por cada modelo de negocio, mejorando nuestro sistema antifraude y generando mejores resultados.
  • Agrupación de cargos: Con la nueva estructura en base a órdenes, no tendrás que realizar un reporte específico para agrupar cargos ni tendrás que reenviar la información de tu usuario, solo su tarjeta.
  • Tiempo de respuesta: Optimizamos nuestro API para que los tiempos de respuesta sean mas cortos.
  • Variables personalizadas: Ahora puedes crear las variables que tu quieres, con los nombres que tu quieres, para vincular de forma más fácil la información de tu negocio con el reporte de Conekta.



¿Qué cambió en la API?

A continuación verás los cambios principales de nuestra nueva versión, si deseas más información podrás da clic aquí.



Crear un Pedido
Charge API 1.0.0 

{
      "description":"Stogies",
      "amount": 20000,
      "currency":"MXN",
      "reference_id":"9839-wolf_pack",
      "card": "tok_test_visa_4242",
      "details": {
        "name": "Arnulfo Quimare",
        "phone": "403-342-0642",
        "email": "logan@x-men.org",
        "line_items": [{
          "name": "Box of Cohiba S1s",
          "description": "Imported From Mex.",
          "unit_price": 20000,
          "quantity": 1,
          "sku": "cohb_s1",
          "category": "food"
        }]
      }
}

Order API 2.0.0 

{
        "currency": "MXN",
        "customer_info": {
           "customer_id": "cus_zzmjKsnM9oacyCwV3"
        },
       "line_items": [{
           "name": "Box of Cohiba S1s",
           "unit_price": 35000,
           "quantity": 1
       }],
       "charges": [{
           "payment_method": {
               "type": "default"
           }
       }]
}
 


Pagos On-Demand

Customer API 1.0.0 

{
         "name":"James Howlett",
         "email":"james.howlett@forces.gov",
         "phone":"55-5555-5555",
         "cards": ["tok_8kZwafM8IcN23Nd9"]
}

Customer API 2.0.0 

{
    "name": "Mario Perez",
    "email": "usuario@example.com",
    "phone": "+5215555555555",
    "payment_sources": [{
        "token_id": "tok_test_visa_4242",
        "type": "card"
    }]
}
 


Callback Amigable

Error list API 1.0.0

{
  "object": "error",
  "type": "parameter_validation_error",
  "message": "Payment method invalid or missing.
Accepted values are: card , cash or bank.",
  "message_to_purchaser": "Tipo de método de pago inválido o faltante.
Los valores aceptados son: card, cash o bank.",
  "param": "payment_type",
  "code": "invalid_payment_type",
  "validation_error": null
}

Error list API 2.0.0  (Enumera todos los errores)

{
  "details": [
    {
      "debug_message": "The \"line_items\" is missing.",
      "message": "El parametro \"line_items\" es requerido.",
      "param": "line_items",
      "code": "conekta.errors.parameter_validation.line_items.missing"
    },
    {
      "debug_message": "The \"currency\" is missing.",
      "message": "El parametro \"currency\" es requerido.",
      "param": "currency",
      "code": "conekta.errors.parameter_validation.currency.missing"
    },
    {
      "debug_message": "\"amount\" is not greater than 0.",
      "message": "\"amount\" no es mayor a 0.",
      "param": "amount",
      "code": "conekta.errors.parameter_validation.amount.
                    number_is_not_greater_than"
    }
  ],
  "object": "error",
  "type": "parameter_validation_error",
  "log_id": "5a049e8bffecf909abdb61af"
}
 














¿Qué no cambió en la API 2.0.0?


  • El flujo de pago
  • La librería y flujo de tokenización 
  • Flujo de Planes y Suscripciónes



¿Qué información debo enviar al sistema antifraude de Conekta?


Con la API 2.0.0 no es necesario enviarnos los datos de facturación de la tarjeta habiente. 



Vertical
Parámetros
Retail: Empresas con negocio que vendan y envíen productos físicos desde una tienda online.
No se requiere parámetros adicionales.
Transporte: Empresas con sistema de taxi o mensajería a distancias cortas.
//customer
"account_created_at": 1484040996,
"first_paid_at": 1485151007

//order
"trip_id": "12345",
"driver_id": "driv_1231",
"ticket_type": "economic",
"pickup_latlon": "23.4323456,-123.1234567",
"dropoff_latlon": "23.4323456,-123.1234567"
Viajes: Agencias de viajes, aerolíneas, autobuses, etc.
//customer
"account_created_at": 1484040996,
"first_paid_at": 1485151007

//order
"trip_id": "12345",
"departs_at": 1488839657,
"arrives_at": 1488850536,
"ticket_class": "economic",
"seat_number": "23A",
"origin": "Torren",
"destination": "Mexico City",
"passenger_type": "adulto"
Eventos: Conferencias, obras de teatro, espectáculos, etc.
"starts_at": 1517376364669,
"ends_at": 1517412382817,
"ticket_class": "VIP",
"seat_number": "5F"
Telecomunicaciones: Servicio de internet o de teléfono, o planes de celular.
No se requiere parámetros adicionales.



Crowdfunding: Proyectos de inversión con un tiempo determinado para cumplir la meta.
"project_id": "proj_1517376364669",
"starts_at": 1517376364669,
"ends_at": 1517412382817,
"target_amount": 15000000





¿Qué necesito para migrar a esta nueva versión?

Recomendamos considerar lo siguiente:

  • Analizar los cambios y consecuencias que puedan ocurrir durante la migración. Si tienes alguna duda sobre el, podemos apoyarte enviando un correo a soporte@conekta.com
  • Asegurarte de actualizar nuestra librería.
  • Setear la versión de la API en 2.0.0.
  • Familiarizarte con nuestra nueva versión usando tus API Keys de prueba.
  • Realizar el cambio cuando el tráfico de tu sitio o aplicación sea bajo o nulo.


¿Cuánto tiempo tengo para realizar los cambios?

Aun no esta planeado deprecar la API 1.0.0, sin embargo, ¡creemos que es importante que aproveches las ventajas que ofrece esta nueva versión lo antes posible!

¿Le resultó útil? No

Enviar comentarios
Le pedimos disculpas por no haber podido ayudarlo. Envíenos sus comentarios y ayúdenos a mejorar este artículo.