Wallet-as-a-Service

La API de Wallet-as-a-Service (WaaS) de Puffin te permite crear y operar billeteras de stablecoins de forma programática — sin gestión de claves, sin infraestructura específica por red, sin construir tu propia custodia. Es la misma X-API-Key que ya usas para intents de pago.

WaaS se lanza inicialmente con USDC y USDT en Solana, Polygon, BSC y Base (Base es solo USDC — no existe un contrato canónico de Tether ahí). Para cobrar cualquier red/token que Puffin soporte como pago puntual, usa intents de pago en su lugar.

Qué obtienes

Billeteras bajo demanda

POST /v1/gateway/api/wallets genera una billetera para un par red + token y devuelve su dirección de inmediato.

Saldos y depósitos

Consulta el saldo en vivo y el historial de depósitos por billetera — sin necesitar un explorador de blockchain.

Retiros

Envía desde cualquier billetera que hayas creado a una dirección externa, con la misma semántica de clave de idempotencia que los intents de pago.

Webhooks de depósito

wallet.deposit.detected y wallet.deposit.confirmed se disparan en el momento en que llegan los fondos — ver Webhooks.

Crear una billetera

curl -X POST https://api.puffinmoney.com/v1/gateway/api/wallets \
  -H "X-API-Key: mk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "chain": "BASE", "token": "USDC_BASE", "label": "EU settlement" }'

// 201
{
  "wallet": {
    "id": "8f2a1c…",
    "chain": "BASE",
    "token": "USDC_BASE",
    "address": "0x9273...6544",
    "label": "EU settlement",
    "custodyModel": "joint_custody"
  }
}

La creación de billeteras está sujeta al límite de tu plan, igual que las billeteras que ya podrías tener creadas desde el panel.

Consultar un saldo

curl https://api.puffinmoney.com/v1/gateway/api/wallets/8f2a1c.../balance \
  -H "X-API-Key: mk_live_..."

{ "wallet": { "id": "8f2a1c…", "chain": "BASE", "token": "USDC_BASE" }, "balance": { "available": "1250.00", "pending": "0" } }

Enviar un retiro

curl -X POST https://api.puffinmoney.com/v1/gateway/api/wallets/8f2a1c.../withdrawals \
  -H "X-API-Key: mk_live_..." \
  -H "Idempotency-Key: wd_2026-07-22_001" \
  -d '{ "toAddress": "0xabc...", "amount": "500.00", "note": "Vendor payout" }'

El encabezado Idempotency-Key funciona igual que en los intents de pago — repetir la misma key devuelve la respuesta original en lugar de enviar dos veces.

Referencia completa

Consulta la referencia de la API de Wallets para cada campo y código de error, y Bridging y swaps si necesitas mover fondos entre redes en lugar de solo enviarlos a una dirección en la misma red.

Primeros pasos

Formas de aceptar pagos

Para profundizar

Wallet-as-a-Service

Qué obtienes

Billeteras bajo demanda

Saldos y depósitos

Retiros

Webhooks de depósito

Crear una billetera

Consultar un saldo

Enviar un retiro

Referencia completa

​Qué obtienes

Billeteras bajo demanda

Saldos y depósitos

Retiros

Webhooks de depósito

​Crear una billetera

​Consultar un saldo

​Enviar un retiro

​Referencia completa

Qué obtienes

Crear una billetera

Consultar un saldo

Enviar un retiro

Referencia completa