Solicitar autorización Wallet Connect
Endpoint:
POST
https://kronpay.xyz/api/wallet_connect/authrize
Descripción
Solicita autorización de conexión Wallet Connect a un usuario, permitiendo a la plataforma emisora tener control limitado sobre los activos del usuario, previa aceptación manual en Telegram mediante el bot oficial @KronPay_bot.
🔐 Autenticación
- api_key → Se debe enviar en el header
Authorization.
Obtención: En el bot @KronPay_bot → sección Conexiones 🔀/🔑 Wallet Connect. - connect_key → Se debe enviar en POST.
Obtención: El usuario debe proporcionarlo o consultarlo en su sección de conexiones.
📥 Parámetros
| Campo | Tipo | Ubicación | Descripción |
|---|---|---|---|
| Authorization | string | Header | Tu api_key obtenido desde el bot oficial. |
| connect_key | string | POST | Clave proporcionada por el usuario para autorizar la conexión. |
📤 Respuesta
Éxito – 200 OK
{
"status": "success",
"connect_token": "connect_XXXXXXXXXXXXX",
"message": "Solicitud de conexión enviada exitosamente"
}
| Campo | Descripción |
|---|---|
| status | Estado de la solicitud |
| connect_token | Token de la autorización |
| message | Mensaje descriptivo de respuesta |
Errores posibles
| Código | Respuesta JSON |
|---|---|
| 400 | "Faltan api_key o connect_key" |
| 401 | "api_key no válido" |
| 404 | "connect_key no válido" |
| 409 | "Ya existe una conexión autorizada entre estos usuarios" |
📌 Notas importantes
- El usuario debe aceptar manualmente en Telegram para que la conexión sea efectiva.
- La plataforma emisora no tendrá acceso hasta que el usuario apruebe explícitamente.
- El usuario podrá denegar la autorización en cualquier momento.
Endpoint: Cargo Wallet
Endpoint:
POST
https://kronpay.xyz/api/wallet_connect/charge_wallet
Descripción
Permite a una plataforma sustraer saldo de un usuario que previamente autorizó la conexión mediante Wallet Connect en KronPay. Este endpoint realiza un débito automático autorizado desde el usuario hacia la wallet pública registrada de la plataforma.
📥 Parámetros
| Campo | Tipo | Ubicación | Descripción |
|---|---|---|---|
| Authorization | string | Header | Tu api_key obtenido desde el bot oficial. |
| connect_key | string | POST | Clave proporcionada por el usuario para autorizar la conexión. |
| amount | float | POST | Monto a debitar del usuario autorizado en USD. |
Éxito – 200 OK
{
"status": "success",
"from_alias": "KronPay",
"from_wallet": "fc178906012bf6aebeb637b5a66f107d912473709afa9a0048639d604ae7ce13",
"to_wallet": "b783ffc8d39f558acb3928dc34b6e391ca3e39e5",
"amount": "20",
"fee": "0.03",
"hash": "5ba8a0ff97788add03ba8b2f72b5abc3953ced1ce9f6f445e6a95cdfc5ce23d9",
"created_at": "2025-04-29 10:09:57"
}
| Campo | Descripción |
|---|---|
| status | Estado de la solicitud |
| from_alias | Alias de la wallet emisora del cargo |
| from_wallet | Wallet del usuario debitada |
| to_wallet | Wallet del emisor del cargo |
| amount | Monto debitado al usuario |
| fee | Fee de red |
| hash | Hash de la transacción |
| created_at | Fecha y hora de la transacción |
🚫 Posibles errores
| Código | Mensaje | Descripción |
|---|---|---|
| 400 | Faltan parámetros obligatorios | No se enviaron todos los parámetros necesarios (connect_key, amount). |
| 401 | Credenciales no válidas | El api_key o connect_key no corresponden a una conexión válida. |
| 403 | La conexión no está autorizada o fue denegada | El usuario no ha autorizado aún la conexión mediante Wallet Connect. |
| 404 | Usuario no encontrado con esa connect_key | No existe el usuario asociado al connect_key. |
| 400 | Fondos insuficientes | El usuario no tiene suficiente saldo para completar el débito. |
| 400 | La wallet introducida no existe | Wallet de destino no encontrada en el sistema. |
| 400 | No puedes transferirte a ti mismo | La wallet de origen y destino son la misma. Transferencia inválida. |