Cartão de débito

curl --request POST \
+  --url https://api.leonapay.com.br/api/v2/payments \
+  --header 'Accept: application/json' \
+  --header 'Content-Type: application/json' \
+  --header 'x-api-key: {your_api_key}' \
+  --header 'idempotency-key: {unique_uuid_per_payment}' \
  --data '{
  "method": "DEBIT_CARD",
  "amount": 125.90,
  "currency": "BRL",
  "reference": "pedido-123",
  "payer": { "name": "Ana Souza", "email": "ana@exemplo.com", "taxId": "12345678909" },
  "returnUrl": "https://loja.exemplo.com/pagamento/retorno"
}'

<!-- checkout.html: você controla a estrutura e o visual externo -->
<label>Número do cartão <div id="card-number"></div></label>
<div class="card-row">
  <label>Validade <div id="card-expiry"></div></label>
  <label>CVV <div id="card-cvc"></div></label>
</div>
<button id="pay-card" type="button">Pagar</button>
<p id="card-error" role="alert"></p>
<script src="https://client.leonapay.com.br/sdk/onpay-card.js"></script>
<script src="/checkout.js"></script>

// checkout.js
async function prepararPagamentoDoCartao(dadosDoPedido) {
  // Esta rota pertence ao seu backend. É ele que chama POST /api/v2/payments.
  const response = await fetch("/api/pagamentos", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(dadosDoPedido)
  });
  let payment = await response.json();

  if (!response.ok) throw new Error(payment.onpayDescription || "Falha ao criar pagamento");

  const transactionId = payment?.data?.id;
  if (!transactionId) throw new Error("Resposta sem identificador de pagamento");

  // A rota GET abaixo também pertence ao seu backend: ela consulta
  // GET /api/v2/transactions/{transactionId}, com a chave somente no servidor.
  for (let attempt = 0; attempt < 30; attempt++) {
    if (payment?.data?.nextAction || !["PENDING", "ACTION_REQUIRED"].includes(payment?.data?.status)) break;
    await new Promise(resolve => setTimeout(resolve, 1000));
    const lookup = await fetch("/api/pagamentos/" + encodeURIComponent(transactionId), { cache: "no-store" });
    const latest = await lookup.json();
    if (!lookup.ok || latest.success === false) throw new Error(latest.onpayDescription || "Falha ao consultar pagamento");
    payment = latest; // Atualize a resposta inteira, incluindo data.nextAction.
  }

  const action = payment?.data?.nextAction;
  if (action?.type !== "CONFIRM_CARD") {
    // Mostre o estado atual. Preserve o ID para retomar a consulta, sem novo POST.
    // ACTION_REQUIRED isolado pode ser análise de segurança, não campos prontos.
    return { transactionId, status: payment?.data?.status };
  }
  if (action.integrationMode !== "SECURE_FIELDS" || !action.clientSecret) {
    throw new Error("Esta sessão não oferece campos integrados; verifique o modo de integração");
  }
  if (!Number.isFinite(Date.parse(action.expiresAt)) || Date.parse(action.expiresAt) <= Date.now()) {
    throw new Error("A sessão de cartão expirou");
  }

  const elements = OnpayCard.elements({
    clientSecret: action.clientSecret,
    appearance: {
      color: "#111827",
      fontFamily: "Inter, sans-serif",
      fontSize: "16px"
    }
  });

  elements.create("cardNumber").mount("#card-number");
  elements.create("cardExpiry").mount("#card-expiry");
  elements.create("cardCvc").mount("#card-cvc");

  document.querySelector("#pay-card").addEventListener("click", async () => {
    const button = document.querySelector("#pay-card");
    const errorNode = document.querySelector("#card-error");
    button.disabled = true;
    errorNode.textContent = "";

    const result = await OnpayCard.confirmCardPayment({
      clientSecret: action.clientSecret,
      elements
    });

    if (result.error) {
      errorNode.textContent = result.error.message;
      button.disabled = false;
      return;
    }

    // Mostre "processando". Seu backend confirma por webhook ou consulta.
    console.log("Confirmação enviada", result.payment.id);
  });
}

prepararPagamentoDoCartao({
  method: "DEBIT_CARD",
  amount: 125.90,
  currency: "BRL",
  reference: "pedido-123",
  payer: {
    name: "Ana Souza",
    email: "ana@exemplo.com",
    taxId: "12345678909"
  },
  returnUrl: "https://loja.exemplo.com/pagamento/retorno"
});

script-src 'self' https://client.leonapay.com.br https://js.stripe.com;
connect-src 'self' https://client.leonapay.com.br https://api.stripe.com https://r.stripe.com https://m.stripe.network;
frame-src 'self' https://client.leonapay.com.br https://js.stripe.com https://hooks.stripe.com;

{
  "id": "pay_123",
  "reference": "pedido_123",
  "status": "PAID",
  "method": "DEBIT_CARD",
  "warnings": [
    {
      "code": "ONP_CARD_METHOD_CORRECTED",
      "field": "method",
      "requestedMethod": "CREDIT_CARD",
      "processedMethod": "DEBIT_CARD",
      "message": "O método foi ajustado ao tipo do cartão informado. Use DEBIT_CARD nas próximas solicitações com este tipo de cartão. Não reenvie esta cobrança."
    }
  ]
}

{
  "success": true,
  "onpayCode": "ONP202_3DS",
  "onpayDescription": "Customer confirmation required",
  "data": {
    "id": "pay_01J5VX8M8W8W6Q",
    "reference": "pedido-123",
    "status": "ACTION_REQUIRED",
    "method": "DEBIT_CARD",
    "currency": "BRL",
    "amount": 125.90,
    "fee": 1.75,
    "settlementDays": 7,
    "releaseAt": null,
    "customer": {
      "id": "cus_01J5VY2Q8G4K9D",
      "name": "Ana Souza",
      "email": null,
      "phone": null,
      "taxId": "12345678909"
    },
    "nextAction": {
      "type": "CONFIRM_CARD",
      "integrationMode": "SECURE_FIELDS",
      "clientSecret": "ocs_...",
      "sessionToken": "ocs_...",
      "checkoutUrl": "https://client.leonapay.com.br/card-session/ocs_...",
      "expiresAt": "2026-08-28T18:30:00Z"
    },
    "paidAt": null,
    "createdAt": "2026-08-25T01:04:23.295Z",
    "updatedAt": "2026-08-25T01:04:24.738Z"
  }
}