在全球化市场中，支持多种货币对企业吸引多元化客户至关重要。允许客户使用其偏好货币支付，不仅提升用户体验，还能显著提高交易转化率。
领先的支付网关 Seerbit
Seerbit 提供强大的多货币功能，使企业能够流畅地处理来自全球各地的支付。Seerbit 的多货币功能：
支持的货币和地区
Seerbit 支持尼日利亚、加纳、肯尼亚、塞内加尔等多个非洲国家的多种货币。如此广泛的覆盖范围确保企业能够满足当地客户的货币需求，从而建立信任并提供便利。
自动货币转换
Seerbit 的智能支付路由系统会选择最佳路由处理交易，确保支付成功。虽然 Seerbit 处理多种货币，但开发者需要在客户端管理货币转换，以便准确地向用户显示价格。
在 Node.js 应用中集成 Seerbit 多货币支持
通过 Seerbit，您可以轻松地将多货币支持集成到您的 Node.js 应用程序中，让客户使用其首选货币进行交易，从而扩展您的全球业务。本指南将逐步指导您完成此集成过程，包括使用 Seerbit 的 Node.js SDK。
前提条件
在开始之前，请确保您已安装以下内容：
- Node.js 和 npm
- Seerbit 账户（从 Seerbit 仪表板获取您的公钥和私钥）
- 汇率 API（例如 Currency Freaks 或 exchangerate-api）
步骤 1：项目设置
- 初始化项目: 创建一个新的 Node.js 项目并安装必要的依赖项：
mkdir seerbit-multicurrency cd seerbit-multicurrency npm init -y npm install axios seerbit-nodejs node-schedule dotenv
-
配置环境变量: 创建一个
.env文件，安全地存储您的 API 密钥：
seerbit_public_key=your_seerbit_public_key seerbit_secret_key=your_seerbit_secret_key seerbit_bearer_token=your_seerbit_bearer_token exchange_rate_api_key=your_exchange_rate_api_key
请将占位符替换为您的实际密钥。
步骤 2：获取实时汇率
为了以多种货币显示价格，您需要获取最新的汇率。
- 创建货币转换模块:
// currencyconverter.js
require('dotenv').config();
const axios = require('axios');
const apikey = process.env.exchange_rate_api_key;
const baseurl = 'https://api.currencyfreaks.com/v2.0/rates/latest'; // or your preferred API
async function convertCurrency(amount, fromCurrency, toCurrency) {
try {
const response = await axios.get(baseurl, {
params: {
apikey: apikey,
symbols: toCurrency,
base: fromCurrency
}
});
const rate = response.data.rates[toCurrency];
const convertedAmount = amount * rate;
return parseFloat(convertedAmount.toFixed(2));
} catch (error) {
console.error('Error fetching exchange rates:', error);
throw new Error('Currency conversion failed');
}
}
module.exports = convertCurrency;
此模块获取指定货币之间的汇率并计算转换后的金额。
- 实现汇率定期更新:
为了保持汇率最新，请安排定期更新：
// exchangerateupdater.js
const schedule = require('node-schedule');
const axios = require('axios');
require('dotenv').config();
const apikey = process.env.exchange_rate_api_key;
const baseurl = 'https://api.currencyfreaks.com/v2.0/rates/latest'; // or your preferred API
async function updateExchangeRates() {
try {
const response = await axios.get(baseurl, { params: { apikey: apikey } });
// Save response.data.rates to your database or in-memory store
console.log('Exchange rates updated:', response.data.rates);
} catch (error) {
console.error('Error updating exchange rates:', error);
}
}
// Schedule the job to run hourly
schedule.scheduleJob('0 * * * * *', updateExchangeRates);
此脚本每小时获取并存储最新的汇率。
步骤 3：生成 Bearer 令牌
为了将 Seerbit 的支付服务集成到您的 Node.js 应用程序中，您需要生成一个 Bearer 令牌用于 API 身份验证。
-
准备您的密钥: 从您的 Seerbit 商户仪表板获取公钥和私钥。
-
连接和加密密钥: 将您的私钥和公钥连接成一个字符串，用点号 (.) 分隔：
secret_key.public_key。 然后，将此连接字符串发送到 Seerbit 的加密端点以获取加密密钥。 -
请求加密密钥:
-
端点:
POST https://seerbitapi.com/api/v2/encrypt/keys -
标题:
Content-Type: application/json - 正文:
{ "key": "secret_key.public_key" } -
端点:
重要注意事项:
- 安全性：谨慎处理您的私钥和公钥。避免在客户端代码或公共存储库中暴露它们。
- 令牌有效性：加密密钥（Bearer 令牌）可能具有有效期。确保您在应用程序中正确处理令牌过期。
- 错误处理：实施全面的错误处理，以管理令牌生成和支付初始化过程中可能出现的潜在问题。
请参考 Seerbit 的官方文档了解关于身份验证和 Node.js SDK 的更多信息。
步骤 4：与 Seerbit 集成处理支付
集成 Seerbit 支付网关来处理各种货币的交易。
- 初始化 Seerbit SDK:
// seerbitpayment.js
const { Client, Config, StandardCheckout } = require('seerbit-nodejs');
require('dotenv').config();
const config = new Config({
publicKey: process.env.seerbit_public_key,
secretKey: process.env.seerbit_secret_key,
bearerToken: process.env.seerbit_bearer_token
});
const client = new Client(config);
const standardCheckout = new StandardCheckout(client);
async function initializePayment(amount, currency, email) {
const payload = {
amount,
callbackUrl: 'https://www.yourapp.com/callback', // Replace with your callback URL
country: 'NG', // Or appropriate country code
currency,
email,
paymentReference: Date.now().toString()
};
try {
const response = await standardCheckout.initialize(payload);
console.log('Payment initialized successfully:', response);
return response;
} catch (error) {
console.error('Error initializing payment:', error);
throw error;
}
}
module.exports = initializePayment;
此模块设置 Seerbit 客户端并定义一个函数来初始化支付。
- 集成转换和支付初始化:
结合货币转换和支付初始化来处理多货币交易：
// app.js
const convertCurrency = require('./currencyConverter');
const initializePayment = require('./seerbitPayment');
async function processPayment(amount, fromCurrency, toCurrency, email) {
try {
const convertedAmount = await convertCurrency(amount, fromCurrency, toCurrency);
await initializePayment(convertedAmount, toCurrency, email);
} catch (error) {
console.error('Error processing payment:', error);
}
}
// Example usage
processPayment(100, 'USD', 'NGN', 'customer@example.com');
此脚本将金额从源货币转换为目标货币，然后使用 Seerbit 初始化支付。
结果
支付链接生成
结论
通过遵循这些步骤，您可以使用 Seerbit 在您的 Node.js 应用程序中实现多货币支持。此集成确保客户可以使用其首选货币进行交易，从而提升用户体验并扩展您的市场范围。 请参考 Seerbit API 文档了解更多详细信息和高级配置。
感谢您的阅读！祝您编码愉快！
