Processar Pagamento

curl --request POST \
  --url https://api.uvvipague.com.br/uvvi/v1/payment \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "checkoutId": "chk_abc123xyz",
  "cardToken": "tok_abc123xyz",
  "installments": 3,
  "customer": {
    "name": "João da Silva",
    "email": "joao@example.com",
    "cpfCnpj": "12345678900"
  }
}
'

{
  "success": true,
  "data": {
    "paymentId": "pay_abc123xyz",
    "status": "paid",
    "amount": 1315.89,
    "installments": 3,
    "transactionId": "txn_abc123xyz"
  }
}

​

Descrição

Processa o pagamento de débitos veiculares utilizando um cartão tokenizado. Este é o último passo do fluxo de pagamento.

​

Pré-requisitos

Antes de processar o pagamento, você deve:

1. Ter criado um checkout válido (checkoutId)
2. Ter tokenizado o cartão do cliente (cardToken)
3. Ter simulado as parcelas (opcional, mas recomendado)

​

Status de Pagamento

O pagamento pode retornar os seguintes status:

• paid: Pagamento aprovado e processado com sucesso
• in_analysis: Transação em análise pelo antifraude (aguardar webhook)
• refused: Transação recusada pela operadora ou antifraude
• processing: Transação sendo processada
• awaiting_payment: Aguardando confirmação de pagamento
• cancelled: Pagamento cancelado
• refunded: Pagamento estornado
• chargeback: Contestação de pagamento

​

Webhooks

Após o processamento, você receberá webhooks sobre:

• Confirmação do pagamento
• Atualização de status
• Liquidação dos débitos nos órgãos

​

Códigos de Resposta HTTP

​

200 - Sucesso

Pagamento processado com sucesso. Verifique o campo status para o resultado.

​

400 - Bad Request

Dados inválidos ou incompletos na requisição.

​

402 - Payment Required

Pagamento recusado pela operadora. Possíveis motivos:

• PAYMENT_REJECTED: Recusado pela operadora
• INVALID_CARD: Cartão inválido
• INSUFFICIENT_FUNDS: Saldo insuficiente
• FRAUD_DETECTED: Fraude detectada
• CARD_EXPIRED: Cartão expirado
• INVALID_CVV: CVV inválido

​

422 - Unprocessable Entity

Dados válidos mas não podem ser processados (ex: checkout expirado).

​

Segurança

• Nunca armazene dados completos de cartão
• Use sempre tokenização
• Valide o CVV em cada transação
• Implemente 3DS quando disponível