من مفتاح API إلى سجلات متطابقة في خمس خطوات.

WalletD هو REST API أمام دفتر أستاذ رسمي. هذا هو المسار الذي تسلكه دفعة واحدة، من إدماج مستخدم إلى حركة يستطيع مدقّقوك إعادة حسابها. لا تُحتسب أي خطوة حسب الاستخدام: سعر WalletD شهري ثابت، لا رسوم على كل طلب أو كل معاملة.

آلية العمل

شكل التكامل

  1. 1. اعكس مستخدمك

    أنشئ مستخدم محفظة بمعرّفك الخارجي الخاص. يفتح WalletD حسابات حسب الغرض (نقد، نقاط) أول مرة يُستخدم فيها كلٌّ منها، فلا شيء يحتاج للتوفير سلفًا.

  2. 2. موّل المحفظة

    ابدأ عملية شحن عبر Stripe. يُضاف الرصيد فقط عندما تؤكّد البوابة عبر خطاف ويب موقّع أو استعلام مطابقة، لا عبر رد اتصال من العميل أبدًا.

  3. 3. حرّك الأموال

    أرسِل بين الأقران، أو خذ دفعة بحجز، أو قسّم بيعًا في السوق. كل استدعاء يحمل مفتاح تكافؤ ويقيّد أطرافًا متوازنة في دفتر الأستاذ ضمن معاملة واحدة.

  4. 4. المكافآت والتسوية تتبع

    الاسترداد النقدي والنقاط تُمنح عند لحظة الالتقاط؛ والرسوم والعمولة تُقسَّم؛ والصرفيات تنتج كشف تسوية. كل ذلك يُقيَّد في السجلات نفسها.

  5. 5. اقرأ وتحقّق

    اقرأ الأرصدة والتاريخ عبر الـ 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());
  }
}

مبادئ تصمد في كل خطوة

متكافئ افتراضيًا

كل استدعاء محرِّك للأموال يأخذ مفتاح تكافؤ. إعادة المحاولات آمنة؛ ويعيد دفتر الأستاذ النتيجة المخزّنة بايتًا ببايت.

متوازن ضمن معاملة واحدة

الرسوم والحجوزات والحدود والاستردادات العكسية تُطبَّق داخل القيد نفسه، فلا تكون السجلات خاطئة ولو للحظة.

مؤكَّد، لا مفترَض

الأموال تتحرك على تأكيد موثّق من البوابة وتُسوّى في دفتر الأستاذ، لا على رد متفائل من العميل.

مُتحقَّق منه باستمرار

مُحقِّق مجدوَل يعيد حساب الحفظ والأرصدة والحدود الدنيا، ويُخفق بوضوح لحظة انحراف أي شيء.

من النشر إلى العمليات اليومية.

شريك طوال دورة الحياة، بنطاق متفق عليه ومسؤوليات واضحة.

التخطيط والنشر

تصميم البنية وإعداد البيئات والتهيئة وتخطيط الإصدارات بالتعاون مع فريقك.

التخصيص

خصص العلامة التجارية ومسارات العمل وقواعد الأعمال وفق المنتج الذي تريد بناءه.

التشغيل والتطوير

دعم وصيانة وتحديثات مستمرة، مع مسارات تصعيد ومستويات خدمة محددة في اتفاقيتك.

Explore managed services (English) →

سعر ثابت دون رسوم على كل معاملة

شاهده يعمل على أرقامك.

أحضر حالة واحدة من التحصيل إلى الصرف. خلال 30 دقيقة ستراها مقيدة ومطابَقة ومسعّرة، مع المهندس الذي بناها.