Saltar al contenido principal

Integra la API de menta tech

Luego de realizar la integración de Frontend, por último, debes decidir si aceptas o no la compra del usuario. Para ello, debes realizar una llamada a nuestra API.

Ambientes​

Contamos con dos ambientes, uno de desarrollo y otro de producción. Para realizar pruebas, te recomendamos utilizar el ambiente de desarrollo.

La URL base de desarrollo es: https://sandbox-api.mentatickets.com Mientras que la URL productiva es: https://api.mentatickets.com

Autenticación​

Para realizar llamadas a nuestra API, es necesario que incluyas en el header de la llamada la API Key Privada. La misma debe ser incluida en el header de la llamada con el nombre Authorization.

Consultar riesgo de usuario​

Path POST /v1/risk/evaluate

Este endpoint de permitirá consultar el riesgo de un usuario. Para ello, debes enviar la siguiente información:

Importante

Es importante que puedas enviarnos el máximo de información posible de tu usuario para que podamos evaluar el riesgo de la compra. Enviarnos información parcial aumenta el riesgo de que aceptes una compra fraudulenta.

{
  "customer": {
    "id": "39",
    "firstName": "Nix",
    "lastName": "Banderbill",
    "dateOfBirth": "1993-04-04T00:00:00.000",
    "address": {
      "street": "909 3rd Ave",
      "street2": "Apt 804",
      "city": "Osceola",
      "state": "FL",
      "zip": "10022",
      "country": "US"
    },
    "createdAt": "2023-02-04T12:33:33.382",
    "email": {
      "address": "nixbanderbill@gmail.com",
      "verified": false
    },
    "phone": {
      "number": "+170644269892",
      "verified": false
    }
  },
  "device": {
    "userId": "39",
    "sessionId": "6928730492637572856279384785672983408968"
  },
  "transaction": {
    "id": "99288423",
    "amount": 803.32,
    "currency": "USD",
    "createdAt": "2023-05-21T22:13:00.000-03:00",
    "action": "buy",
    "cardData": {
      "bin": "466057",
      "last4Digits": "0119",
      "cardIdentifier": "24576983572934824723402",
      "firstName": "Peter",
      "lastName": "Parker",
      "billingAddress": {
        "street": "909 3rd Ave",
        "street2": "Apt 804",
        "city": "New York",
        "state": "NY",
        "zip": "10022",
        "country": "US"
      }
    }
  }
}
Ver ejemplo de llamada con cURL
curl -X POST 'https://api.mentatickets.com/v1/risk/evaluate' \
-H 'Authorization: YOUR_PRIVATE_API_KEY' \
-H 'Content-Type: application/json' \
--data-raw '{
    "customer": {
        "id": "39",
        "firstName": "Nix",
        "lastName": "Banderbill",
        "dateOfBirth": "1993-04-04T00:00:00.000",
        "address": {
            "street": "909 3rd Ave",
            "street2": "Apt 804",
            "city": "Osceola",
            "state": "FL",
            "zip": "10022",
            "country": "US"
        },
        "createdAt": "2023-02-04T12:33:33.382",
        "email": {
            "address": "nixbanderbill@gmail.com",
            "verified": false
        },
        "phone": {
            "number": "+170644269892",
            "verified": false
        }
    },
    "device": {
        "userId": "39",
        "sessionId": "6928730492637572856279384785672983408968"
    },
    "transaction": {
        "id": "99288423",
        "amount": 803.32,
        "currency": "USD",
        "createdAt": "2023-05-21T22:13:00.000-03:00",
        "action": "buy",
        "cardData": {
            "bin": "466057",
            "last4Digits": "0119",
            "cardIdentifier": "24576983572934824723402",
            "firstName": "Peter",
            "lastName": "Parker",
            "billingAddress": {
                "street": "909 3rd Ave",
                "street2": "Apt 804",
                "city": "New York",
                "state": "NY",
                "zip": "10022",
                "country": "US"
            }
        }
    }
}'

Respuesta​

Te damos las herramientas para que puedas decidir si aceptas o no el pago del usuario. Esta es la respuesta que te brindaremos:

{
  "overall_risk": "medium", // low, medium, high
  "detailed": {
    "customer_risk": {
      "level": "medium",
      "signals": [
        {
          "name": "addressRiskLevel",
          "result": "low"
        },
        {
          "name": "emailDomainLevel",
          "result": "low"
        },
        {
          "name": "emailLevel",
          "result": "medium"
        },
        {
          "name": "phoneLevel",
          "result": "low"
        },
        {
          "name": "manualReview",
          "result": "false"
        }
      ]
    },
    "transaction_risk": "low"
  }
}

Nuevamente, aquí la decisión es tuya: Puedes aceptar pagos que sólamente tengan un riesgo bajo o bien únicamente rechazar los que tengan un riesgo alto dejando a tu criterio los de riesgo medio.

Envío de feedback de pagos​

En la siguiente página encontrarás información de como aviarnos el resultado de los pagos de tus usuarios. Tambien deberás informarnos si el usuario realizó un contracargo.