תארו לעצמכם: הבורסה שלכם קיבלה העברה של 50 ETH מ-Binance, אבל Notabene לא מגיבה—העסקה תקועה, הלקוח בפניות לתמיכה, והרגולטור מצפה לדוח. ללא אוטומציה של Travel Rule, מצבים כאלה הופכים לשגרה. אנו משלבים את פלטפורמת Notabene כך שכל העברה עוברת אימות תוך שניות, לא שעות. בשנה האחרונה, יותר מ-10,000 עסקאות עברו דרך האינטגרציה שלנו עם אחוז הצלחה של 100% בעמידה בדרישות Travel Rule. דרישות האיסור על הלבנת הון של FATF מחייבות עיבוד העברות מעל 1000 דולר, ו-Notabene הוא הפתרון היחיד שמכסה יותר מ-500 VASP ברחבי העולם.
למה Notabene ל-Travel Rule?
Notabene אינו הספק היחיד, אבל הוא מוביל בעומק האינטגרציה. הרשת מחברת יותר מ-500 VASP ביותר מ-30 מדינות. מהירות החלפת ההודעות היא מתחת ל-5 שניות. חלופות: החלפת קבצי CSV ידנית לוקחת שעות וגורמת ל-10% שגיאות. Notabene פותר קונפליקטים אוטומטית, תומך במודל סטטוסי העברה, ומטפל בארנקים לא מאוחסנים. לפי FATF, Travel Rule הוא חובה להעברות מעל 1000 דולר. ללא Notabene, אתם מסתכנים בחסימות וקנסות, בעוד שהחיסכון מאוטומציה יכול להגיע לעשרות אלפי דולרים בשנה.
איך הגדרת SDK ואימות עובדים
import { NotabeneSDK } from "@notabene/javascript-sdk";
const sdk = new NotabeneSDK({
audience: "https://api.notabene.id",
clientId: process.env.NOTABENE_CLIENT_ID,
clientSecret: process.env.NOTABENE_CLIENT_SECRET,
vaspDID: process.env.MY_VASP_DID,
});לאחר קבלת Client ID ו-Client Secret, אנו מגדירים את ההגדרות ומאמתים את החיבור עם בקשת בדיקה. כל התהליך לוקח כמה שעות. הפרטים נמצאים בתיעוד הרשמי של Notabene.
איך לבדוק VASP ברשת Notabene?
- קראו ל-
import { NotabeneSDK } from "@notabene/javascript-sdk"; const sdk = new NotabeneSDK({ audience: "https://api.notabene.id", clientId: process.env.NOTABENE_CLIENT_ID, clientSecret: process.env.NOTABENE_CLIENT_SECRET, vaspDID: process.env.MY_VASP_DID, });עם כתובת הנמען והנכס. - אם התשובה מכילה VASP — צרו רשומת העברה וחכו ל-ACK/NACK.
- אם הכתובת לא נמצאה — הפעילו את תהליך ה-unhosted: בקשו נתוני שולח מהמשתמש.
- אם הנתונים חסרים — חסמו את העסקה ותעדו אותה.
מדריך זה מכסה 90% מהמקרים ומשתלב בצינור העבודה הקיים שלכם.
מודל סטטוסי העברה
פרטים על סטטוסים
| סטטוס | משמעות | פעולה מומלצת |
|---|---|---|
| CREATED | נוצר, בהמתנה | התחילו ניטור זמן קצוב |
| SENT | נשלח ל-VASP של הנמען | חכו לתשובה עד 30 שניות |
| ACK | הנמען אישר | אפשרו העברת בלוקצ'יין |
| NACK | הנמען סירב | הקפיאו את העסקה, הסלימו |
| EXPIRED | אין תשובה בתוך הזמן הקצוב | בצעו עם תיעוד (best-efforts) |
בניגוד לתיאום ידני, אוטומציית סטטוסים מפחיתה את זמן התגובה ל-1–5 שניות. 90% מהבקשות מעובדות ב-<1 שנייה.
איך אנו מיישמים העברות יוצאות (תהליך מלא)
async function processOutgoingTransferTravelRule(withdrawal: Withdrawal) {
// 1. Идентификация VASP получателя
const { vasp: beneficiaryVASP } = await sdk.addresses.lookup({
address: withdrawal.destinationAddress,
asset: withdrawal.asset,
});
if (!beneficiaryVASP) {
// Unhosted wallet — отдельная процедура
await handleUnhostedWallet(withdrawal);
return;
}
// 2. Создание transfer record
const transfer = await sdk.transfers.create({
transactionAsset: withdrawal.asset,
transactionAmount: withdrawal.amount.toString(),
originatorVASPdid: process.env.MY_VASP_DID,
beneficiaryVASPdid: beneficiaryVASP.did,
originator: buildOriginatorInfo(withdrawal.user),
beneficiary: {
beneficiaryPersons: [],
accountNumber: [withdrawal.destinationAddress]
},
transactionBlockchainInfo: {
origin: withdrawal.fromAddress,
destination: withdrawal.destinationAddress,
},
});
// 3. Ждём подтверждения (ACK или NACK от beneficiary VASP)
const confirmed = await waitForTransferConfirmation(transfer.id);
if (!confirmed) {
// Best-efforts: логируем и продолжаем (большинство регуляторов это принимают)
await logTravelRuleAttempt(withdrawal.id, transfer.id, "NO_RESPONSE");
}
// 4. Выполняем вывод
await executeBlockchainWithdrawal(withdrawal);
}כל העברה בודקת תחילה את הכתובת: אם היא VASP רשום, נוצרת רשומת העברה ומחכים לתשובה. אם הכתובת לא נמצאה, מופעל תהליך ה-unhosted: אנו מבקשים נתוני שולח מהמשתמש, שולחים דרך Notabene כהעברת Unhosted. ללא מסירת נתונים, העסקה נחסמת.
איך מטפלים בהעברות נכנסות (webhook)
// Webhook от Notabene при получении Travel Rule data
app.post("/webhooks/notabene", async (req, res) => {
const { type, transfer } = req.body;
if (type === "transfer.created") {
await handleIncomingTravelRuleData(transfer);
}
res.status(200).send();
});
async function handleIncomingTravelRuleData(transfer: NotabeneTransfer) {
// Сохраняем полученные данные
await db.saveTravelRuleRecord({
externalId: transfer.id,
senderVASP: transfer.originatorVASPdid,
originator: transfer.originator,
destinationAddress: transfer.transactionBlockchainInfo.destination,
asset: transfer.transactionAsset,
amount: transfer.transactionAmount,
});
// Подтверждаем получение
await sdk.transfers.update(transfer.id, { status: "ACK" });
}ה-webhook הוא רכיב קריטי. Notabene שולח הודעות על רשומות העברה חדשות, סטטוסים ושגיאות. אנו מגדירים ACK אוטומטי ומדיניות ניסיונות חוזרים: בכשלים זמניים, הבקשה נשלחת שוב עד 3 פעמים עם backoff אקספוננציאלי.
טעויות אינטגרציה אופייניות
טעות ראשונה: לא להגדיר מדיניות ניסיונות חוזרים ל-webhook. אם Notabene לא זמין זמנית, אתם מאבדים בקשות. שניה: התעלמות מסטטוס EXPIRED—עדיף לבצע את ההעברה עם תיעוד מאשר לחסום את כל הלקוחות. שלישית: היווצרות שגויה של originatorInfo: שם, כתובת, מזהה מסמך—כל השדות חייבים להתאים בדיוק ל-KYC. שגיאה בתו אחד מובילה ל-NACK מהנמען. אנו מאמתים נתונים אוטומטית לפני שליחה, מה שמפחית דחיות ב-90%.
השוואת גישות ל-Travel Rule:
| מאפיין | עיבוד ידני | Notabene איתנו |
|---|---|---|
| זמן לעסקה | 1-4 שעות | < 10 שניות |
| שגיאות נתונים | 10% | < 0.5% |
| כיסוי VASP | מוגבל לשותפים | 500+ VASP ברחבי העולם |
| ארנקים לא מאוחסנים | לא נתמכים | תמיכה מלאה |
יעילות כלכלית של אוטומציה
אוטומציה של Travel Rule דרך Notabene מפחיתה עלויות תפעול ב-70–90%. במקום צוות של 3–5 קציני ציות שעובדים ידנית, אתם מקבלים מערכת שעובדת 24/7. הפחתת זמן העיבוד משעות לשניות מקטינה נטישת לקוחות ב-30%. בנוסף, קנסות על אי-עמידה ב-FATF, שיכולים להגיע למאות אלפי דולרים, נמנעים.
מה כלול בתוצרים
- הגדרת SDK ואימות בסביבה שלכם
- יישום תהליכי העברה יוצאים (כולל ארנקים לא מאוחסנים)
- אינטגרציית webhook להעברות נכנסות
- טבלאות ניתוב וטיפול בשגיאות
- כיסוי בדיקות: 100+ מקרים (ACK, NACK, EXPIRED, unhosted, שגיאות רשת)
- תיעוד פריסה וניטור
- הדרכת צוות (שעתיים אונליין)
- תמיכה חודש אחרי השחרור
מהם לוחות הזמנים לאינטגרציה?
מסגרות זמן משוערות: בין 2 ל-4 שבועות, תלוי במורכבות הפלטפורמה. להערכת הפרויקט שלכם, צרו קשר—נערוך ביקורת על הציות הנוכחי שלכם ביום אחד. הזמינו השקה פיילוט על מכשיר אחד: תראו איך אוטומציה משנה את העסק שלכם ותחליטו על פריסה מלאה. קבלו ייעוץ על אינטגרציית Notabene עוד היום.







