Cobre no cartão direto da sua integração.
Envie os dados do cartão do seu servidor e receba a resposta na hora: paga, recusada ou pendente. Sem redirecionar o comprador.
- Resposta síncrona
- Até 12 parcelas
- Ambiente de teste
Em resumo
- O que é
- A API de cartão da Quibly Pay cobra o cartão de crédito direto do seu servidor (checkout transparente) e responde na hora se a cobrança foi paga, recusada ou está pendente, em até 12 parcelas.
- Para quem é
- Desenvolvedores de contas com a verificação (KYC) aprovada e o cartão liberado. Quem não quer lidar com dados de cartão usa as sessões de checkout.
- Quanto custa
- Sem mensalidade: você paga só quando vende, R$ 1,00 por Pix pago e 4,99% da venda no cartão de crédito à vista.
Como funciona
Confirme os requisitos
A conta precisa ter a verificação (KYC) aprovada e o cartão liberado.
Crie a credencial
Em Desenvolvedor > Credenciais de API, crie uma credencial com os escopos cashin e read.
Envie a cobrança
Chame POST /v3/card/charges do seu servidor, com o cartão, o valor, as parcelas e o IP do comprador.
Trate a resposta
A resposta já traz o resultado (paid, declined ou pending), e o evento transaction.paid chega por webhook.
Veja no código
curl -X POST https://api.quiblypay.com/v3/card/charges \
-H 'content-type: application/json' \
-H 'Idempotency-Key: pedido-981-tentativa-1' \
-d '{
"client_id": "SEU_CLIENT_ID",
"client_secret": "SEU_CLIENT_SECRET",
"amount": "150.00",
"installments": 3,
"description": "Pedido #981",
"customer": {
"name": "Maria Silva",
"email": "maria@example.com",
"document": "529.982.247-25",
"phone": "11999990000"
},
"card": {
"number": "4111111111111111",
"exp_month": "12",
"exp_year": "2030",
"cvv": "123",
"holder_name": "MARIA SILVA"
},
"external_id": "981",
"notification_url": "https://loja.example.com/webhooks/quibly",
"buyer_ip": "177.10.20.30"
}'Trecho da documentação (Cobrança de cartão). Os dados são de exemplo.
{
"statusCode": 200,
"id": "e3c1f0a2b4d6e8f0a1b2c3d4e5f6a7b8c",
"status": "paid",
"amount": "150.00",
"currency": "BRL",
"installments": 3,
"description": "Pedido #981",
"external_id": "981",
"card": { "brand": "visa", "last4": "1111" },
"decline_reason": null,
"message": null,
"created_at": "2026-10-09T14:00:00.000Z",
"paid_at": "2026-10-09T14:00:02.000Z"
}A resposta traz só a bandeira e os 4 últimos dígitos do cartão.
O que você tem
Resposta síncrona
Você sabe na hora se a cobrança foi paga, recusada ou ficou pendente.
Até 12 parcelas
Parcelamento de 1 a 12 vezes, com parcela mínima de R$ 5,00.
Ambiente de teste
Os endpoints de /v3/sandbox aceitam só cartões de teste, como o 4242 4242 4242 4242 (aprovado) e o 4000 0000 0000 0002 (recusado).
Idempotência
Envie o cabeçalho Idempotency-Key para repetir a chamada sem cobrar duas vezes.
IP do comprador no antifraude
O IP público do comprador é obrigatório e segue para a análise de risco.
Consulta da cobrança
POST /v3/card/charges/retrieve devolve o estado de uma cobrança, pelo identificador ou pelo seu id do pedido.
Limites claros
Há limites por cartão, por IP do comprador, por credencial e por conta, descritos na documentação.
O cartão não é guardado
A Quibly Pay mantém o cartão só em memória durante a cobrança e grava apenas a bandeira, os 6 primeiros e os 4 últimos dígitos.
Webhook de pagamento
O evento transaction.paid chega à URL da cobrança e aos webhooks cadastrados.
Para quem é
Quem tem checkout próprio
Mantenha o formulário de cartão na sua página e cobre pela API.
Quem integra uma plataforma
Use o ambiente de teste para validar o fluxo antes de usar a credencial de produção.
Quem não quer tocar em dados de cartão
Use as sessões de checkout: o comprador paga na página da Quibly Pay e o cartão não passa pelo seu servidor.
Perguntas frequentes
Preciso me preocupar com PCI?
Sim, neste modelo. No checkout transparente, o número do cartão passa pelo seu servidor, e a segurança desses dados é responsabilidade sua, conforme a documentação. Se não quer tocar em dados de cartão, use as sessões de checkout.
Quem pode usar a API de cartão?
Contas com a verificação (KYC) aprovada e o cartão liberado. Sem isso, a API responde com erro de permissão.
A API faz 3DS?
Não. O 3DS só existe no checkout hospedado. Se a sua conta exige 3DS, a API recusa a cobrança e orienta a usar as sessões de checkout.
Tem ambiente de teste?
Sim. Os endpoints de /v3/sandbox aceitam só cartões de teste e não cobram nada de verdade.
Quantas parcelas posso oferecer?
Até 12, com parcela mínima de R$ 5,00.
Veja também
Comece grátis, sem mensalidade.
Crie a conta e configure o seu primeiro produto. Você só paga quando vende.