本页内容
Base URL
测试与正式请求共用一个 Paymos Merchant API base URL,通过密钥前缀选择环境,保持一条集成路径。
所有 API 端点都相对于同一个 base URL——环境由 API 密钥的前缀决定,而不是由主机决定。
Base URL
https://api.paymos.io/v1
完整的请求 URL 形如:
https://api.paymos.io/v1/invoices
Sandbox 与正式环境
Paymos 对两个环境使用同一个 base URL。环境编码在密钥本身中——_test_ 表示 sandbox,_live_ 表示正式:
| 环境 | 使用方式 |
|---|---|
| Sandbox | 测试 API key ID(pk_test_… / rk_test_…)配 sk_test_… secret |
| 正式 | 正式 API key ID(pk_live_… / rk_live_…)配 sk_live_… secret |
Sandbox 凭证模拟交易,不处理真实资金。切换到正式环境无需更改 URL——换掉 API 密钥即可,主机保持不变。
相同的主机、相同的路径、相同的载荷——sandbox 与正式环境唯一的区别是用哪套凭证签名。两套都放在配置里,用环境变量切换。