跳转到主要内容
VelaFi 提供两个 REST API 环境——用于真实流量的生产环境和用于集成测试的沙盒环境。您发起的每个 API 调用都以其中一个基础 URL 作为前缀。开发期间请选择沙盒环境,以确保测试永远不会涉及真实资金或用户数据;准备上线时再切换到生产环境 URL。
对两个环境的所有请求都需要携带 X-BH-TOKEN 请求头,其中包含通过 GET /v2/token/generate 获取的令牌。请妥善保管生产环境凭证,并在测试期间使用单独的沙盒环境凭证。

环境

用法

在每个端点路径前加上与目标环境对应的基础 URL。例如,国家列表端点将变为:
将基础 URL 存储在环境变量(例如 VELAFI_BASE_URL)中,这样无需修改代码即可在生产环境和沙盒环境之间切换。