Consultar reembolsos de Mercado Pago

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "pagoId": {
      "description": "Trae sólo los reembolsos de ese pago (id de Mercado Pago, texto).",
      "type": "string",
      "pattern": "^[1-9][0-9]{0,30}$"
    },
    "cursor": {
      "description": "Puntero opaco a la página siguiente. Reenvía tal cual el 'cursor' que devolvió la llamada anterior; nunca lo construyas a mano. Omítelo para pedir la primera página.",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Cuántas filas trae la página, entre 1 y 500. Por omisión, 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "reembolsos": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "reembolsoId": {
            "type": "string",
            "description": "El id del reembolso en Mercado Pago, como texto."
          },
          "pagoId": {
            "type": "string",
            "description": "El id del pago en Mercado Pago, como texto: no lo conviertas a número."
          },
          "moneda": {
            "type": "string",
            "description": "La moneda del pago reembolsado (ISO 4217)."
          },
          "monto": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Lo reembolsado, en decimal como texto y en la moneda de 'moneda'. null cuando Mercado Pago no lo informó: null NO es cero."
          },
          "estado": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "El estado del reembolso según Mercado Pago ('approved'…). null si no vino."
          },
          "fechaCreacion": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cuándo se hizo el reembolso (ISO 8601, UTC). null si Mercado Pago no la informó."
          },
          "modo": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "El modo del reembolso según Mercado Pago ('standard'…). null si no vino."
          },
          "sincronizadoEn": {
            "type": "string",
            "description": "Cuándo guardó Connect este reembolso (ISO 8601)."
          }
        },
        "required": [
          "reembolsoId",
          "pagoId",
          "moneda",
          "monto",
          "estado",
          "fechaCreacion",
          "modo",
          "sincronizadoEn"
        ],
        "additionalProperties": false
      },
      "description": "Los reembolsos de los pagos recibidos, del más nuevo al más antiguo."
    },
    "cobertura": {
      "type": "object",
      "properties": {
        "desde": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Desde cuándo están guardados TODOS los pagos de la cuenta, según su fecha de última actualización (ISO 8601). null si nunca se sincronizó."
        },
        "hasta": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Hasta cuándo están guardados todos los pagos (ISO 8601). Lo posterior aún no se lee: no es saldo ni movimiento en tiempo real."
        },
        "completa": {
          "type": "boolean",
          "description": "true sólo si el histórico llegó al límite que permite Mercado Pago (los últimos 12 meses) y no quedó ninguna ventana sin leer. En false, una lista vacía o un total NO prueban que no haya pagos: dilo así."
        },
        "ventanasSinLeer": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "Cuántos tramos de tiempo no se pudieron leer completos (demasiados pagos o resultados inestables). Con alguno, 'completa' es false."
        },
        "sincronizadoEn": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Cuándo terminó la última sincronización que guardó datos (ISO 8601). null si nunca."
        }
      },
      "required": [
        "desde",
        "hasta",
        "completa",
        "ventanasSinLeer",
        "sincronizadoEn"
      ],
      "additionalProperties": false,
      "description": "Qué cubre lo guardado. Payments search NO es una cartola: no incluye retiros, transferencias, saldo ni movimientos que no sean pagos recibidos."
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Puntero a la página siguiente. Si viene distinto de null hay más filas: vuelve a llamar reenviándolo tal cual en 'cursor'. Un null significa que no queda nada por traer."
    }
  },
  "required": [
    "reembolsos",
    "cobertura",
    "cursor"
  ],
  "additionalProperties": false
}