Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt

Use this file to discover all available pages before exploring further.

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 processador interno (nome do campo conforme contrato da 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.
​
card
object
Dados do cartão de crédito. Obrigatório quando payment_type é credit.

​
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 -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": "cliente@exemplo.com",
    "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"
  }
}