使用Seerbit接受多种货币：开发人员指南-js教程-PHP中文网

使用Seerbit接受多种货币：开发人员指南

霞舞

发布： 2025-02-18 08:02:21

原创

260人浏览过

在全球化市场中，支持多种货币对企业吸引多元化客户至关重要。允许客户使用其偏好货币支付，不仅提升用户体验，还能显著提高交易转化率。

领先的支付网关 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接受多种货币：开发人员指南