Planejar e implantar
Arquitetura, ambientes, configuração e planejamento de versões em conjunto com sua equipe.
O WalletD e uma API REST diante de um livro-razao oficial. Este e o caminho que um unico pagamento percorre, do onboarding de um usuario a um movimento que seus auditores podem recalcular. Nenhuma dessas etapas é cobrada por uso: a WalletD tem preço mensal fixo, não uma tarifa por chamada ou por transação.
Como funciona
Crie um usuario de carteira com seu proprio id externo. O WalletD abre contas por finalidade (dinheiro, pontos) na primeira vez em que cada uma e usada, entao nao ha nada para provisionar antecipadamente.
Inicie uma recarga pelo Stripe. O saldo e creditado apenas quando o gateway confirma com um webhook assinado ou uma consulta de reconciliacao, nunca por um callback do cliente.
Envie entre pessoas, receba um pagamento com uma reserva ou divida uma venda de marketplace. Cada chamada carrega uma chave de idempotencia e lanca lancamentos balanceados no livro-razao em uma unica transacao.
Cashback e pontos sao concedidos no momento da captura; tarifas e comissao sao divididas; repasses geram um extrato de liquidacao. Tudo isso lanca nos mesmos livros.
Leia saldos e historico pela API, receba webhooks assinados para cada evento e deixe o verificador interno reavaliar as invariantes do livro-razao de forma agendada.
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());
}
}Cada chamada de movimentacao financeira recebe uma chave de idempotencia. Novas tentativas sao seguras; o livro-razao repete o resultado armazenado byte a byte.
Tarifas, reservas, limites e estornos sao aplicados dentro do mesmo lancamento, entao os livros nunca ficam errados nem por um instante.
O dinheiro se move mediante confirmacao verificada do gateway e liquida no livro-razao, nao em uma resposta otimista do cliente.
Um verificador agendado recalcula conservacao, saldos e pisos, e falha ruidosamente no instante em que algo desvia.
Um parceiro para todo o ciclo de vida, com escopo acordado e responsabilidades claras.
Arquitetura, ambientes, configuração e planejamento de versões em conjunto com sua equipe.
Adapte a marca, os fluxos e as regras de negócio ao produto que deseja construir.
Suporte, manutenção e atualizações com escalonamento e níveis de serviço definidos em contrato.
Preço fixo, sem tarifa por transação
Traga um caso, da cobrança ao repasse. Em 30 minutos você o verá lançado, conciliado e precificado, com o engenheiro que o construiu.