服务内容
余额和账户
列出您的账户及其入账、冻结和可用余额。
收款人
列出已保存的收款人并添加新收款人,校验规则与应用中相同。
付款
获取每种付款方式的费用和到账时间,然后按所选报价付款。审批人在应用中使用通行密钥放行;超过您设定的门槛时,需要两位审批人。
Webhook
签名事件最多发送到 5 个 https 地址,每个地址有各自的密钥。可发送测试事件、重发失败的投递,或重发过去 24 小时内所有失败的投递。
密钥和限额
账户所有者使用通行密钥创建密钥,选择权限和 30 至 365 天的有效期。每个密钥每分钟最多 120 次请求;撤销后立即失效。
Partner API
为基于 Valtora 构建业务的企业提供银行、商户服务以及加密货币和外汇模块,包括货币兑换、付款和加密货币提现。在我们审核后为每位客户单独开通。
两次调用完成一笔付款
先获取报价,再按报价付款。金额为最小货币单位的字符串,每个创建类调用都需要幂等键。
1. 获取付款方式
curl https://valtorapro.com/api/v1/payments/quotes \
-H "Authorization: Bearer vt_live_…" \
-H "Content-Type: application/json" \
-d '{"beneficiary_id": "5b2f…", "amount": "125000"}'2. 按报价付款
curl https://valtorapro.com/api/v1/payments \
-H "Authorization: Bearer vt_live_…" \
-H "Idempotency-Key: inv-2041" \
-H "Content-Type: application/json" \
-d '{"quote_id": "9a8b…", "reference": "INV-2041"}'适用对象
01
财务和 ERP
将余额导入账簿,并从会计系统创建供应商付款;由您的审批人在应用中放行。
02
电商平台和平台业务
从您自己的后台向卖家和合作伙伴付款,并通过 Webhook 获知每笔付款的状态。
03
资金管理
无需登录,即可在您的资金管理工具中跟踪余额和付款状态。
常见问题
谁可以使用 API?
企业账户。账户所有者在开发者页面使用通行密钥创建密钥。
API 密钥能单独转出资金吗?
不能。通过 API 发起的每笔付款都需要审批人在应用中使用通行密钥批准,您的审批门槛和限额同样适用。
可以通过 API 兑换货币、付款或提取加密货币吗?
可以,通过 Partner API。在我们审核后为每位客户单独开通。
API 参考文档在哪里?
OpenAPI 文件公开,可通过本页链接访问。登录后的客户也可在开发者页面找到参考文档。