Payments API

Overview

Sistema de pagos integrado con Stripe para procesar inversiones en proyectos I+D+i. Incluye reservas de pago, liberación de fondos, y webhooks para eventos de Stripe.

Base Path

/api/payments

Payment Flow

1. Inversor acepta oferta
2. Sistema crea Payment Intent en Stripe
3. Inversor completa pago (tarjeta, transferencia, etc.)
4. Fondos se reservan en cuenta Stripe Connect
5. Al cumplir condiciones, fondos se liberan a empresa

Endpoints Principales

POST /api/payments/reservation

Crear reserva de pago con Stripe.

{
  "offerId": "off_789",
  "amount": 50000,
  "currency": "EUR",
  "paymentMethodId": "pm_1234567890"
}

Response 201

{
  "success": true,
  "data": {
    "id": "pay_123",
    "stripePaymentIntentId": "pi_1234567890",
    "amount": 50000,
    "status": "reserved",
    "clientSecret": "pi_1234567890_secret_abc",
    "createdAt": "2025-01-03T14:00:00Z"
  }
}

POST /api/payments/release-to-investigator

Liberar fondos reservados a la empresa (después de firma de contrato).

{
  "paymentId": "pay_123",
  "offerId": "off_789",
  "contractId": "ctr_456"
}

Response 200

{
  "success": true,
  "data": {
    "id": "pay_123",
    "status": "released",
    "releasedAmount": 50000,
    "releasedAt": "2025-01-04T10:00:00Z",
    "stripeTransferId": "tr_1234567890"
  }
}

Stripe Integration

Stripe Connect

64bis.eus usa Stripe Connect para manejar pagos entre inversores y empresas:

• Platform Account: 64bis.eus (comisión 5.25%)
• Connected Accounts: Empresas receptoras de fondos

Payment Intent Lifecycle

1. requires_payment_method - Esperando método de pago
2. requires_confirmation - Esperando confirmación
3. processing - Procesando pago
4. succeeded - Pago exitoso, fondos reservados
5. released - Fondos liberados a empresa

Webhooks

Stripe envía webhooks a /api/payments/webhook para eventos:

• payment_intent.succeeded - Pago completado
• payment_intent.payment_failed - Pago falló
• transfer.created - Transferencia creada
• transfer.paid - Transferencia completada

Security

Todos los webhooks de Stripe se verifican con stripe.webhooks.constructEventusando el webhook secret de Stripe.

Comisión 5.25%

La plataforma retiene automáticamente 5.25% en cada transacción:

const platformFee = amount * 0.0525;
const companyAmount = amount - platformFee;

// Transfer a empresa
stripe.transfers.create({
  amount: companyAmount,
  currency: 'EUR',
  destination: companyStripeAccountId,
  source_transaction: paymentIntent.latest_charge
});

Próximos Pasos

• Offers API - Sistema de ofertas
• Stripe Integration Guide