Ir para o conteúdo
WhatsMarketingDeveloper Hub

Wallet

O saldo da sua organização e as movimentações. Pela API é apenas consulta: a recarga é feita no painel. Precisa da permissão wallet:read.

Ver o saldo

GET/wallet

Saldo, moeda, se está baixo e uma estimativa de quanto dura no ritmo atual. Precisa de wallet:read.

Permissões: 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);

Ainda sem exemplo de resposta.

Listar movimentações

GET/wallet/transactions

Recargas, consumos, devoluções e ajustes, com filtros por tipo (type), período ou datas (from, to) e busca livre (q). Precisa de wallet:read.

Permissões: wallet:read

Parâmetros

NomeOndeTipoValores
pageconsultanumberpadrão: 1 · 1 – …
pageSizeconsultanumberpadrão: 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);

Ainda sem exemplo de resposta.