La API de Depósitos esta diseñada para obtener la información referente a los depósitos realizados en los últimos 90 días. De la misma manera y con la información de los depósitos consultados se puede obtener un reporte detallado de sus transacciones.

El recurso Settlements

La siguiente tabla contiene los elementos de la estructura del objeto settlements:

{
  "settlements": [
    {
      "disbursement_date": "2020-01-13",
      "settlement_report_id": "W472RZQKV",
      "gross_amount": 9300,
      "total_fee": 360,
      "total_tax": 62.14,
      "total_retention": 388.38,
      "disbursed_net_amount": 8911.62,
      "total_transactions": 22,
      "links": {
        "self": {
          "href": "/settlements/W472RZQKV",
          "method": "GET"
        }
      }
    }
  ]
}

Elemento		Descripción	Tipo
settlements		Arreglo de objetos del tipo settlements	array
	disbursement_date	Fecha de pago	string
	settlement_report_id	ID del reporte de depósitos	string
	gross_amount	Cantidad total antes de impuestos	number
	total_fee	Cantidad total de comisión sobre la cantidad antes de impuestos	number
	total_tax	Cantidad de impuestos por IVA sobre la comisión	number
	total_retention	Cantidad total de comisión e impuestos a deducir	number
	disbursed_net_amount	Cantidad a depositar después de impuestos	number
	total_transactions	Total de transacciones que incluye el reporte	string
	links	Objeto de tipo links.	string

El recurso Settlement

La siguiente tabla contiene los elementos de la estructura del objeto settlement:

{
  "settlement": {
    "settlement_report_id": "W472RZQKV",
    "merchant_name": "Clip",
    "disbursement_date": "2020-01-13",
    "gross_amount": 9300,
    "disbursed_net_amount": 8911.62,
    "total_transactions": 22,
    "details": [
      {
        "date": "2020-01-10",
        "payments": [
          {
            "receipt_no": "liNzWOR",
            "payment_date": "2020-01-10",
            "amount": 100,
            "terms": null,
            "charges": {
              "charge": {
                "fee": 3.6,
                "tax": 0.58
              }
            },
            "tip": 0,
            "total_retention": 4.18,
            "settled_amount": 95.82,
            "payment_method": "Credit",
            "card": {
              "brand": "Mastercard",
              "last4": 4352,
              "issuer": "BANAMEX"
            },
            "merchant_invoice": null,
            "user_email": "[email protected]"
          }
        ]
      }
    ]
  },
  "links": {
    "next": {
      "href": "/settlements/GHWRWSFLW?page_size=1&page=eyJjb21wbZSJ9fX0=",
      "method": "GET"
    }
  }
}

Elemento						Descripción	Tipo
settlement						Objeto de tipo settlement	object
	settlement_report_id					ID del reporte de depósitos a detallar	string
	merchant_name					Nombre del comerciante	string
	disbursement_date					Fecha de pago	string
	gross_amount					Total antes de impuestos	number
	disbursed_net_amount					Cantidad a depositar después de impuestos	number
	total_transactions					Total de transacciones que contiene el reporte	string
	details					Arreglo de objetos con el esquema details	array
		date				Fecha del reporte	string
		payments				Arreglo de objetos con el esquema payment	array
			receipt_no			ID de la transacción	string
			payment _date			Fecha de creación del reporte	string
			amount			Monto de la transacción en pesos	float
			terms			Indica si el pago está diferido en mensualidades. Cuando el pago no está diferido, su valor es null. Mensualidades disponibles: 3, 6, 9 y 12	string
			charges			Objeto que contiene la información relacionada a los distintos cargos del pago	object
				charge		Objeto de tipo charge	object
					fee	Comisión en pesos	float
					tax	Cantidad de IVA	float
				surcharge		Objeto de tipo surcharge con información de la comisión por mensualidades. Se calcula con base en el valor del campo terms del objeto payments de esta respuesta. NOTA: este campo aún no está implementado, por lo que su valor es nulo.	object
			tip			Monto de la propina en pesos	float
			total_retention			Retención total en pesos	float
			settled_amount			Cantidad a depositar	float
			payment_method			Especifica la categoría de la forma de pago: DEBIT: la tarjeta es de débito CREDIT: la tarjeta es de crédito OTHER: la tarjeta no es de débito ni crédito, por ejemplo, tarjeta de vales	string
			card			Objeto que contiene detalles de la tarjeta utilizada.	object
				brand		Tipo de tarjeta utilizada para el pago	string
				last4		Últimos cuatro dígitos de la tarjeta utilizada para el pago	string
				issuer		Banco emisor de la tarjeta	string
			merchant_invoice			Número proporcionado por el merchant para referencia	string
			user_email			Correo electrónico del usuario de Clip	string
links						Objeto de tipo links	object