LYNX · Tecnologia de pagamentos Pix & Crypto

Cobrar no cartão de crédito

POST/v1/card/in

Recebe um pagamento no CARTÃO DE CRÉDITO (card-in). A venda é autorizada na hora (aprovada/recusada em tempo real). ATENÇÃO PCI: esta é a única rota que recebe número de cartão e CVV — trafegue sempre por HTTPS e nunca armazene os dados. O valor NÃO cai no saldo imediatamente: vira um RECEBÍVEL e entra no saldo na data de liquidação (D+30 à vista; 1 parcela por mês no parcelado). Chaves de teste (lynx_test_) usam o sandbox e não movem dinheiro real; use o número 4000000000000002 para simular uma recusa.

Permissão necessária: CARD:CHARGE

Boas práticas

Aprovado NÃO é saldo disponível: acompanhe a liquidação de cada parcela pelo webhook card.settled ou por GET /v1/card/receivables.
netCents é o líquido que você recebe (bruto menos a taxa do cartão). A taxa é descontada do recebedor, não do portador.
Recusa retorna HTTP 402 com o motivo; se sua conta ainda não tem card-in habilitado, retorna 403 CARD_NOT_ENABLED.

Requisição

bash

curl -X POST https://lynxpix.cc/api/v1/card/in \
  -H "Authorization: Bearer lynx_test_sua_chave" \
  -H "Content-Type: application/json" \
  -d '[{"name":"amountCents","type":"integer","req":true,"desc":"Valor total da venda, em centavos (cobrado do cartão)."},{"name":"installments","type":"integer","desc":"Número de parcelas (1 = à vista). Limite definido pelo recebedor."},{"name":"card","type":"object","req":true,"desc":"{ number, holder, expiration (MM/AAAA), cvv } — dados do cartão do portador."},{"name":"customer","type":"object","desc":"{ name, document, email } do portador (opcional, recomendado para antifraude)."},{"name":"description","type":"string","desc":"Descrição da venda (aparece no extrato)."},{"name":"externalId","type":"string","desc":"Sua referência para conciliação (volta no webhook)."}]'

Resposta

json

{
  "data": {
    "id": "f7a95bb4ac00",
    "externalId": "lynx_card_7cf61...",
    "status": "approved",
    "amountCents": 45000,
    "installments": 4,
    "netCents": 42079,
    "feeCents": 675,
    "settlementStatus": "SCHEDULED",
    "card": {
      "brand": "Visa",
      "last4": "1111",
      "bin": "411111"
    },
    "authorizationCode": "666848",
    "settlementDates": [
      "2026-09-25T...",
      "2026-10-25T...",
      "2026-11-24T...",
      "2026-12-24T..."
    ],
    "createdAt": "2026-08-26T22:24:15Z"
  },
  "error": null
}