获取退款汇总

GET

https://api.cobre.co/v1/refund/summary/{id}

按 rf_ ID 检索原始 payin 的退款汇总——该 payin 上所有退款尝试的累计总额（原始金额、已退金额、进行中尝试预留金额以及仍可退金额），以及各次尝试列表。

这与单次退款尝试（refund_entry，rfe_ 前缀，获取单个退款）不同：汇总是按 payin 的累计器，而尝试是针对该 payin 的一次退款请求。若某 payin 有多次退款尝试，此 endpoint 返回聚合视图；请按各自的 rfe_ ID 检索单次尝试。

退款功能仍在积极开发中——本指南中描述的部分功能可能尚未对您的账户开放。请联系您的 KAM（关键客户经理）了解当前上线状态。

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200OK

application/json

请求的退款汇总。

Bodyapplication/json

🟠404未找到

🟠401未授权

🟠403禁止访问

🟠429请求过多

🔴500内部服务器错误

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.cobre.co/v1/refund/summary/rf_xOBCRu3PPAby6E' \
--header 'Authorization: Bearer <token>'

Response Example

200 - OK

{
    "id": "rf_xOBCRu3PPAby6E",
    "object": "refund_summary",
    "livemode": true,
    "request_id": "req_asdasdfa123",
    "original_payin_id": "mm_xOBCRu3PPAby6E",
    "currency": "COP",
    "original_amount": 300,
    "refunded_amount": 200,
    "reserved_amount": 0,
    "refundable_amount": 100,
    "status": "partially_refunded",
    "refunds": [
        { "id": "rfe_nQ8vLm2KxP4wYz", "amount": 100, "status": "completed", "created_at": "2026-08-05T14:02:11Z" },
        { "id": "rfe_nQ8vLm2KxP1234", "amount": 100, "status": "completed", "created_at": "2026-08-05T14:02:11Z" }
    ]
}

Modified at 2026-10-08 22:46:36

获取单个退款

获取所有退款