Guía de Integración - API de Transferencias

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

Endpoint

El endpoint para procesar una transferencia es el siguiente:

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

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:

{
  "email": "test.user@example.com",
  "client": {
    "full_name": "John Doe",
    "enterprise": "Doe Ltd.",
    "email": "john.doe@example.com"
  }
}

Parámetros

email: Correo del solicitante.
client.full_name: Nombre completo del cliente.
client.enterprise: Empresa asociada al cliente.
client.email: Correo del cliente.

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/transference', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_BEARER_TOKEN'
  },
  body: JSON.stringify({
    "email": "test.user@example.com",
    "client": {
      "full_name": "John Doe",
      "enterprise": "Doe Ltd.",
      "email": "john.doe@example.com"
    }
  })
})
.then(response => response.json())
.then(data => console.log('Success:', data))
.catch(error => console.error('Error:', error));

Respuesta Exitosa

Si se genera una nueva CLABE, recibirás una respuesta como esta:

{
  "data": {
    "response": {
      "name": "John Doe",
      "email": "john.doe@example.com",
      "clabe": "646180230706229475"
    },
    "msg": "Nueva CLABE generada exitosamente."
  }
}

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.

Documentación