Интеграция с Notabene (Travel Rule compliance)

Интеграция с Notabene (Travel Rule compliance)

Notabene — ведущий Travel Rule messaging провайдер с покрытием 500+ VASP в 30+ странах. SDK доступен для JavaScript/TypeScript, Python и Go. Интеграция занимает 1-2 недели.

SDK setup и аутентификация

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

Исходящий перевод: полный flow

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

Входящий перевод: получение Travel Rule данных

// 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" });
}

Статусы transfer и обработка

Интеграция Notabene в процесс ввода и вывода средств, включая webhook handling и unhosted wallet flow — 1-2 недели.