Intégration YouSign

# API YouSign
YOUSIGN_API_KEY=your_api_key_here
YOUSIGN_API_URL=https://api.yousign.app/v3
YOUSIGN_WEBHOOK_SECRET=your_webhook_secret

# URL de l'application
HOST=save-france.fr

/**
 * Crée une demande de signature YouSign
 * 
 * @param Contract $contract Le contrat à faire signer
 * @return array ['signId' => string, 'signUrl' => string]
 * @throws \Exception Si la création échoue
 */
public function createSignature(Contract $contract): array

$result = $youSignService->createSignature($contract);
// ['signId' => '123e4567-e89b...', 'signUrl' => 'https://yousign.app/procedure/...']

$contract->setSignId($result['signId']);
$contract->setSignUrl($result['signUrl']);

/**
 * Télécharge le document signé
 * 
 * @param string $signRequestId ID de la signature request
 * @return string Contenu binaire du PDF
 * @throws \Exception Si le téléchargement échoue
 */
public function downloadDocument(string $signRequestId): string

$pdfContent = $yousignService->downloadDocument($contract->getSignId());
file_put_contents(Contract::PDF_DIRECTORY . '/' . $contract->getId() . '.pdf', $pdfContent);

/**
 * Récupère le statut d'une signature depuis l'API YouSign
 * 
 * @param string $signRequestId ID de la signature request
 * @return array ['status' => string, 'signed_at' => ?string, 'signers' => array]
 * @throws \Exception Si la récupération échoue
 */
public function getSignatureStatus(string $signRequestId): array

try {
    $status = $yousignService->getSignatureStatus($contract->getSignId());
    
    if ($status['status'] === 'done') {
        // Traiter la signature complétée
        echo "Signé le : " . $status['signed_at'];
    }
} catch (\Exception $e) {
    // Signature introuvable ou erreur API
    $logger->error('Erreur vérification signature', ['error' => $e->getMessage()]);
}

private function verifySignature(string $payload, ?string $signature, string $secret): bool
{
    if (empty($signature)) {
        return false;
    }

    $digest = hash_hmac('sha256', $payload, $secret);
    $computedSignature = 'sha256=' . $digest;

    return hash_equals($signature, $computedSignature);
}

# Voir les messages en échec
docker compose exec api php bin/console messenger:failed:show

# Rejouer un message en échec
docker compose exec api php bin/console messenger:failed:retry

request:
  check_signature: "Vérifier l'état de la signature"
  check_signature_success: "La signature a été vérifiée et synchronisée..."
  check_signature_error:
    not_waiting_signature: "La demande n'est pas en attente de signature."
    contract_not_found: "Aucun contrat trouvé pour cette demande."
    no_sign_id: "Aucun ID de signature trouvé pour ce contrat."
    contract_expired: "Le contrat a expiré."
    payment_creation_failed: "Erreur lors de la création du paiement Stripe."
    signature_not_found: "Signature introuvable sur YouSign. Le contrat a été invalidé."
  check_signature_info:
    ongoing: "La signature est toujours en cours..."
    expired: "La demande de signature a expiré."
    status: "État de la signature: %status%"

$checkSignature = Action::new(self::ACTION_CHECK_SIGNATURE, 'request.check_signature')
    ->linkToRoute('app_check_signature_request', function (Request $request): array {
        return ['id' => $request->getId()];
    })
    ->displayIf(function (Request $request): bool {
        return $request->getStatus() === RequestStatusEnum::WAITING_SIGNATURE;
    })
    ->addCssClass('btn btn-warning')
;

# Rechercher les appels webhook dans les logs
docker-compose logs -f caddy | grep "webhook/contract-signed"

# Exemple de ligne de log attendue :
# {"level":"info","ts":1234567890,"msg":"POST /webhook/contract-signed","status":200}

# Logs de production
docker-compose exec api tail -f var/log/prod.log

# Logs de développement
docker-compose exec api tail -f var/log/dev.log

use Psr\Log\LoggerInterface;

public function __construct(
    private readonly LoggerInterface $logger,
    // ... autres dépendances
) {}

public function __invoke(Request $request, ...): Response
{
    $payload = $request->getContent();
    $signId = json_decode($payload, true)['data']['signature_request']['id'] ?? null;
    
    $this->logger->info('Webhook YouSign reçu', [
        'sign_id' => $signId,
        'ip' => $request->getClientIp(),
        'timestamp' => new \DateTime()
    ]);
    
    // ... traitement
}

# Exposer le serveur local
ngrok http 80

# Configurer l'URL webhook sur YouSign Dashboard
# https://abc123.ngrok.io/webhook/contract-signed

curl -X POST https://your-domain.com/webhook/contract-signed \
  -H "Content-Type: application/json" \
  -H "X-Yousign-Signature-256: sha256=your_signature" \
  -d '{
    "event_name": "signature_request.done",
    "data": {
      "signature_request": {
        "id": "123e4567-e89b-12d3-a456-426614174000"
      }
    }
  }'

// Commande exécutée quotidiennement
php bin/console app:contract:expire

// Marque les contrats expirés automatiquement
if ($contract->getExpiredAt() < new DateTime()) {
    $contract->setStatus(ContractStatusEnum::EXPIRED);
}

if ($request->getStatus() === RequestStatusEnum::WAITING_SIGNATURE) {
    // OK pour vérifier la signature
} else {
    // Ne pas traiter
}

// Vérification du statut actuel avant traitement
if ($request->getStatus() === RequestStatusEnum::WAITING_PAYMENT) {
    return new Response('', Response::HTTP_UNPROCESSABLE_ENTITY);
}

if ($request->getStatus() === RequestStatusEnum::COMPLETE) {
    return new Response('', Response::HTTP_UNPROCESSABLE_ENTITY);
}

$client = HttpClient::create([
    'timeout' => 30,
    'max_duration' => 60,
    'headers' => [
        'Authorization' => 'Bearer ' . $this->apiKey,
    ]
]);

// Définir les permissions correctes
$pdfPath = Contract::PDF_DIRECTORY . '/' . $contract->getId() . '.pdf';
file_put_contents($pdfPath, $pdfContent);
chmod($pdfPath, 0640); // Lecture seule pour le propriétaire et le groupe

// 1. Invalider l'ancien contrat
$oldContract->setStatus(ContractStatusEnum::EXPIRED);

// 2. Générer un nouveau contrat
$newContract = $contractService->generateContract($request);

// 3. Lancer la nouvelle signature
$signature = $yousignService->createSignature($newContract);
$newContract->setSignId($signature['signId']);
$newContract->setSignUrl($signature['signUrl']);