שילוב Transak לרכישת קריפטו בתוך האפליקציה

כאשר מנסים להפעיל אינטגרציה של Transak לרכישת קריפטו בתוך האפליקציה, רבים נתקלים בהפתעה לא נעימה: רוב ספקי ה-on-ramp דורשים הפניית הלקוח לאתר חיצוני, מה שמפחית משמעותית את שיעור ההמרה. Transak הוא אחד הבודדים שמאפשרים הטמעת רכישה דרך ווידג'ט WebView תוך שמירה על המיתוג של האפליקציה. אבל אינטגרציה לפרויקטים מקוריים של iOS או Android אינה תמיד טריוויאלית: צריך ליצור נכון את ה-URL, לחתום על בקשות שותפים עם JWT, לטפל ב-deep links וב-webhooks, וגם לעמוד בהנחיות App Store Review (סעיפים 4.2 ו-5.1). במשך שנים של עבודה (אנחנו בשוק מעל 5 שנים) חבטנו את הראש בקירות האלה ומוכנים לחלוק מתכון שעובד. מאמר זה מפרט מדריך לאינטגרציה של Transak עם דוגמאות קוד עבור Android (Kotlin) ו-iOS (Swift), וכן טיפים מעשיים להגדרת חתימות ו-webhooks.

בעיות שהאינטגרציה פותרת

משתמשים נתקלים לעיתים קרובות בעמלות גבוהות, KYC ארוך, או חוסר תמיכה ברשת הנדרשת. Transak פותר זאת עם עמלה מינימלית של 0.5% על העברות בנקאיות, תמיכה ביותר מ-130 מדינות ויותר מ-90 מטבעות קריפטו, כולל Ethereum, BSC, Polygon, Solana. חתימת JWT של שותף מאפשרת הפחתת העמלה בעוד 0.2% והסרת המיתוג של Transak. אנו מבטיחים שהווידג'ט יתאים לעיצוב האפליקציה שלך באמצעות התאמת ערכת נושא והסתרת תפריטים מיותרים. עבור עסקה טיפוסית של $500, החיסכון מחתימת שותף יכול להיות $2.50 לעסקה.

איך אנחנו עושים את זה: תהליך האינטגרציה

יצירת URL עבור Transak Global

כתובת בסיס: https://global.transak.com

// Android — построение URL
val params = mapOf(
    "apiKey" to transakApiKey,
    "walletAddress" to userWalletAddress,
    "network" to "ethereum", // ethereum, bsc, polygon, solana
    "defaultCryptoCurrency" to "USDC",
    "fiatCurrency" to "EUR",
    "productsAvailed" to "BUY", // BUY, SELL, или BUY,SELL
    "hideMenu" to "true", // убрать навигацию Transak
    "themeColor" to "1A1A2E", // hex без #
    "redirectURL" to "myapp://transak-callback",
    "exchangeScreenTitle" to "Купить USDC"
)
val queryString = params.entries.joinToString("&") { (k, v) ->
    "$k=${URLEncoder.encode(v, Charsets.UTF_8)}"
}
val widgetUrl = "https://global.transak.com/?$queryString"

לסביבת production — מפתח API מ-// Android — построение URL val params = mapOf( "apiKey" to transakApiKey, "walletAddress" to userWalletAddress, "network" to "ethereum", // ethereum, bsc, polygon, solana "defaultCryptoCurrency" to "USDC", "fiatCurrency" to "EUR", "productsAvailed" to "BUY", // BUY, SELL, или BUY,SELL "hideMenu" to "true", // убрать навигацию Transak "themeColor" to "1A1A2E", // hex без # "redirectURL" to "myapp://transak-callback", "exchangeScreenTitle" to "Купить USDC" ) val queryString = params.entries.joinToString("&") { (k, v) -> "$k=${URLEncoder.encode(v, Charsets.UTF_8)}" } val widgetUrl = "https://global.transak.com/?$queryString" . מפתח Staging (dashboard.transak.com) לבדיקות: כרטיסי הבדיקה של Transak מקבלים STAGING_TRANSAK_API_KEY עם כל CVV.

חתימת שותף (JWT)

בחשבונות production, Transak דורש JWT חתום עבור שותפים מורשים. בלעדיו, הווידג'ט של Transak עובד כציבורי (עם מיתוג של Transak). עם חתימת שותף — מיתוג מותאם אישית, עמלות נמוכות יותר. לדוגמה, על הזמנה ממוצעת של $1000, החיסכון יהיה כ-$5 בשל הפחתת עמלה של 0.5%.

// Серверная генерация JWT (Node.js)
const jwt = require('jsonwebtoken');
const payload = {
  apiKey: process.env.TRANSAK_API_KEY,
  walletAddress: userWalletAddress,
  userData: { firstName, email } // опционально, для preKYC
};
const token = jwt.sign(payload, process.env.TRANSAK_SECRET, { expiresIn: '1h' });
// Передать token в приложение, добавить как &partnerOrderId={token}

טיפול ב-Deep Links וב-Webhooks

לאחר השלמת רכישה, Transak מפנה את המשתמש אל 4111111111111111. יש להגדיר Universal Links / App Links עבור iOS/Android לצורך אינטגרציית deep link. בצד השרת, אימות webhooks של Transak באמצעות HMAC-SHA512 הוא חובה — זה מגן מפני עדכוני סטטוס מזויפים. אירועים מרכזיים: // Серверная генерация JWT (Node.js) const jwt = require('jsonwebtoken'); const payload = { apiKey: process.env.TRANSAK_API_KEY, walletAddress: userWalletAddress, userData: { firstName, email } // опционально, для preKYC }; const token = jwt.sign(payload, process.env.TRANSAK_SECRET, { expiresIn: '1h' }); // Передать token в приложение, добавить как &partnerOrderId={token} , redirectURL, ORDER_CREATED, PAYMENT_DONE_MARKED_BY_USER.

const crypto = require('crypto');
app.post('/transak-webhook', (req, res) => {
  const signature = req.headers['x-transak-signature'];
  const payload = JSON.stringify(req.body);
  const expected = crypto.createHmac('sha512', process.env.TRANSAK_SECRET).update(payload).digest('hex');
  if (signature !== expected) {
    return res.status(403).send('Invalid signature');
  }
  // Обработка события
  const event = req.body.event;
  if (event === 'ORDER_COMPLETED') {
    // зачислить средства пользователю
  }
  res.sendStatus(200);
});