Usuario, User ID y Créditos
Obtén tu identificador único de usuario (user_id), consulta los detalles de tu cuenta y monitorea tu balance de créditos de verificación en tiempo real.
Es el identificador requerido para crear enlaces de pago, registrar cuentas bancarias y asociar clientes.
Cada verificación nueva consume 1 crédito de tu balance. Las verificaciones duplicadas consumen 0 créditos.
Tanto el perfil como los balances están protegidos y requieren autenticación mediante API Key con esquema Bearer.
1. ¿Cómo obtener mi User ID?
Tienes dos formas sencillas de localizar tu identificador:
Inicia sesión en tu cuenta y dirígete a la sección de tu Perfil. Encontrarás tu User ID listo para copiar con un clic.
Ir a mi PerfilHaz una petición GET /me enviando tu API Key. El campo id devuelto corresponde exactamente a tu User ID.
2. Obtener Datos del Usuario (GET /me)
Retorna la información completa del usuario dueño de la API Key, incluyendo su plan actual y créditos disponibles.
https://api.pabilo.app/mecURL
curl -X GET https://api.pabilo.app/me \
-H "Authorization: Bearer TU_API_KEY"JavaScript (Fetch)
const getUserProfile = async () => {
const response = await fetch("https://api.pabilo.app/me", {
method: "GET",
headers: {
"Authorization": "Bearer TU_API_KEY",
"Content-Type": "application/json"
}
});
const data = await response.json();
console.log("User ID:", data.id);
console.log("Créditos:", data.credits);
};Respuesta Exitosa (200 OK)
{
"id": "685725869e6febc736848bf1",
"username": "comercio_ejemplo",
"email": "[email protected]",
"full_name": "Inversiones Ejemplo C.A.",
"company_name": "Inversiones Ejemplo C.A.",
"credits": 250,
"plan_id": "plan_b2b_intermedio",
"plan_is_active": true,
"user_type": "merchant",
"is_disabled": false,
"last_renovation": "2026-08-01T00:00:00.000Z",
"next_renovation": "2026-09-01T00:00:00.000Z"
}Campos Principales de Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| id | string | Identificador único del usuario (user_id). |
| username | string | Nombre de usuario del comercio o cuenta. |
| credits | number | Cantidad de créditos disponibles actualmente para validación de pagos. |
| plan_is_active | boolean | Indica si la suscripción o membresía del usuario se encuentra vigente. |
| next_renovation | string (ISO) | Fecha del próximo ciclo de renovación del plan contratado. |
3. Consultar Saldo de Créditos (GET /me/credits)
Endpoint liviano y específico para consultar exclusivamente el balance de créditos disponible, ideal para paneles de control internos o alertas de recarga:
https://api.pabilo.app/me/creditscURL
curl -X GET https://api.pabilo.app/me/credits \
-H "Authorization: Bearer TU_API_KEY"JavaScript (Fetch)
const checkCredits = async () => {
const response = await fetch("https://api.pabilo.app/me/credits", {
headers: {
"Authorization": "Bearer TU_API_KEY"
}
});
const data = await response.json();
console.log(`Créditos disponibles: ${data.credits}`);
};Respuesta Exitosa (200 OK)
{
"credits": 250,
"message": "Credits retrieved successfully"
}Consumo Inteligente de Créditos
is_new: false y no descuenta ningún crédito adicional (costo 0).