Idempotência na NyxPag API

# A mesma chave em duas chamadas: a segunda devolve 200 e idempotent: true
for i in 1 2; do
  curl -s -o /dev/null -w "%{http_code}\n" \
    -X POST https://api.nyxpag.com.br/v1/transactions \
    -H "Authorization: Bearer $NYXPAG_API_KEY" \
    -H "Content-Type: application/json" \
    -H "Idempotency-Key: PEDIDO-1042-t1" \
    -d '{"amount":149.90,"payer":{"name":"Maria Silva","document":"52998224725"}}'
done
# 201
# 200

async function createCharge(orderId, attempt, payload) {
  const key = `${orderId}-t${attempt}`;

  // 1. persista a chave ANTES de chamar a API
  await db.charges.insertIfAbsent({ orderId, attempt, key });

  for (let i = 0; i < 3; i++) {
    try {
      const res = await fetch("https://api.nyxpag.com.br/v1/transactions", {
        method: "POST",
        headers: {
          Authorization: `Bearer ${process.env.NYXPAG_API_KEY}`,
          "Content-Type": "application/json",
          "Idempotency-Key": key, // 2. a MESMA chave em todas as tentativas
        },
        body: JSON.stringify(payload),
      });
      if (res.status < 500) return res.json(); // 200, 201, 202, 4xx
    } catch {
      // erro de rede: tente de novo com a mesma chave
    }
    await new Promise((r) => setTimeout(r, 2 ** i * 1000));
  }
  throw new Error("Sem resposta da NyxPag; reenvie depois com a mesma chave");
}

import os
import time
import requests

def create_charge(order_id: str, attempt: int, payload: dict) -> dict:
    key = f"{order_id}-t{attempt}"

    # 1. persista a chave ANTES de chamar a API
    db.charges.insert_if_absent(order_id=order_id, attempt=attempt, key=key)

    for i in range(3):
        try:
            res = requests.post(
                "https://api.nyxpag.com.br/v1/transactions",
                headers={
                    "Authorization": f"Bearer {os.environ['NYXPAG_API_KEY']}",
                    "Idempotency-Key": key,  # 2. a MESMA chave em todas as tentativas
                },
                json=payload,
                timeout=15,
            )
            if res.status_code < 500:
                return res.json()
        except requests.RequestException:
            pass  # erro de rede: tente de novo com a mesma chave
        time.sleep(2 ** i)

    raise RuntimeError("Sem resposta da NyxPag; reenvie depois com a mesma chave")

<?php
function createCharge(string $orderId, int $attempt, array $payload): array
{
    $key = "{$orderId}-t{$attempt}";

    // 1. persista a chave ANTES de chamar a API
    db_charges_insert_if_absent($orderId, $attempt, $key);

    for ($i = 0; $i < 3; $i++) {
        $ch = curl_init('https://api.nyxpag.com.br/v1/transactions');
        curl_setopt_array($ch, [
            CURLOPT_POST => true,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT => 15,
            CURLOPT_HTTPHEADER => [
                'Authorization: Bearer ' . getenv('NYXPAG_API_KEY'),
                'Content-Type: application/json',
                'Idempotency-Key: ' . $key, // 2. a MESMA chave em todas as tentativas
            ],
            CURLOPT_POSTFIELDS => json_encode($payload),
        ]);
        $raw = curl_exec($ch);
        $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);

        if ($raw !== false && $status < 500) {
            return json_decode($raw, true);
        }
        sleep(2 ** $i);
    }

    throw new RuntimeException('Sem resposta da NyxPag; reenvie depois com a mesma chave');
}