POST /api/v1/transactions/direct

Processa um pagamento direto via cartão de crédito ou PIX a partir do navegador do comprador, sem intermediação de servidor.

Cria uma transação de pagamento diretamente do navegador do comprador durante o fluxo de checkout. Este endpoint é público e não requer autenticação, pois é chamado pelo frontend. Para pagamentos com cartão de crédito, os dados do cartão são enviados diretamente ao gateway de pagamentos para tokenização (PCI compliant).

​

Autenticação

Este endpoint é público e não requer autenticação. É projetado para ser chamado diretamente do browser durante o checkout.

​

Corpo da Requisição

seller_id · string · required

Identificador do vendedor no gateway, obtido previamente via /seller-config.

amount · integer · required

Valor total da transação em centavos. Exemplo: 9900 para R$ 99,00.

checkout_id · string

Identificador do checkout associado a esta transação.

customer_email · string

Endereço de e-mail do comprador.

customer_tax_id · string

CPF ou CNPJ do comprador (somente números).

zoop_buyer_id · string

Identificador do comprador no gateway (zoop_buyer_id na API). Quando informado, associa a transação a um comprador existente.

installments · integer

Número de parcelas do pagamento. Aceita valores de 1 a 12. Aplicável apenas para payment_type: credit. Assinaturas com recorrência mensal aceitam apenas 1 parcela — o servidor rejeita com 400 qualquer valor maior para esses produtos.

payment_type · string

Tipo de pagamento. Valores aceitos: credit ou pix. Padrão: credit.

discount_code · string

Código de desconto a ser aplicado na transação.

customer_billing_address · object

Endereço de cobrança do comprador.

Show customer_billing_address

line1 · string

Logradouro e número.

line2 · string

Complemento (apto, bloco, etc.).

city · string

Cidade.

state · string

Estado (sigla, ex.: SP).

postal_code · string

CEP (somente números).

country · string

País (código ISO 3166-1 alpha-2, ex.: BR).

card · object

Dados do cartão de crédito. Obrigatório quando payment_type é credit.

Show card

card_number · string · required

Número do cartão (somente dígitos, sem espaços).

holder_name · string · required

Nome do titular conforme impresso no cartão.

expiration_month · string · required

Mês de vencimento (dois dígitos, ex.: 08).

expiration_year · string · required

Ano de vencimento (quatro dígitos, ex.: 2028).

security_code · string · required

Código de segurança CVV do cartão.

​

Resposta

transaction_id · string

Identificador da transação no gateway de pagamentos.

status · string

Status da transação retornado pelo gateway. Valores possíveis: new, pending, pre_authorized, succeeded, failed, canceled.

authorization_code · string

Código de autorização retornado pela adquirente.

amount · integer

Valor processado em centavos.

installments · integer

Número de parcelas da transação.

decline_reason · string

Motivo de recusa, quando a transação é negada. Presente apenas em caso de falha.

payment_method · object

Detalhes do método de pagamento utilizado.

​

Exemplo

cURL

curl -X POST "https://api.chargefy.io/api/v1/transactions/direct" \
  -H "Content-Type: application/json" \
  -d '{
    "seller_id": "seller_abc123xyz",
    "checkout_id": "chk_01j9abc123",
    "customer_email": "[e-mail]",
    "amount": 9900,
    "installments": 1,
    "payment_type": "credit",
    "card": {
      "card_number": "4111111111111111",
      "holder_name": "JOAO DA SILVA",
      "expiration_month": "12",
      "expiration_year": "2028",
      "security_code": "123"
    }
  }'

​

Resposta de Exemplo

{
  "transaction_id": "txn_01j9abc123",
  "status": "succeeded",
  "authorization_code": "AUTH123456",
  "amount": 9900,
  "installments": 1,
  "payment_method": {
    "type": "credit",
    "brand": "visa",
    "last4": "1111"
  }
}