跳转到主要内容
当智利付款人需要使用银行卡支付 CLP 时使用此通道。您的服务器创建 payin,CBPay 返回托管的 payment_url。请在弹窗或重定向中打开它。卡 数据留在托管字段中;发卡行要求时,3-D Secure 在结账模态框内完成。

创建 payin

idempotency_key 必须放在 body 或 Idempotency-Key header 中。CLP 必须是整数;"150000.50" 返回 400 invalid_amount。使用相同 key 重放 会返回原 payin,并带有 idempotency_hit: true;结果不明确时不要创建 新 key。

托管结账与已保存卡

在弹窗中打开 payment_url。结账页仅在 CL/CLP/card 下显示等待模态框, 提交前校验整数 CLP,并以状态指示器显示可用性。保存卡需要集成方提出 保存选项并取得付款人同意。之后的 one-click 和 MIT 扣款通过服务器端 已保存卡接口完成;PAN 不会发送到您的服务器。 通用 checkout 只有在目录报告可用时才会报价 CL/CLP/card。显示该选项 前请读取 GET /platform/v1/payins/methods。

查询、撤销和退款

结算前可以撤销已授权付款。退款是半自动的:创建后可能为 pending, 由签名通知完成。两者都要求幂等性;不明确的发送不会自动重试。

错误

Webhook

处理前必须验证签名。相关事件为 payin_credited、payin_refunded、 dispute 和 card_stored。

常见问题

不可以。智利比索没有小数单位,请发送整数字符串。
读取资源,或使用相同幂等 key 重复请求。不要发送新的扣款。
在签名通知确认前,退款可能保持 pending。
最后修改于 2026年11月5日