Idempotencja

# pierwsze i powtórzone żądanie są identyczne; drugie wraca z Idempotent-Replayed: true
curl -i https://oplac.pl/api/v1/payments \
  -H "Authorization: Bearer sk_test_TWOJ_KLUCZ" \
  -H "Idempotency-Key: zamowienie-10482" \
  -H "Content-Type: application/json" \
  -d '{"amount": 12900, "currency": "PLN", "metadata": {"order_id": "10482"}}'

function utworzPlatnosc(array $dane, string $kluczIdempotencji): array
{
    for ($proba = 1; $proba <= 3; $proba++) {
        $ch = curl_init('https://oplac.pl/api/v1/payments');
        curl_setopt_array($ch, [
            CURLOPT_POST => true,
            CURLOPT_HTTPHEADER => [
                'Authorization: Bearer sk_test_TWOJ_KLUCZ',
                'Idempotency-Key: ' . $kluczIdempotencji,
                'Content-Type: application/json',
            ],
            CURLOPT_POSTFIELDS => json_encode($dane),
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT => 15,
        ]);
        $odp = curl_exec($ch);
        $kod = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
        if ($odp !== false && $kod < 500 && $kod !== 409 && $kod !== 429) {
            return json_decode($odp, true);
        }
        usleep(500000 * $proba);   // ten sam klucz: powtórka nie utworzy drugiej płatności
    }
    throw new RuntimeException('Brak odpowiedzi API');
}

$payment = utworzPlatnosc(['amount' => 12900, 'currency' => 'PLN'], 'zamowienie-10482');

async function utworzPlatnosc(dane, kluczIdempotencji) {
  for (let proba = 1; proba <= 3; proba++) {
    try {
      const res = await fetch('https://oplac.pl/api/v1/payments', {
        method: 'POST',
        headers: {
          Authorization: 'Bearer sk_test_TWOJ_KLUCZ',
          'Idempotency-Key': kluczIdempotencji,
          'Content-Type': 'application/json',
        },
        body: JSON.stringify(dane),
        signal: AbortSignal.timeout(15000),
      });
      if (res.status < 500 && res.status !== 409 && res.status !== 429) return res.json();
    } catch (e) {
      // timeout albo zerwane połączenie: ten sam klucz, powtórka nie utworzy drugiej płatności
    }
    await new Promise((r) => setTimeout(r, 500 * proba));
  }
  throw new Error('Brak odpowiedzi API');
}

const payment = await utworzPlatnosc({ amount: 12900, currency: 'PLN' }, 'zamowienie-10482');

import time
import requests

def utworz_platnosc(dane, klucz_idempotencji):
    for proba in range(1, 4):
        try:
            res = requests.post(
                "https://oplac.pl/api/v1/payments",
                headers={"Authorization": "Bearer sk_test_TWOJ_KLUCZ", "Idempotency-Key": klucz_idempotencji},
                json=dane,
                timeout=15,
            )
            if res.status_code < 500 and res.status_code not in (409, 429):
                return res.json()
        except requests.RequestException:
            pass  # ten sam klucz: powtórka nie utworzy drugiej płatności
        time.sleep(0.5 * proba)
    raise RuntimeError("Brak odpowiedzi API")

payment = utworz_platnosc({"amount": 12900, "currency": "PLN"}, "zamowienie-10482")