跳到主要内容

退款

处理 Pelago 支付的全额和部分退款。

创建退款​

const refund = await pelago.refunds.create({
  paymentId: 'pay_abc123',
  amount: 50.00,  // 部分退款（不填则全额退款）
  reason: 'customer_request'
});

退款原因​

原因描述
customer_request客户请求退款
duplicate重复支付
fraudulent疑似欺诈
order_canceled订单已取消

退款流程​

查询退款状态​

const refund = await pelago.refunds.retrieve('ref_xyz789');
console.log('状态:', refund.status);
// 'pending' | 'completed' | 'failed'

Webhook 事件​

{
  "type": "refund.completed",
  "data": {
    "refundId": "ref_xyz789",
    "paymentId": "pay_abc123",
    "amount": 50.00,
    "transactionHash": "abc..."
  }
}

退款限制​

  • 退款必须在 180 天内发起
  • 最大退款金额 = 原始支付金额
  • 网络手续费不可退还