Dari kunci API ke pembukuan terekonsiliasi dalam lima langkah.

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

Bentuk sebuah integrasi

  1. 1. Cerminkan pengguna Anda

    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.

  2. 2. Isi dompetnya

    Mulai top-up melalui Stripe. Saldo dikreditkan hanya ketika gateway mengonfirmasi dengan webhook bertanda tangan atau kueri rekonsiliasi, tidak pernah pada callback klien.

  3. 3. Gerakkan uangnya

    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.

  4. 4. Reward dan settlement mengikuti

    Cashback dan poin diberikan pada saat capture; biaya dan komisi dibagi; payout menghasilkan laporan settlement. Semuanya memposting ke pembukuan yang sama.

  5. 5. Baca dan verifikasi

    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

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());
  }
}

Prinsip yang berlaku di setiap langkah

Idempoten secara bawaan

Setiap panggilan penggerak uang mengambil sebuah kunci idempoten. Percobaan ulang aman; ledger memutar ulang hasil tersimpan byte demi byte.

Berimbang dalam satu transaksi

Biaya, hold, batas, dan clawback diterapkan di dalam posting yang sama, sehingga pembukuan tidak pernah sesaat pun salah.

Dikonfirmasi, bukan diasumsikan

Uang bergerak pada konfirmasi gateway yang terverifikasi dan settle di ledger, bukan pada respons klien yang optimistis.

Diverifikasi terus-menerus

Verifier terjadwal menghitung ulang konservasi, saldo, dan floor, serta gagal secara nyaring begitu ada yang menyimpang.

Dari penerapan hingga operasi sehari-hari.

Mitra untuk seluruh siklus hidup, dengan cakupan yang disepakati dan tanggung jawab yang jelas.

Rencanakan dan terapkan

Arsitektur, lingkungan, konfigurasi dan perencanaan rilis bersama tim Anda.

Sesuaikan

Sesuaikan merek, alur kerja dan aturan bisnis dengan produk yang ingin Anda bangun.

Operasikan dan kembangkan

Dukungan, pemeliharaan dan pembaruan dengan jalur eskalasi dan tingkat layanan sesuai perjanjian.

Explore managed services (English) →

Harga tetap, tanpa biaya per transaksi

Lihat berjalan dengan angka Anda.

Bawa satu kasus, dari penerimaan hingga pencairan. Dalam 30 menit Anda akan melihatnya dicatat, dicocokkan, dan dihargai, bersama insinyur yang membangunnya.