التخطيط والنشر
تصميم البنية وإعداد البيئات والتهيئة وتخطيط الإصدارات بالتعاون مع فريقك.
WalletD هو REST API أمام دفتر أستاذ رسمي. هذا هو المسار الذي تسلكه دفعة واحدة، من إدماج مستخدم إلى حركة يستطيع مدقّقوك إعادة حسابها. لا تُحتسب أي خطوة حسب الاستخدام: سعر WalletD شهري ثابت، لا رسوم على كل طلب أو كل معاملة.
آلية العمل
أنشئ مستخدم محفظة بمعرّفك الخارجي الخاص. يفتح WalletD حسابات حسب الغرض (نقد، نقاط) أول مرة يُستخدم فيها كلٌّ منها، فلا شيء يحتاج للتوفير سلفًا.
ابدأ عملية شحن عبر Stripe. يُضاف الرصيد فقط عندما تؤكّد البوابة عبر خطاف ويب موقّع أو استعلام مطابقة، لا عبر رد اتصال من العميل أبدًا.
أرسِل بين الأقران، أو خذ دفعة بحجز، أو قسّم بيعًا في السوق. كل استدعاء يحمل مفتاح تكافؤ ويقيّد أطرافًا متوازنة في دفتر الأستاذ ضمن معاملة واحدة.
الاسترداد النقدي والنقاط تُمنح عند لحظة الالتقاط؛ والرسوم والعمولة تُقسَّم؛ والصرفيات تنتج كشف تسوية. كل ذلك يُقيَّد في السجلات نفسها.
اقرأ الأرصدة والتاريخ عبر الـ API، واستقبل خطافات ويب موقّعة لكل حدث، ودع المُحقِّق المدمج يعيد فحص ثوابت دفتر الأستاذ وفق جدول زمني.
تحويل بين مستخدمين في بيئة اختبار ممولة
المتطلبات: مستخدمان في المستأجر نفسه، وأموال اختبار مؤكدة، ومفتاح بصلاحية transfers:write. أعد استخدام مفتاح العملية والمحتوى عند المحاولة مجدداً.
# 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());
}
}كل استدعاء محرِّك للأموال يأخذ مفتاح تكافؤ. إعادة المحاولات آمنة؛ ويعيد دفتر الأستاذ النتيجة المخزّنة بايتًا ببايت.
الرسوم والحجوزات والحدود والاستردادات العكسية تُطبَّق داخل القيد نفسه، فلا تكون السجلات خاطئة ولو للحظة.
الأموال تتحرك على تأكيد موثّق من البوابة وتُسوّى في دفتر الأستاذ، لا على رد متفائل من العميل.
مُحقِّق مجدوَل يعيد حساب الحفظ والأرصدة والحدود الدنيا، ويُخفق بوضوح لحظة انحراف أي شيء.
شريك طوال دورة الحياة، بنطاق متفق عليه ومسؤوليات واضحة.
تصميم البنية وإعداد البيئات والتهيئة وتخطيط الإصدارات بالتعاون مع فريقك.
خصص العلامة التجارية ومسارات العمل وقواعد الأعمال وفق المنتج الذي تريد بناءه.
دعم وصيانة وتحديثات مستمرة، مع مسارات تصعيد ومستويات خدمة محددة في اتفاقيتك.
سعر ثابت دون رسوم على كل معاملة
أحضر حالة واحدة من التحصيل إلى الصرف. خلال 30 دقيقة ستراها مقيدة ومطابَقة ومسعّرة، مع المهندس الذي بناها.