跳到正文

API

本页内容

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 与正式环境唯一的区别是用哪套凭证签名。两套都放在配置里,用环境变量切换。