> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Estado de la transacción y códigos de error

Esta sección detalla los formatos de respuesta de la API, los códigos de estado HTTP y una referencia completa de todos los códigos de estado y error de las transacciones que utiliza la API de Localpayment. Dominar estos patrones y códigos de respuesta es fundamental para crear integraciones sólidas, realizar un seguimiento preciso del ciclo de vida de las transacciones, gestionar diversos escenarios y proporcionar información clara al usuario.

Las respuestas de la API de Localpayment proporcionan indicadores claros del resultado de las solicitudes mediante códigos de estado HTTP y objetos de estado estructurados. Si bien las estructuras de respuesta pueden variar según el endpoint, siempre incluyen información clave para un procesamiento adecuado.

> [card] Códigos de estado HTTP
>
> Códigos de estado HTTP estándar que indican si la solicitud fue exitosa o fallida.

> [card] Objetos de estado
>
> Información detallada sobre el estado de los resultados de las transacciones.

> [card] Manejo claro de errores
>
> Información de error estructurada para la depuración y resolución.

***

## Códigos de estado HTTP

La API utiliza códigos de estado HTTP estándar para indicar el resultado de las solicitudes a nivel de protocolo. Estos códigos proporcionan la primera indicación de si la solicitud se realizó correctamente.

### Códigos de éxito (2xx)

| Código de estado | Descripción | Casos de uso típicos |
| - | - | - |
| 200 OK | Solicitud exitosa | Solicitudes GET, operaciones exitosas, recuperación de datos |
| 201 Creado | Recurso creado con éxito | Nuevos pagos, cuentas virtuales, payouts |

### Errores del cliente (4xx)

| Código de estado | Descripción | Causas comunes |
| - | - | - |
| 400 Solicitud incorrecta | Solicitud con formato incorrecto o parámetros no válidos | Faltan campos obligatorios, formatos de datos no válidos, errores de validación. |
| 401 No autorizado | Autenticación requerida o inválida | Token de acceso faltante/no válido, tokens caducados, credenciales no válidas |
| 403 Prohibido | Permisos insuficientes | Dirección IP no incluida en la lista blanca, restricciones de cuenta, acceso no autorizado |
| 404 No encontrado | Recurso no encontrado | Identificadores de transacción no válidos, endpoints incorrectos, recursos eliminados |
| 429 Demasiadas peticiones | Se ha superado el límite de velocidad. | Demasiadas llamadas a la API en un corto período, se superó la cuota. |

### Errores del servidor (5xx)

| Código de estado | Descripción | Acción recomendada |
| - | - | - |
| Error interno del servidor 500 | Error inesperado del servidor | Inténtalo de nuevo con retroceso exponencial; ponte en contacto con el soporte técnico si persiste. |
| 502 Puerta de enlace no válida | Servicio de subida no disponible | Inténtalo de nuevo tras una breve demora, comprueba el estado del sistema. |
| 503 Servicio no disponible | Interrupción temporal del servicio | Consulta la página de estado, inténtalo de nuevo más tarde, activa el interruptor automático. |

***

## Objeto de estado

El objeto `status` proporciona información detallada y específica de Localpayment sobre los resultados de las transacciones y se incluye en la mayoría de las respuestas de la API relacionadas con operaciones financieras.

### Estructura del objeto de estado

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "status": {
    "code": "103",
    "description": "APPROVED",
    "detail": "The payin was confirmed but not credited yet"
  }
}
```

### Campos del objeto de estado

| Campo | Tipo | Descripción | Ejemplo |
| - | - | - | - |
| `code` | string | Código de estado específico de Localpayment | `103`, `200`, `701` |
| `description` | string | Resumen de estado legible para humanos | `Approved`, "Completed", "Rejected" |
| `detail` | string | Contexto o explicación adicional | `The payin is pending the confirmation` |

***

## Patrones de respuesta comunes

### Respuesta de pago exitosa

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "transactionType": "PayIn",
  "externalId": "40bac59a-0381-4cc0-a6a5-33418d84c2e4",
  "internalId": "dd616d71-f5cd-4bb5-9c2c-f421241ab301",
  "paymentMethod": {
    "type": "BankTransfer",
    "code": "1099",
    "flow": "DIRECT"
  },
  "country": "ARG",
  "currency": "ARS",
  "amount": 2300,
  "accountNumber": "{{accountNumber}}",
  "confirmed": {
    "currency": "ARS",
    "amount": 2300,
    "fxQuote": 1
  },
  "payment": {
    "currency": "ARS",
    "fxQuote": 1,
    "financingFee": 0,
    "amount": 2300
  },
  "localTaxes": [],
  "withHoldings": [],
  "fees": {
    "description": "Fee",
    "currency": "USD",
    "fxSource": 1,
    "fxQuote": 1020.72259627,
    "amount": 0.6,
    "account": "{{accountNumber}}"
  },
  "status": {
    "code": "103",
    "description": "APPROVED",
    "detail": "The payin was confirmed but not credited yet"
  },
  "merchant": {
    "type": "COMPANY",
    "name": "LTDA",
    "document": {
      "type": "CUIL",
      "id": "30-31.145.201-7"
    },
    "email": "email@email.com",
    "phone": {
      "countryCode": "countryCode",
      "areaCode": "11",
      "number": "98789632"
    },
    "address": {
      "street": "Street",
      "number": "938",
      "city": "City",
      "state": "state",
      "country": "Argentina",
      "zipCode": "1688",
      "comment": "port 801"
    },
    "birthdate": "2000-01-01",
    "nationality": "nationality"
  },
  "payer": {
    "bank": {
      "name": "Bank Name",
      "code": "191",
      "account": {
        "type": "S",
        "number": "1910119655111901676653"
      }
    },
    "type": "INDIVIDUAL",
    "name": "Prueba",
    "lastname": "Test",
    "document": {
      "type": "CUIT",
      "id": "20276201078"
    },
    "email": "email@email.com",
    "phone": {
      "countryCode": "1",
      "areaCode": "11",
      "number": "98789632"
    },
    "address": {
      "street": "Street",
      "number": "1234",
      "city": "City",
      "state": "state",
      "country": "Country",
      "zipCode": "1686",
      "comment": "May the force be with you, always!"
    },
    "birthdate": "01/01/1990",
    "nationality": "American"
  },
  "intermediaries": [],
  "wireInstructions": {
    "beneficiary": {
      "bank": {
        "name": "BANCO MACRO S.A.",
        "code": "0118",
        "branch": {},
        "account": {
          "type": "S",
          "number": "2850328631194198460271"
        }
      },
      "type": "INDIVIDUAL",
      "name": "LOCALPAYMENT S.R.L.",
      "document": {
        "type": "CUIT",
        "id": "30716132028"
      }
    },
    "referenceCode": "1022000084"
  },
  "date": {
    "creationDate": "2024-12-30T18:50:10.124+00:00",
    "processedDate": "2024-12-30T18:50:10.6159529",
    "expirationDate": "2025-01-06T18:50:10.5803114"
  },
  "errors": []
}
```

### Patrón de respuesta de error

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "externalId": "8c0b537a-e907-4d87-93db-5dab9807e093",
  "internalId": "dddfde6c-b61c-4b0e-8916-d88886133c4d",
  "status": {
    "code": "701",
    "description": "REJECTED"
  },
  "errors": [
    {
      "code": "701",
      "detail": "Invalid bank account number. Account number verification failed."
    }
  ]
}
```

***

## Guía de estado y errores de las transacciones

Selecciona a continuación un tipo de transacción específico para obtener una lista detallada de sus estados y códigos de error.

> [card] [Payin](https://docs.localpayment.com/es/reference/payin-status-error-codes.md)
>
> Códigos de estado y de error para la recepción de fondos a través de cuentas virtuales, Columns cols=2 y APM.

> [card] [Payout](https://docs.localpayment.com/es/reference/payout-status-error-codes.md)
>
> Códigos de estado y de error para el envío de fondos a los beneficiarios.

> [card] [Reembolso](https://docs.localpayment.com/es/reference/refund-status-error-codes.md)
>
> Códigos de estado y de error para la devolución de fondos a un cliente.

> [card] [Chargeback](https://docs.localpayment.com/es/reference/chargeback-status-error-codes.md)
>
> Códigos de estado y de error para transacciones disputadas y reversiones forzadas.

> [card] [Devolver](https://docs.localpayment.com/es/reference/return-status-error-codes.md)
>
> Códigos de estado y de error para pagos devueltos y liquidaciones fallidas.

> [card] [Recall](https://docs.localpayment.com/es/reference/recall-status-error-codes.md)
>
> Códigos de estado y de error para las cancelaciones y reversiones de pagos.

> [card] [Crédito](https://docs.localpayment.com/es/reference/credit-status-error-codes.md)
>
> Códigos de estado y de error para transacciones y ajustes de crédito.

> [card] [Débito](https://docs.localpayment.com/es/reference/debit-status-error-codes.md)
>
> Códigos de estado y de error para transacciones de débito y deducciones de fondos.

> [card] [Suscripciones](https://docs.localpayment.com/es/reference/subscriptions-status-error-codes.md)
>
> Códigos de estado y de error para la facturación recurrente y los ciclos de vida de las suscripciones.

> [card] [Cambio de divisas](https://docs.localpayment.com/es/reference/currency-exchange-status-error-codes.md)
>
> Códigos de estado y de error para transacciones de cambio de divisas.

> [card] [Wire In](https://docs.localpayment.com/es/reference/wire-in-status-error-codes.md)
>
> Códigos de estado y de error para las transferencias bancarias entrantes.

> [card] [Wire Out](https://docs.localpayment.com/es/reference/wire-out-status-error-codes.md)
>
> Códigos de estado y de error para transferencias bancarias salientes.

> [card] [Gastos](https://docs.localpayment.com/es/reference/expenses-status-error-codes.md)
>
> Códigos de estado y de error para deducciones de tarifas y transacciones de gastos.

> [card] [Cuota recurrente](https://docs.localpayment.com/es/reference/recurring-fee-status-error-codes.md)
>
> Códigos de estado y de error para los cargos periódicos.

***

## Recursos relacionados

> [card] [Guía de webhooks](https://docs.localpayment.com/es/docs/webhooks.md)
>
> Aprende cómo recibir actualizaciones de estado en tiempo real.

> [card] [Manejo de errores](https://docs.localpayment.com/es/docs/error-handling.md)
>
> Guía para gestionar transacciones fallidas

> [card] [Soporte](mailto:support@localpayment.com)
>
> Obtén ayuda con problemas de estado específicos.

> [!NOTE]
>
> **Consejo profesional**
>
> Implementa un sistema de registro exhaustivo que capture tanto los códigos de estado como los códigos de error con marcas de tiempo. Esto crea registros de auditoría claros para cumplir con los requisitos y agiliza considerablemente la depuración de problemas. Incluye la respuesta de error completa en los registros, no solo el código de error.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.