Movimentacao financeira, na altitude de uma chamada REST.
Cinco chamadas levam voce de ponta a ponta: criar um usuario, financiar uma carteira, consultar o saldo, enviar dinheiro, ler o historico. Dez minutos com uma chave de sandbox. Chaves de sandbox nao movem dinheiro real.
SDK em Go ou HTTP puro
Use o SDK em Go lançado, gere um cliente tipado a partir dos contratos OpenAPI ou chame a API com qualquer biblioteca HTTP. Sem runtime proprietário.
Idempotente por padrao
Cada chamada de movimentacao financeira recebe uma chave de idempotencia. Novas tentativas sao seguras; o livro-razao repete o resultado armazenado byte a byte.
Eventos em que voce pode confiar
Os webhooks sao assinados com HMAC-SHA256 com uma janela de repeticao, entregues ao menos uma vez com ids de deduplicacao, em um pool de workers isolado dos fluxos financeiros.
Credenciais com escopo
Chaves de API de inquilino para servidor a servidor, tokens de usuario assinados de curta duracao para chamadas de cliente, tokens de equipe para operacoes, verificados a cada requisicao.
Financie uma carteira e depois envie dinheiro
Transferência entre usuários sandbox com saldo
Pré-requisitos: dois usuários do mesmo tenant, fundos de teste confirmados e chave transfers:write. Reutilize a chave e o corpo nas tentativas.
# Existing sandbox users; sender funding must already be confirmed.
# Save this JSON with the business operation. Retry with the same key and body.
curl --fail-with-body -sS -X POST "$WALLETD_API/v1/transfers" \
-H "Authorization: Bearer $WALLETD_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $TRANSFER_KEY" \
-d '{"from_user":"0191c2d5-2b18-7e63-8f4a-05c7b9d1e832","to_user":"0191c2d4-8f3a-7c51-9b2e-4a6f8d310e27","amount":2500}'package main
import (
"context"
"fmt"
"log"
"os"
"github.com/google/uuid"
"github.com/walletd-io/walletd-go"
)
// Prerequisites: two existing sandbox users in the same tenant, a funded sender,
// and a key with transfers:write. Complete processor confirmation before this call.
func main() {
client, err := walletd.New(os.Getenv("WALLETD_API"), walletd.APIKey(os.Getenv("WALLETD_API_KEY")))
if err != nil {
log.Fatal(err)
}
from, err := uuid.Parse(os.Getenv("FROM_USER_ID"))
if err != nil {
log.Fatal(err)
}
to, err := uuid.Parse(os.Getenv("TO_USER_ID"))
if err != nil {
log.Fatal(err)
}
// Persist this operation key with the business operation. Reuse it on retries.
key := walletd.IdempotencyKey(os.Getenv("TRANSFER_KEY"))
if key == "" {
log.Fatal("TRANSFER_KEY is required")
}
transfer, err := client.CreateTransfer(context.Background(), key, walletd.CreateTransferRequest{
FromUser: from, ToUser: &to, Amount: 2500, // integer minor units
})
if err != nil {
log.Fatal(err)
}
fmt.Println(transfer.Id, transfer.Status)
}
# Python standard library; existing funded sandbox users.
import json, os, urllib.request
payload = {"from_user":"0191c2d5-2b18-7e63-8f4a-05c7b9d1e832","to_user":"0191c2d4-8f3a-7c51-9b2e-4a6f8d310e27","amount":2500}
request = urllib.request.Request(os.environ['WALLETD_API'] + '/v1/transfers',
data=json.dumps(payload).encode(), method='POST', headers={
'Authorization': 'Bearer ' + os.environ['WALLETD_API_KEY'],
'Content-Type': 'application/json',
'Idempotency-Key': os.environ['TRANSFER_KEY'],
})
with urllib.request.urlopen(request, timeout=30) as response:
print(json.load(response))// Node.js HTTP; never put a tenant API key in a browser.
const response = await fetch(process.env.WALLETD_API + '/v1/transfers', {
method: 'POST', redirect: 'error', signal: AbortSignal.timeout(30000),
headers: {
Authorization: 'Bearer ' + process.env.WALLETD_API_KEY,
'Content-Type': 'application/json',
'Idempotency-Key': process.env.TRANSFER_KEY,
},
body: JSON.stringify({"from_user":"0191c2d5-2b18-7e63-8f4a-05c7b9d1e832","to_user":"0191c2d4-8f3a-7c51-9b2e-4a6f8d310e27","amount":2500}),
});
if (!response.ok) throw new Error('Transfer HTTP ' + response.status);
console.log(await response.json());<?php
// PHP cURL; existing funded sandbox users.
$ch = curl_init(getenv('WALLETD_API') . '/v1/transfers');
curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30, CURLOPT_FOLLOWLOCATION => false,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('WALLETD_API_KEY'),
'Content-Type: application/json', 'Idempotency-Key: ' . getenv('TRANSFER_KEY')],
CURLOPT_POSTFIELDS => '{"from_user":"0191c2d5-2b18-7e63-8f4a-05c7b9d1e832","to_user":"0191c2d4-8f3a-7c51-9b2e-4a6f8d310e27","amount":2500}',
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($body === false || $status < 200 || $status >= 300) {
throw new RuntimeException('Transfer request failed');
}
echo $body;// Java 17+ HTTP; existing funded sandbox users.
import java.net.URI;
import java.net.http.*;
import java.time.Duration;
class TransferExample {
public static void main(String[] args) throws Exception {
var client = HttpClient.newBuilder().followRedirects(HttpClient.Redirect.NEVER).build();
var request = HttpRequest.newBuilder(URI.create(System.getenv("WALLETD_API") + "/v1/transfers"))
.timeout(Duration.ofSeconds(30))
.header("Authorization", "Bearer " + System.getenv("WALLETD_API_KEY"))
.header("Content-Type", "application/json")
.header("Idempotency-Key", System.getenv("TRANSFER_KEY"))
.POST(HttpRequest.BodyPublishers.ofString("""
{"from_user":"0191c2d5-2b18-7e63-8f4a-05c7b9d1e832","to_user":"0191c2d4-8f3a-7c51-9b2e-4a6f8d310e27","amount":2500}
""")).build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() < 200 || response.statusCode() >= 300) throw new Exception("Transfer failed");
System.out.println(response.body());
}
}Webhooks
Verifique em poucas linhas.
Cada evento e assinado. Rejeite qualquer coisa que nao verifique em tempo constante, e deduplique pelo id do evento. Receber o mesmo evento duas vezes e esperado e seguro.
Todos os tipos de evento// Pseudocode: use the verified webhook receiver in the documentation.
// Verify timestamp freshness and HMAC over timestamp + "." + raw request bytes.
// Use constant-time comparison. Reject before accepting any event identity.
// Deduplicate using the event id inside the VERIFIED body, not an unsigned header.
// Persist to an inbox before returning success; process asynchronously.
// See https://docs.walletd.io/webhooks for executable receivers.Preço fixo, sem tarifa por transação
Obtenha uma chave de sandbox.
Toda avaliação recebe um tenant de sandbox, os contratos OpenAPI, o SDK em Go e uma linha direta com os engenheiros que o construíram. A produção tem preço mensal fixo, sem tarifa por transação.