Guía de Integración - API de Transacciones

En esta sección encontrarás las instrucciones para integrar el endpoint de transacciones en tu plataforma.

Endpoint

El endpoint para procesar una transacción es el siguiente:

  POST https://api.pagosfiable.com/api/v1/transaction

Requisitos

  • Autenticación: Se requiere un token de autenticación Bearer para acceder a este recurso.
  • Formato de la solicitud: La solicitud debe ser de tipo POST y el cuerpo en formato JSON.

Body de la solicitud

A continuación se muestra un ejemplo del body que debes enviar en la solicitud:

{
"card": {
  "card_number": "4815153076656259",
  "expiration_month": "06",
  "expiration_year": "29",
  "cvv": "000",
  "holder": "NOMBRE DE LA TARJETA",
  "description": "TEST",
  "redirect_url": "https://tusitio.com"
},
"customer": {
  "email": "correo@test.com",
  "first_name": "NOMBRE",
  "last_name": "APELLIDOS",
  "comision": null
},
"value": 10,
"request_currency": "MXN"
}
          

Parámetros

  • card_number: Número de tarjeta de crédito del cliente.
  • expiration_month: Mes de expiración de la tarjeta (2 dígitos).
  • expiration_year: Año de expiración de la tarjeta (2 dígitos).
  • cvv: Código de seguridad de la tarjeta.
  • holder: Nombre del titular de la tarjeta.
  • description: Descripción de la transacción.
  • redirect_url: URL a la que se redirige después de procesar la transacción.
  • email: Correo electrónico del cliente.
  • first_name: Nombre del cliente.
  • last_name: Apellido del cliente.
  • value: Valor de la transacción.
  • request_currency: Moneda de la transacción (por ejemplo, MXN).

Ejemplo de solicitud con fetch en JavaScript

A continuación te mostramos cómo realizar una solicitud utilizando fetch en JavaScript. Asegúrate de reemplazar YOUR_BEARER_TOKEN con tu token de autenticación.

fetch('https://api.pagosfiable.com/api/v1/transaction', {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer YOUR_BEARER_TOKEN'
},
body: JSON.stringify({
  "card": {
    "card_number": "4815153076656259",
    "expiration_month": "06",
    "expiration_year": "29",
    "cvv": "000",
    "holder": "NOMBRE DE LA TARJETA",
    "description": "TEST",
    "redirect_url": "https://tusitio.com"
  },
  "customer": {
    "email": "correo@test.com",
    "first_name": "NOMBRE",
    "last_name": "APELLIDOS",
    "commision": null
  },
  "value": 10,
  "request_currency": "MXN"
})
})
.then(response => response.json())
.then(data => console.log('Success:', data))
.catch(error => console.error('Error:', error));
          

Respuesta

Si la transacción se procesa correctamente, recibirás una respuesta con los detalles de la transacción. El formato de la respuesta puede variar dependiendo del éxito o fallo de la transacción.

Errores Comunes

  • 401 Unauthorized: Ocurre cuando el token Bearer no es válido o ha expirado.
  • 400 Bad Request: Asegúrate de que todos los parámetros requeridos están presentes y tienen el formato correcto.