Rencanakan dan terapkan
Arsitektur, lingkungan, konfigurasi dan perencanaan rilis bersama tim Anda.
WalletD adalah REST API di depan sebuah ledger of record. Berikut jalur yang ditempuh satu pembayaran, dari onboarding pengguna hingga sebuah pergerakan yang bisa dihitung ulang oleh auditor Anda. Tidak ada langkah yang dihitung per pemakaian: WalletD berharga bulanan tetap, bukan biaya per panggilan atau per transaksi.
Cara kerjanya
Buat pengguna dompet dengan external id Anda sendiri. WalletD membuka akun per tujuan (tunai, poin) saat pertama kali masing-masing digunakan, sehingga tidak ada yang perlu disiapkan di awal.
Mulai top-up melalui Stripe. Saldo dikreditkan hanya ketika gateway mengonfirmasi dengan webhook bertanda tangan atau kueri rekonsiliasi, tidak pernah pada callback klien.
Kirim peer-to-peer, terima pembayaran dengan hold, atau bagi penjualan marketplace. Setiap panggilan membawa kunci idempoten dan memposting leg berimbang ke ledger dalam satu transaksi.
Cashback dan poin diberikan pada saat capture; biaya dan komisi dibagi; payout menghasilkan laporan settlement. Semuanya memposting ke pembukuan yang sama.
Baca saldo dan riwayat lewat API, terima webhook bertanda tangan untuk setiap peristiwa, dan biarkan verifier bawaan memeriksa ulang invarian ledger secara terjadwal.
Transfer antar pengguna sandbox dengan saldo
Prasyarat: dua pengguna pada tenant yang sama, dana uji terkonfirmasi dan kunci transfers:write. Gunakan kunci dan isi yang sama saat mencoba lagi.
# 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());
}
}Setiap panggilan penggerak uang mengambil sebuah kunci idempoten. Percobaan ulang aman; ledger memutar ulang hasil tersimpan byte demi byte.
Biaya, hold, batas, dan clawback diterapkan di dalam posting yang sama, sehingga pembukuan tidak pernah sesaat pun salah.
Uang bergerak pada konfirmasi gateway yang terverifikasi dan settle di ledger, bukan pada respons klien yang optimistis.
Verifier terjadwal menghitung ulang konservasi, saldo, dan floor, serta gagal secara nyaring begitu ada yang menyimpang.
Mitra untuk seluruh siklus hidup, dengan cakupan yang disepakati dan tanggung jawab yang jelas.
Arsitektur, lingkungan, konfigurasi dan perencanaan rilis bersama tim Anda.
Sesuaikan merek, alur kerja dan aturan bisnis dengan produk yang ingin Anda bangun.
Dukungan, pemeliharaan dan pembaruan dengan jalur eskalasi dan tingkat layanan sesuai perjanjian.
Harga tetap, tanpa biaya per transaksi
Bawa satu kasus, dari penerimaan hingga pencairan. Dalam 30 menit Anda akan melihatnya dicatat, dicocokkan, dan dihargai, bersama insinyur yang membangunnya.