Notify Debited Funds

POST /savings-contracts/notify-debited-funds

Notifica sobre fondos que han sido debitados de múltiples contratos de ahorro en una sola operación bulk.

Endpoint

POST /savings-contracts/notify-debited-funds

Authentication

api-key: YOUR_API_KEY
Content-Type: application/json

Request Body

Campo	Tipo	Requerido	Descripción
contract_ids	array	✓	Array de IDs de contratos afectados

Ejemplo de solicitud

# Production
curl -X POST \
     -H "api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "contract_ids": [
         "contract_123",
         "contract_456",
         "contract_789"
       ]
     }' \
     "https://api.erolapp.com/api/v1/savings-contracts/notify-debited-funds"

# Staging
curl -X POST \
     -H "api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "contract_ids": [
         "contract_123",
         "contract_456",
         "contract_789"
       ]
     }' \
     "https://be-staging.erolapp.com/api/v1/savings-contracts/notify-debited-funds"

Response

Código de estado: 200 OK

{
  "success": true,
  "message": "Debited funds notifications processed successfully",
  "data": {
    "processed_contracts": 3,
    "contract_ids": [
      "contract_123",
      "contract_456",
      "contract_789"
    ],
    "processed_at": "2024-08-10T10:30:00Z"
  },
  "meta": {
    "timestamp": "2024-08-10T10:30:00Z",
    "request_id": "req_abc123"
  }
}

Casos de uso

• Notificación masiva cuando se procesan débitos automáticos
• Actualización de estado de múltiples contratos tras operaciones bancarias
• Sincronización de fondos debitados entre sistemas

Notas importantes

• Este endpoint procesa las notificaciones de forma asíncrona
• Todos los contract_ids deben existir y estar activos
• La respuesta 200 confirma que el proceso se inició correctamente
• El procesamiento real de las notificaciones puede tardar algunos minutos

Error Responses

Si hay errores en el procesamiento:

{
  "success": false,
  "error": {
    "code": "INVALID_CONTRACTS",
    "message": "Some contract IDs are invalid or inactive",
    "details": {
      "invalid_ids": ["contract_999"],
      "valid_count": 2,
      "invalid_count": 1
    }
  }
}