Paiements

TOKEN="eyJhbGci..."

# Créer une intention de paiement (Viva ISV par défaut)
curl -X POST https://api.qualiforma.site/api/v1/payments/intent \
  -H "Authorization: Bearer $TOKEN" \
  -H 'X-Tenant-ID: votre-tenant' \
  -H 'Content-Type: application/json' \
  -d '{
    "courseId": "crs_abc123",
    "userId": "usr_xyz789",
    "gateway": "VIVA_ISV",
    "successUrl": "https://votre-app.com/success",
    "cancelUrl": "https://votre-app.com/cancel"
  }'

# Réponse :
# {
#   "data": {
#     "paymentId": "pay_ghi012",
#     "redirectUrl": "https://www.vivapayments.com/web/checkout?ref=...",
#     "expiresAt": "2026-01-01T13:00:00Z"
#   }
# }

interface CreatePaymentIntentInput {
  courseId: string;
  userId: string;
  gateway: 'VIVA_ISV' | 'STRIPE';
  successUrl: string;
  cancelUrl: string;
}

interface PaymentIntent {
  paymentId: string;
  redirectUrl: string;
  expiresAt: string;
}

async function createPaymentIntent(
  input: CreatePaymentIntentInput,
  accessToken: string,
  tenantId: string,
): Promise<PaymentIntent> {
  const response = await fetch('https://api.qualiforma.site/api/v1/payments/intent', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      Authorization: `Bearer ${accessToken}`,
      'X-Tenant-ID': tenantId,
    },
    body: JSON.stringify(input),
  });

  if (!response.ok) {
    throw new Error(`Erreur ${response.status}`);
  }
  const { data } = await response.json();
  return data;
}

<?php
use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client(['base_uri' => 'https://api.qualiforma.site/api/v1/']);

try {
    // Creer une intention de paiement (Viva ISV par defaut)
    $response = $client->post('payments/intent', [
        'headers' => [
            'Authorization' => 'Bearer ' . $accessToken,
            'X-Tenant-ID' => 'votre-tenant',
            'Content-Type' => 'application/json',
        ],
        'json' => [
            'courseId' => 'crs_abc123',
            'userId' => 'usr_xyz789',
            'gateway' => 'VIVA_ISV', // VIVA_ISV | STRIPE
            'successUrl' => 'https://votre-app.com/success',
            'cancelUrl' => 'https://votre-app.com/cancel',
        ],
    ]);
    $intent = json_decode($response->getBody()->getContents(), true)['data'];
    echo "Paiement {$intent['paymentId']} - rediriger vers {$intent['redirectUrl']}\n";
} catch (GuzzleException $e) {
    fwrite(STDERR, "Erreur: " . $e->getMessage() . PHP_EOL);
}

TOKEN="eyJhbGci..."
PAYMENT_ID="pay_ghi012"

# Remboursement partiel (5000 centimes = 50 €)
curl -X POST "https://api.qualiforma.site/api/v1/payments/$PAYMENT_ID/refund" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'X-Tenant-ID: votre-tenant' \
  -H 'Content-Type: application/json' \
  -d '{"amount": 5000}'

# Remboursement total (omettre amount)
curl -X POST "https://api.qualiforma.site/api/v1/payments/$PAYMENT_ID/refund" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'X-Tenant-ID: votre-tenant' \
  -H 'Content-Type: application/json' \
  -d '{}'

async function refundPayment(
  paymentId: string,
  accessToken: string,
  tenantId: string,
  amount?: number, // centimes — omettre pour remboursement total
) {
  const response = await fetch(
    `https://api.qualiforma.site/api/v1/payments/${paymentId}/refund`,
    {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        Authorization: `Bearer ${accessToken}`,
        'X-Tenant-ID': tenantId,
      },
      body: JSON.stringify(amount !== undefined ? { amount } : {}),
    },
  );
  if (!response.ok) {
    throw new Error(`Erreur ${response.status}`);
  }
  const { data } = await response.json();
  return data; // Refund avec status = 'PENDING' | 'COMPLETED'
}

<?php
use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client(['base_uri' => 'https://api.qualiforma.site/api/v1/']);
$paymentId = 'pay_ghi012';

try {
    // Remboursement partiel (5000 centimes = 50 EUR)
    $response = $client->post("payments/{$paymentId}/refund", [
        'headers' => [
            'Authorization' => 'Bearer ' . $accessToken,
            'X-Tenant-ID' => 'votre-tenant',
            'Content-Type' => 'application/json',
        ],
        'json' => ['amount' => 5000],
    ]);
    $refund = json_decode($response->getBody()->getContents(), true)['data'];
    echo "Remboursement {$refund['id']} - statut : {$refund['status']}\n";

    // Remboursement total (omettre amount)
    $client->post("payments/{$paymentId}/refund", [
        'headers' => [
            'Authorization' => 'Bearer ' . $accessToken,
            'X-Tenant-ID' => 'votre-tenant',
            'Content-Type' => 'application/json',
        ],
        'json' => new \stdClass(), // {} JSON object vide
    ]);
} catch (GuzzleException $e) {
    fwrite(STDERR, "Erreur: " . $e->getMessage() . PHP_EOL);
}