> ## 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.

# Aprobaciones y doble firma

Algunas transacciones de pago requieren autorización adicional antes de poder procesarse. Esta guía explica cuándo se necesita autorización y cómo aprobar los pagos mediante diferentes métodos.

## Cuando se requiere autorización

Se requiere autorización adicional para los pagos generados bajo estas condiciones:

* **Payouts por API**: Creados mediante la API con el parámetro `requireAuth` establecido en `true`.
* **Payouts del Business Portal**: Creados directamente en el Business Portal de Localpayment.

### Métodos de autorización

El método para autorizar los pagos depende de cómo se crearon originalmente:

**Payouts creados en el Business Portal**

Para los payouts creados en el [Business Portal](https://docs.localpayment.com/es/docs/dashboard-review-payout.md), debe autorizarlos un segundo usuario con permisos de autorización.

**Pagos generados por API**

Para los pagos creados a través de la API, utiliza el endpoint [Authorize Payout](https://docs.localpayment.com/es/reference/authorize-payout.md) para aprobar las transacciones mediante programación.

***

## Requisitos previos

Antes de autorizar los pagos, asegúrate de tener:

* Una **transacción de payout inicializada** con estado `PendingAuth`
* Credenciales API válidas con permisos de autorización
* El identificador de la transacción (`internalId` o `externalId`) o un rango de fechas para la autorización masiva

***

## Autorización de pagos mediante API

### Endpoint

```http theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
POST https://api.stage.localpayment.com/api/payout/authorize
```

### Autenticación

Incluye tu token de acceso en los encabezados de la solicitud:

```http theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
Authorization: Bearer <your_access_token>
```

### Parámetros clave de la solicitud

Puedes autorizar los pagos utilizando uno de estos tres métodos:

| Parámetro | Tipo | Descripción | Requerido |
| - | - | - | - |
| `internalId` | string | Identificador único de transacción de Localpayment | ✅ (Opción 1) |
| `externalId` | string | Identificador único de transacción de tu sistema | ✅ (Opción 2) |
| `dateFrom` | string | Fecha de inicio para la autorización masiva (AAAA-MM-DD) | ✅ (Opción 3) |
| `dateTo` | string | Fecha límite para la autorización masiva (AAAA-MM-DD) | ✅ (Opción 3) |

> [!NOTE]
>
> **Elige un método de autorización**
>
> Utiliza un ID de transacción específico (`internalId` o `externalId`) para transacciones individuales, o un rango de fechas (`dateFrom` y `dateTo`) para la autorización masiva.

### Ejemplos de solicitudes

> [tab] Transacción única (ID externo)
>
> ```curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> curl --request POST \
>      --url https://api.stage.localpayment.com/api/payout/authorize \
>      --header 'Authorization: Bearer <your_access_token>' \
>      --header 'Content-Type: application/json' \
>      --data '{
>        "externalId": "1939b376-2aed-4c7a-bc2b-1157702f00b0"
>      }'
> ```

> [tab] Transacción única (ID interno)
>
> ```curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> curl --request POST \
>      --url https://api.stage.localpayment.com/api/payout/authorize \
>      --header 'Authorization: Bearer <your_access_token>' \
>      --header 'Content-Type: application/json' \
>      --data '{
>        "internalId": "7d7f7fca-e411-4ba6-b4f5-b9fed4d5f3d2"
>      }'
> ```

> [tab] Autorización masiva (rango de fechas)
>
> ```curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> curl --request POST \
>      --url https://api.stage.localpayment.com/api/payout/authorize \
>      --header 'Authorization: Bearer <your_access_token>' \
>      --header 'Content-Type: application/json' \
>      --data '{
>        "dateFrom": "2024-01-01",
>        "dateTo": "2024-01-31"
>      }'
> ```

***

## Gestión de respuestas

### Respuesta de éxito

Cuando la autorización sea exitosa, recibirás:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "status": 200,
  "message": "The request will be processed."
}
```

#### Campos de respuesta clave

| Campo | Tipo | Descripción |
| - | - | - |
| `status` | integer | Código de estado HTTP (200 para éxito) |
| `message` | string | Mensaje de confirmación que indica que la solicitud está siendo procesada. |

### Respuestas de error

#### Errores de validación

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "errors": {
    "externalId": [
      "The externalId field is required."
    ]
  },
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "traceId": "00-6af59d173e66ad4eb215987cd15d57af-bea3981476c0f347-00"
}
```

## Mejores prácticas

* Siempre valida los detalles de la transacción antes de autorizarla.
* Utiliza HTTPS para todas las solicitudes a la API
* Almacena los tokens de acceso de forma segura.
* Implementa un manejo de errores y un registro adecuados

### Flujo de trabajo recomendado

1. **Crear Payout**: Genera el payout con `requireAuth=true`
2. **Verificar el estado**: Confirma que el estado de la transacción es `PendingAuth`
3. **Detalles de la revisión**: Validar la información de la transacción
4. **Autorizar**: Llamar al endpoint de autorización
5. **Manejo de respuestas**: Procesar las respuestas de éxito/error de forma adecuada.
6. **Monitorización**: Seguimiento de los cambios de estado de las transacciones mediante webhooks.

***

## Recursos y próximos pasos

Maximiza el éxito de tu integración con estos recursos esenciales.

> [card] [Integración de webhooks](https://docs.localpayment.com/es/docs/webhooks.md)
>
> Configura notificaciones en tiempo real para las actualizaciones del estado de las transacciones.

> [card] [Portal de informes empresariales](https://docs.localpayment.com/es/docs/balance-report.md)
>
> Accede a análisis detallados, herramientas de generación de informes y funciones de conciliación.

> [card] [Monitoreo de transacciones](https://docs.localpayment.com/es/reference/transaction-status-error-codes)
>
> Aprende a consultar el estado de las transacciones e implementar un seguimiento exhaustivo.

> [card] [Referencia de la API](https://docs.localpayment.com/es/reference/exchange-bulk.md)
>
> Documentación completa del endpoint con ejemplos interactivos.

> [!NOTE]
>
> **Consejo profesional**
>
> Siempre prueba tu flujo de trabajo en nuestro entorno de pruebas antes de implementarlo en producción. Esto garantiza que el manejo de errores, el procesamiento de webhooks y el seguimiento del estado funcionen correctamente en todos los escenarios.

***

> [!NOTE]
>
> **¿Necesitas ayuda?**
>
> Ponte en contacto con nuestro [equipo de soporte](mailto:support@localpayment.com) si experimentas algún problema o necesitas ayuda con la integración.


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