Ir al contenido
WhatsMarketingDeveloper Hub

Wallet

El saldo de tu organización y sus movimientos. Por API solo se consulta: recargar se hace en el panel. Necesita el permiso wallet:read.

Ver el saldo

GET/wallet

Saldo, moneda, si está bajo y una estimación de cuánto dura al ritmo actual. Necesita wallet:read.

Permisos: wallet:read

curl
curl "https://micuenta.whatsmarketing.es/api/v1/wallet" \
  -H "Authorization: Bearer $WM_API_KEY"
Node.js
const res = await fetch('https://micuenta.whatsmarketing.es/api/v1/wallet', {
  headers: {
    Authorization: `Bearer ${process.env.WM_API_KEY}`,
  },
});
const data = await res.json();
Python
import os, requests

r = requests.get(
    "https://micuenta.whatsmarketing.es/api/v1/wallet",
    headers={"Authorization": f"Bearer {os.environ['WM_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
data = r.json()
PHP
<?php
$ch = curl_init('https://micuenta.whatsmarketing.es/api/v1/wallet');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('WM_API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);

Sin ejemplo de respuesta todavía.

Listar movimientos

GET/wallet/transactions

Recargas, consumos, devoluciones y ajustes, con filtros por tipo (type), periodo o fechas (from, to) y búsqueda libre (q). Necesita wallet:read.

Permisos: wallet:read

Parámetros

NombreDóndeTipoValores
pageconsultanumberpor defecto: 1 · 1 – …
pageSizeconsultanumberpor defecto: 20 · 1 – 100
typeconsultastringTOPUP · CONSUMPTION · REFUND · ADJUSTMENT · TOPUP_REVERSAL
periodconsultastringmonth · 30 · 90 · last_month
fromconsultastring
toconsultastring
qconsultastring0–120 caracteres
curl
curl "https://micuenta.whatsmarketing.es/api/v1/wallet/transactions?page=1&pageSize=20" \
  -H "Authorization: Bearer $WM_API_KEY"
Node.js
const res = await fetch('https://micuenta.whatsmarketing.es/api/v1/wallet/transactions?page=1&pageSize=20', {
  headers: {
    Authorization: `Bearer ${process.env.WM_API_KEY}`,
  },
});
const data = await res.json();
Python
import os, requests

r = requests.get(
    "https://micuenta.whatsmarketing.es/api/v1/wallet/transactions?page=1&pageSize=20",
    headers={"Authorization": f"Bearer {os.environ['WM_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
data = r.json()
PHP
<?php
$ch = curl_init('https://micuenta.whatsmarketing.es/api/v1/wallet/transactions?page=1&pageSize=20');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('WM_API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);

Sin ejemplo de respuesta todavía.