Servicios de integración API para Coco Wallet (remesas USDT/USDC y OpenFinance)
Análisis de protocolo, conciliación on-chain y APIs listas para producción para cuentas Coco Pago, saldos y movimientos en stablecoin sobre Polygon
Lleva los datos de cuenta de Coco Wallet, los saldos en USDT/USDC y el historial de transferencias on-chain a tu plataforma
Coco Wallet (Coco Pago) es una billetera digital enfocada en Venezuela que permite enviar dólares y bolívares utilizando los stablecoins Tether (USDT) y USD Coin (USDC) sobre la red Polygon. Entregamos servicios de integración autorizada para que fintechs, herramientas contables, plataformas de tesorería y socios remesadores puedan leer el estado de la cuenta, el historial de transacciones y los eventos de liquidación sin reconstruir la lógica del cliente desde cero.
0xc213…, contrato USDC 0x2791…) para confirmar la liquidación, el gas pagado y la confirmación final del bloque.Por qué importan los datos de Coco Wallet
Coco Wallet nació en Y Combinator (S'19) de la mano de Victor A. Charles, Kevin Charles y Francisco Martin bajo la empresa Coco Mercado. El despliegue en Venezuela en marzo de 2022 lo convirtió rápidamente en una capa de enrutamiento para las remesas de la diáspora, con el grupo más grande de remitentes ubicado en Europa — razón por la cual en 2024 Coco Wallet integró la cobertura de on/off-ramp de Ramp Network para facilitar las recargas europeas. Para el primer trimestre de 2026 Venezuela había escalado al puesto 17 de los mercados de criptomonedas a nivel mundial, con cerca de 17,9 mil millones de dólares en volumen minorista, y solo USDT representó más del 90% de los listados P2P contra el bolívar. Este es el contexto macro en el que los datos de cuenta y transacciones de Coco Wallet se han vuelto verdaderamente valiosos: para muchos hogares venezolanos son lo más cercano a un estado de cuenta bancario estructurado y denominado en dólares.
Los datos que fluyen por Coco Wallet — saldos de billetera, remesas entrantes, pagos en comercios, transferencias entre pares y metadatos de liquidación en Polygon — son justamente la clase de OpenData estructurado y anclado en servidor que los sistemas aguas abajo quieren consultar: contadores conciliando transferencias familiares, plataformas de freelancers pagando colaboradores de forma automática, comercios que cuadran ventas con abonos a la billetera y equipos de analítica que miden el flujo del corredor.
Datos disponibles para integración
La tabla siguiente resume los conjuntos de datos estructurados que solemos exponer en las integraciones con Coco Wallet. Cada entrada está asociada a una pantalla específica de la app, define la granularidad que devuelven nuestras APIs e indica el caso de uso aguas abajo más habitual.
| Tipo de dato | Origen (en la app) | Granularidad | Uso típico |
|---|---|---|---|
| Perfil de cuenta | Pantalla de inicio de sesión y KYC | ID de usuario, handle, país, nivel KYC | Vinculación de identidad para plataformas socias |
| Saldo en stablecoin | Inicio de la billetera (USDT, USDC) | Saldo por activo, marca de tiempo del último refresco | Tableros de tesorería, patrimonio neto en tiempo real |
| Historial de transacciones | Pestaña "Movimientos" / actividad | Por transferencia: monto, activo, contraparte, comisión, estado | Conciliación contable, reportes de gastos |
| Liquidación on-chain | Blockchain Polygon | Hash de tx, bloque, confirmaciones, gas, contrato | Pista de auditoría, prueba de transferencia para reguladores |
| Metadatos del corredor de remesas | Flujo de envío de dinero | Región del remitente, región del destinatario, tasa FX de referencia | Analítica de corredores, scoring de riesgo AML |
| Pago a comercio | Pago en tienda y escaneo QR | ID del comercio, monto, canal USDT/USDC | Conciliación de POS para tiendas que aceptan Coco Pago |
| Tasa de referencia del bolívar | Pantalla de cotización | Captura de tasa USD/VES al momento de la tx | Reporte en moneda local, declaraciones tributarias |
Escenarios típicos de integración
A continuación se presentan cinco escenarios de extremo a extremo que entregamos con mayor frecuencia. Cada uno nombra el contexto de negocio, el dato o llamada API específica de Coco Wallet involucrado y cómo se mapea al patrón más amplio de OpenFinance.
1. Reporte de remesas diáspora-a-familia
Un usuario europeo envía EUR a través de un on-ramp que convierte a USDC en Polygon y luego lo reenvía a la Coco Wallet de un familiar. Vinculamos ambas cuentas bajo un único token de consentimiento y exponemos un libro mayor unificado para que el remitente pueda probar la entrega y el receptor pueda emitir un estado de cuenta amigable para impuestos. Se mapea al "servicio de información de cuentas" de OpenFinance más prueba on-chain de liquidación.
2. Nómina de freelancers para contratistas en Venezuela
Una plataforma global de staffing envía pagos mensuales en USDC a las billeteras de los contratistas y necesita un webhook de confirmación más un estado de cuenta descargable en PDF por contratista. La integración utiliza nuestra API de saldo, un endpoint de pago saliente y un webhook que se dispara cuando el bloque de Polygon correspondiente alcanza seis confirmaciones.
3. Conciliación de POS para comercios locales
Una bodega en Caracas acepta USDT desde clientes con Coco Wallet vía QR. Su POS llama a nuestro endpoint del lado del comercio para obtener los abonos en USDT del día, los empareja con los recibos impresos y exporta un resumen diario en VES utilizando la tasa oficial de referencia del BCV capturada al momento de la tx.
4. Sincronización contable y de ERP para pymes
Las pymes que operan tanto en bolívares como en dólares vuelcan los movimientos de Coco Wallet a QuickBooks, Xero o ERPs propios. Entregamos un job de exportación CSV/JSON que corre cada noche, une los datos de liquidación on-chain y etiqueta cada línea con un código del catálogo contable. El mapeo OpenData es el mismo que utilizan los AISP bajo PSD2 — solo cambia la clase de activo, que es stablecoin en lugar de fiat.
5. Cumplimiento y scoring de riesgo AML
Los equipos de cumplimiento necesitan riesgo de contraparte sobre los flujos transfronterizos. Exponemos las direcciones de billetera de las contrapartes, la profundidad del historial on-chain y una etiqueta heurística de riesgo derivada de analítica pública de cadena. Esto se alinea con lo que la regla de viaje FATF espera de los VASP, sin exponer PII en bruto a motores de scoring de terceros.
Lista de entregables
- Informe de protocolo y flujo de autenticación (cadena de tokens estilo OAuth, lógica de refresco, comportamiento del fingerprint del dispositivo)
- Especificación OpenAPI / Swagger para cada endpoint que envolvemos
- Código fuente ejecutable en Python y Node.js (login, saldo, estado de cuenta, manejador de webhooks)
- Worker de conciliación on-chain en Polygon (parser de transferencias ERC-20 USDT y USDC)
- Banco de pruebas con fixtures de replay para escenarios de sandbox y similares a producción
- Brief de cumplimiento: contexto SUDEBAN, regla de viaje FATF, GDPR para remitentes europeos
Implementación técnica — login y sesión
// Bind a Coco Wallet account under user consent (pseudocode)
POST /api/v1/coco-wallet/auth/bind
Content-Type: application/json
{
"handle": "user@cocopago",
"device_id": "dvc_8a91...",
"consent_scope": ["balance:read", "tx:read", "webhook:settlement"]
}
200 OK
{
"access_token": "eyJhbGciOi...",
"refresh_token": "rft_3f...",
"expires_in": 3600,
"consent_id": "cns_2026_04_28_001"
}
Implementación técnica — exportación de estado de cuenta
// Pull a paginated USDT + USDC statement with on-chain proof
POST /api/v1/coco-wallet/statement
Authorization: Bearer <ACCESS_TOKEN>
{
"account_id": "acc_ve_1198...",
"from_date": "2026-03-01",
"to_date": "2026-03-31",
"assets": ["USDT", "USDC"],
"include_chain_proof": true,
"page": 1, "page_size": 100
}
200 OK
{
"items": [
{
"id": "tx_19a2...",
"asset": "USDT",
"amount": "125.00",
"direction": "in",
"counterparty": "anon_eu_sender_88",
"ves_rate_snapshot": "36.42",
"chain": { "network": "polygon", "tx_hash": "0xabc...", "confirmations": 128 }
}
],
"next_page": 2
}
Implementación técnica — webhook de liquidación
// Outbound webhook fired when a remittance is finalized
POST https://partner.example.com/hooks/coco-wallet
X-Coco-Signature: t=1714305000,v1=8d5f...
{
"event": "remittance.settled",
"consent_id": "cns_2026_04_28_001",
"account_id": "acc_ve_1198...",
"tx_id": "tx_19a2...",
"asset": "USDC",
"amount": "200.00",
"settled_at": "2026-04-28T14:11:09Z",
"chain_proof": {
"network": "polygon",
"tx_hash": "0xabc...",
"block_number": 60134221
}
}
Cumplimiento y privacidad
Las operaciones de Coco Wallet se ubican en la intersección de tres marcos regulatorios. En Venezuela, la SUDEBAN supervisa la actividad bancaria y el esfuerzo más amplio para llevar los servicios de pago vinculados a criptoactivos a un perímetro supervisado, en coordinación con la Superintendencia Nacional de Criptoactivos (SUNACRIP) que recientemente comenzó a vigilar en tiempo real las operaciones bancarias asociadas a criptomonedas. A nivel global, la "regla de viaje" del FATF aplica a los proveedores de servicios de activos virtuales por encima del umbral típico de 1.000 USD y define cómo exponemos los datos de la contraparte sin filtrar PII en bruto. Para los remitentes europeos seguimos la captura de consentimiento, la minimización de datos y el manejo de derecho al olvido alineados con el GDPR.
Trabajamos estrictamente bajo autorización explícita del usuario o sobre endpoints públicos/autorizados documentados, almacenamos los registros de consentimiento con marca de tiempo verificable, registramos cada llamada API para auditoría y nunca revendemos datos crudos de cuenta. Disponemos de NDA y DPA bajo solicitud, y todo el código fuente entregado en el proyecto se acompaña de una plantilla de configuración con privilegio mínimo.
Flujo de datos / arquitectura
Una integración típica con Coco Wallet sigue un pipeline de cuatro etapas: App cliente → Gateway de API autorizada → Worker de almacenamiento y enriquecimiento on-chain → API o webhook orientado al socio. El gateway intermedia la sesión de la app y emite tokens limitados al socio. El worker de enriquecimiento une cada movimiento de la app con su transferencia ERC-20 en Polygon, de modo que los consumidores aguas abajo vean una única fila canónica en lugar de dos vistas parciales. Desde allí, los socios pueden consultar vía REST (estados de cuenta, saldos) o suscribirse a webhooks (liquidaciones, pagos a comercios). Para flujos de alto volumen agregamos una cola (por ejemplo SQS o Kafka) entre el worker y la API orientada al socio para absorber reorgs de la cadena o reintentos del lado de la app.
Posicionamiento de mercado y perfil del usuario
El usuario primario de Coco Wallet es un hogar venezolano que recibe remesas, además de un grupo saliente de remitentes concentrado en Europa (su mayor grupo geográfico) y, en segundo lugar, en Estados Unidos. Del lado de los comercios, pequeños negocios venezolanos — bodegas, peluquerías, restaurantes — usan Coco Pago como un canal de aceptación de baja comisión que evita la fragilidad de las redes de tarjetas. En cuanto a plataforma, la app se publica tanto en Android como en iOS, con la ficha de Google Play bajo com.cocomercado.cocowallet y presencia en App Store. En comparación con productos cercanos, Coco Wallet se ubica en el mismo espacio competitivo que Airtm, Reserve, Zinli, Wally y Valiu, mientras comparte los rieles subyacentes en USDT/USDC con herramientas globales como Trust Wallet, MetaMask y Binance P2P. Este posicionamiento importa para los socios de integración: cualquier capa de conciliación debe manejar los mismos activos stablecoin a través de múltiples billeteras de consumo, no solo de Coco Wallet.
Capturas de pantalla
Haz clic en cualquier miniatura para ver una versión más grande.
Apps similares y panorama de integración
Los equipos que trabajan con Coco Wallet a menudo necesitan paridad de datos con apps adyacentes de stablecoin y remesas que se utilizan en América Latina. La lista a continuación es puramente descriptiva — estos productos comparten el mismo ecosistema general y dan forma a los patrones de integración que nos solicitan los clientes.
Sobre nosotros
Somos un estudio independiente de servicios técnicos enfocado en la integración de interfaces de Apps, el análisis de protocolos OpenData/OpenFinance y la ingeniería de APIs autorizadas. Nuestro equipo ha entregado integraciones a través de bancos digitales, rieles de pago en stablecoin, plataformas de comercio electrónico, servicios OTT y apps de movilidad, con un foco particular en los corredores de remesas latinoamericanos.
- Pagos en stablecoin, billeteras custodiadas y no custodiadas, y compensación transfronteriza
- Reverse engineering de protocolos móviles para Android e iOS, dentro de alcances conformes
- Pipelines de extracción de datos, conectores ERP/contables y warehousing analítico
- SDKs personalizados en Python / Node.js / Go y bancos de pruebas reproducibles
- Entrega de código fuente desde USD 300 — código API ejecutable más documentación completa; pago tras la entrega y conformidad
- Facturación API por llamada — accede a nuestros endpoints alojados sin tarifa inicial, ideal para equipos basados en uso
Contacto
Envíanos el nombre de la app objetivo y tus requisitos concretos (tipos de datos, QPS esperado, región de despliegue) y te responderemos con una cotización acotada y un cronograma de entrega.
Flujo de trabajo del proyecto
- Confirmación de alcance: escenarios de integración, endpoints objetivo (login, estado de cuenta, prueba on-chain) y modelo de consentimiento.
- Análisis de protocolo y diseño de la API (2 a 5 días hábiles, según complejidad).
- Construcción y validación interna (3 a 8 días hábiles), incluyendo el banco de conciliación en Polygon.
- Documentación, código de ejemplo y casos de prueba (1 a 2 días hábiles).
- Primera entrega típica: 5 a 15 días hábiles; las aprobaciones de terceros (por ejemplo acceso a Ramp Network, validación del socio KYC) pueden extender los plazos.
Preguntas frecuentes
¿Qué necesitas de mi parte para empezar?
¿Cuánto tarda una primera entrega?
¿Cómo manejan el cumplimiento para flujos vinculados a Venezuela?
📱 Visión general de la app original (apéndice)
Coco Wallet — Banca Digital (paquete com.cocomercado.cocowallet) es el producto orientado al consumidor de Coco Mercado, una compañía de Y Combinator S'19 cuyo objetivo declarado es ser el servicio de remesas y pagos número 1 de Venezuela. La app permite a cualquier persona con un teléfono enviar y recibir dinero local e internacionalmente con comisiones muy bajas, utilizando los stablecoins Tether (USDT) y USD Coin (USDC) que siguen el valor del dólar estadounidense — una decisión deliberada de diseño para evitar la volatilidad de otros criptoactivos y la devaluación del bolívar.
- Envía y recibe fondos en segundos, localmente y a través de fronteras
- Protege los ahorros de la devaluación con un solo clic manteniendo USDT o USDC
- Realiza y recibe transferencias ilimitadas; paga en comercios venezolanos adheridos
- Los fondos no quedan en custodia de una entidad financiera — solo el usuario puede acceder mediante una contraseña única
- La liquidación corre sobre la red Polygon para transferencias rápidas y de baja comisión en USDT/USDC
- Disponible tanto en Android (Google Play) como en iOS (App Store), con ayuda y soporte en https://www.cocopago.app
Coco Wallet se lanzó en Venezuela en marzo de 2022 y procesó más de 300.000 USD en remesas tempranas; para 2024 había integrado la infraestructura de on/off-ramp de Ramp Network para atender mejor a su base de remitentes europeos. El contexto más amplio es la rápida adopción de stablecoins en Venezuela — para el primer trimestre de 2026 el país había escalado al puesto 17 entre los mercados cripto del mundo, con USDT presente en más del 90% de los listados P2P contra el bolívar.
Última actualización: 2026-04-30