跳到主要内容

沙盒环境

在正式上线前，可在无风险的沙盒环境中测试你的 Pelago 集成。

概述​

沙盒环境完整模拟生产功能，但使用测试网络和模拟交易，不涉及真实加密货币。

环境API 基础 URL网络
沙盒https://api.sandbox.pelago.techStellar Testnet、Goerli
生产https://api.pelago.techStellar Mainnet、Ethereum

获取沙盒凭证​

  1. 在 dashboard.pelago.tech 注册账户
  2. 前往 设置 → API 密钥
  3. 切换至 沙盒 模式
  4. 点击 生成 API 密钥
# 沙盒凭证带有 'test_' 前缀
PELAGO_API_KEY=test_pk_xxxxxxxxxxxxx
PELAGO_API_SECRET=test_sk_xxxxxxxxxxxxx

测试网络​

Stellar Testnet​

获取免费的测试网 XLM 用于支付交易手续费：

# 使用 Stellar Friendbot 为你的测试账户充值
curl "https://friendbot.stellar.org/?addr=YOUR_TESTNET_ADDRESS"

或访问：https://laboratory.stellar.org/#account-creator

Ethereum Goerli（测试用）​

从水龙头获取免费的 Goerli ETH：

测试钱包​

在沙盒中使用以下测试钱包进行支付：

网络地址备注
Stellar TestnetGBXXXTEST...已充值测试网 USDC
Goerli0x000...TEST已充值测试 USDC

进行测试支付​

import { PelagoClient } from '@pelago/sdk';

const pelago = new PelagoClient({
  apiKey: process.env.PELAGO_API_KEY,
  apiSecret: process.env.PELAGO_API_SECRET,
  environment: 'sandbox' // 👈 使用沙盒模式
});

// 创建测试支付
const payment = await pelago.payments.create({
  amount: 10.00,
  currency: 'USD',
  cryptocurrency: 'USDC',
  network: 'stellar-testnet', // 👈 使用测试网
  merchantWallet: 'YOUR_TESTNET_WALLET',
  metadata: { test: true }
});

测试银行卡（法币 → 加密货币入金测试）​

测试法币入金流程时，请使用以下测试卡号：

卡号结果
4242 4242 4242 4242支付成功
4000 0000 0000 0002支付被拒
4000 0000 0000 9995余额不足

Webhook 测试​

使用 Webhook 测试工具检查事件：

  1. ngrok - 暴露本地 Webhook 端点

    ngrok http 3000
    # 使用生成的 https URL 配置 Webhook

  2. Webhook.site - 检查 Webhook 负载

测试场景​

支付成功​

// 沙盒中金额小于 100 USD 的支付始终会成功
const payment = await pelago.payments.create({
  amount: 50.00,
  // ...
});

支付失败​

// 金额为 999.99 USD 将触发失败
const payment = await pelago.payments.create({
  amount: 999.99,
  // ...
});

支付过期​

// 支付默认 30 分钟后过期
// 使用 'expiresIn' 测试更短的过期时间
const payment = await pelago.payments.create({
  amount: 50.00,
  expiresIn: 60, // 60 秒，用于测试
  // ...
});

沙盒限制​

功能沙盒生产环境
真实资金❌ 仅测试✅ 真实加密货币
交易速度即时取决于网络
速率限制100 请求/分钟1000 请求/分钟
Webhook 重试3 次10 次
结算模拟真实

上线生产环境​

当你准备好上线时：

  1. 在控制台中切换至 生产环境
  2. 完成 KYC 验证
  3. 生成生产环境 API 密钥
  4. 更新环境变量
  5. 将代码中的 sandbox 替换为 production
const pelago = new PelagoClient({
  apiKey: process.env.PELAGO_API_KEY, // 生产环境密钥
  environment: 'production' // 👈 切换至生产环境
});

下一步​