Cobrança via Cartão de Crédito

Processamento de pagamentos parcelados com aprovação imediata e análise de risco integrada.

Criar Cobrança com Cartão

Este endpoint processa os dados do cartão e do portador para autorização de uma cobrança.

IMPORTANT

Todos os campos listados abaixo são obrigatórios. A ausência de qualquer parâmetro resultará em um erro 422 Unprocessable Entity.

Endpoint

POST /billing/charges

Payload de Requisição (JSON)

{
    "payment_method": "CARD",
    "name": "Nome do Pagador",
    "document": "12345678901",
    "email": "pagador@email.com",
    "phone": "81999999999",
    "birthDate": "1990-01-01",
    "installments": "3",
    "card": {
        "cardholder_name": "NOME NO CARTAO",
        "card_number": "5438821303436489",
        "expiry": "0234",
        "cvv": "953"
    },
    "address": {
        "zipcode": "50000000",
        "street": "Rua Exemplo",
        "number": "123",
        "district": "Bairro",
        "city": "Recife",
        "state": "PE"
    }
}

Detalhes dos Campos do Cartão

• card.expiry: Data de expiração no formato MMYY (ex: 0234 para Fevereiro de 2034).
• installments: Número de parcelas desejado (enviado como string).
• address: Endereço de cobrança completo do portador do cartão (necessário para validação de segurança).

---

Resposta de Sucesso (201 Created)

{
    "data": {
        "id": 247875,
        "amount": 1500,
        "status": {
            "id": 2,
            "title": "paid",
            "description": "Pago"
        },
        "transaction_details": {
            "auth_code": "123456",
            "brand": "Mastercard",
            "installments": 3,
            "last_four": "6489"
        },
        "timestamps": {
            "created_at": {
                "iso": "2026-04-10T11:58:00.000000Z"
            }
        }
    }
}

---

Observações de Segurança

1. PCI Compliance: Os dados do cartão não são armazenados em sua forma bruta após o processamento.
2. Antifraude: Todas as transações são submetidas à análise de fraude. Em alguns casos, o status pode retornar como pending caso entre em fila de análise manual.