跳转到主要内容
PayLoco 提供了一套完整的 API,帮助您处理和管理支付业务。我们的 API 采用 HTTP Body 中的 JSON 格式进行收发,并返回标准 HTTP 响应码。您可以使用任意 HTTP/REST 库直接调用这些 API。

发起支付

通过多种测试场景探索灵活的支付接口

退款

使用 API 对已完成的支付发起退款

预授权

安全保存客户支付方式,用于后续交易

撤销

对已授权的交易发起撤销操作

环境说明

我们提供 沙箱(Sandbox) 测试环境,您可以在不影响生产数据的情况下测试 API 调用。请在 Dashboard 上注册以获取 API 密钥。

鉴权与 API 密钥

PayLoco 使用账户的 API 密钥对请求进行鉴权。每个账户有两种密钥:
密钥类型示例使用场景
密钥(API-key)snd_c69***用于从商户服务端鉴权 API 请求,请勿在前端或移动端暴露此密钥
公钥pk_snd_3b3***用于在客户端(Web/移动端)鉴权 API 请求,可公开使用

支付状态生命周期

支付状态说明
requires_payment_method创建支付后未绑定支付方式时的初始状态
requires_confirmation绑定支付方式后,等待确认
requires_customer_action确认后需要额外身份验证
requires_capture手动捕获模式下,客户操作成功后的状态
processing自动捕获模式下,正在处理中
succeeded支付处理成功
failed支付处理失败
expired支付对象已过期