Credit Card Statement
Detailed documentation of the credit card statement data structure
Credit Card Statement with credit limits, billed amounts, and transaction details.
Document type code: cartola_tc
Response Structure
{
"data": {
"extractedData": {
"titular": "Juan Pérez",
"numero_tarjeta": "XXXX-XXXX-XXXX-1234",
"fecha_estado_cuenta": "2023-12-01T00:00:00Z",
"monto_total_facturado": 125000,
"tipo_cartola": "nacional",
"moneda": "CLP",
"cupo_disponible": 1500000,
"cupo_utilizado": 500000,
"cupo_total": 2000000,
"saldo_periodo_anterior": 75000,
"transacciones": [
{
"fecha": "2023-11-15T00:00:00Z",
"descripcion": "SUPERMERCADO XYZ",
"monto_mensual": 45000,
"compra_en_cuotas": true,
"numero_cuota": 2,
"total_cuotas": 6,
"monto_total": 270000
},
{
"fecha": "2023-11-20T00:00:00Z",
"descripcion": "FARMACIA ABC",
"monto_mensual": 15000,
"compra_en_cuotas": false,
"numero_cuota": null,
"total_cuotas": null,
"monto_total": null
},
{
"fecha": "2023-11-25T00:00:00Z",
"descripcion": "PAGO POR INTERNET",
"monto_mensual": -75000,
"compra_en_cuotas": false,
"numero_cuota": null,
"total_cuotas": null,
"monto_total": null
}
]
}
}
}Main Fields
| Field | Type | Description |
|---|---|---|
titular | String | Cardholder's name |
numero_tarjeta | String | Masked card number format |
fecha_estado_cuenta | String (date-time) | Statement date |
monto_total_facturado | Number | Total billed amount |
tipo_cartola | String (enum) | Indicates if it is national or international |
moneda | String (enum) | CLP for national statements, USD for international ones |
cupo_disponible | Number | Available credit limit |
cupo_utilizado | Number | Used credit limit |
cupo_total | Number | Total credit limit |
saldo_periodo_anterior | Number (nullable) | Previous period balance, may also appear as final owed balance from previous period, previous billed balance, etc. Note that in some statements the Previous Period Starting Owed Balance appears, but for you it's always important to find the Final one, which may be called Final Owed Balance from Previous Period |
monto_total_facturado_periodo_anterior | Number | Total billed amount from previous period |
Transaction Fields
| Field | Type | Description |
|---|---|---|
fecha | String (date-time) | Transaction date |
descripcion | String | Transaction description |
monto_mensual | Number | Monthly amount to pay for the transaction |
compra_en_cuotas | Boolean | Indicates if it's an installment purchase |
numero_cuota | Number (nullable) | Current installment number to pay in the month, only for installment purchases |
total_cuotas | Number (nullable) | Total number of installments, only for installment purchases |
monto_total | Number (nullable) | Total transaction amount, only for installment purchases |
Important considerations
- The transaction list may include entries with names like PAID AMOUNT or INTERNET PAYMENT, which have negative amounts, but should also be included
- National statements use CLP currency and international statements use USD
- Installment transactions show the detail of each installment and the original total amount
- Important to verify the statement date for the correct period
- Credit card statement with complete information about limits and transactions