Saltar al contenido principal

Mostrar todos los reembolsos

Devuelve una lista de los reembolsos existentes. Stripe muestra los reembolsos en orden cronológico inverso, es decir, los más recientes aparecen en primer lugar. La respuesta incluye, por defecto, los 10 reembolsos más recientes.

GET https://api.stripe.com/v1/refunds

Ejemplos​

Ejemplo de cURL:

cURL
curl -X GET https://api.stripe.com/v1/refunds \
  -u <YOUR_SECRET_KEY>:

Respuestas​

Las respuestas devuelven códigos estándar.

200: OK

Response
{
  "object": "list",
  "url": "/v1/refunds",
  "has_more": false,
  "data": [
    {
      "id": "re_1Nispe2eZvKYlo2Cd31jOCgZ",
      "object": "refund",
      "amount": 212,
      "balance_transaction": "txn_1Nispe2eZvKYlo2CYezqFhEx",
      "charge": "ch_1NirD82eZvKYlo2CIvbtLWuY",
      "created": 1692942318,
      "currency": "usd",
      "destination_details": {
        "card": {
          "reference": "123456789012",
          "reference_status": "available",
          "reference_type": "acquirer_reference_number",
          "type": "refund"
        },
        "type": "card"
      },
      "metadata": {},
      "payment_intent": "pi_1GszsK2eZvKYlo2CfhZyoZLp",
      "reason": null,
      "receipt_number": null,
      "source_transfer_reversal": null,
      "status": "succeeded",
      "transfer_reversal": null
    }
  ]
}

Respuestas de error​

400: Bad Request

Response
{
    "error": {
        "code": "resource_missing",
        "doc_url": "https://stripe.com/docs/error-codes/resource-missing",
        "message": "No such charge: 'ch_1NirD82eZvKYlo2CIvbtLWuY'",
        "param": "charge",
        "request_log_url": "https://dashboard.stripe.com/test/logs/req_HIH2jWkJGecwCk?t=1754504399",
        "type": "invalid_request_error"
    }
}

401: Unauthorized

Response
{
  "error": {
    "type": "invalid_request_error",
    "message": "Invalid API Key provided: sk_test_********************1234"
  }
}

Parámetros​

Parámetros de consulta​
ParámetroTipoDescripción
chargecadenaID del cargo para el que se desean recuperar los reembolsos. Si se omite, Stripe devuelve todos los reembolsos de la cuenta.
createddiccionarioDevuelve únicamente los reembolsos creados durante los intervalos de fechas indicados. Puede tratarse de un diccionario con las siguientes claves: gt, gte, lt, lte.
ending_beforecadenaUn cursor para utilizar en la paginación. Utiliza el ID de objeto ending_before para definir tu posición en la lista. Si realizas una solicitud de lista y recibes 100 resultados, empezando por obj_bar, tu siguiente llamada puede incluir ending_before=obj_bar para recuperar la página anterior de la lista.
limitenteroLimita el número de registros en la respuesta. Introduce un número entero entre 1 y 100 (valor por defecto: 10).
payment_intentcadenaID del PaymentIntent del que se quieren recuperar los reembolsos. Si se omite, Stripe devuelve todos los reembolsos de la cuenta.
starting_aftercadenaUn cursor para utilizar en la paginación. Utiliza el ID de objeto starting_after para definir tu posición en la lista. Si realizas una solicitud de lista y recibes 100 resultados, que terminan en obj_foo, tu siguiente llamada puede incluir starting_after=obj_foo para recuperar la página siguiente de la lista.
expand[]matriz de cadenasIdentifica objetos de respuesta anidados para enriquecerlos y devolverlos en línea.