POST /api/v1/checkouts/client/:client_secret/confirm-sdk

Confirma o checkout com tokenização do cartão server-side — ideal para integrações via SDK sem SDK de tokenização no cliente

Variante do endpoint de confirmação que aceita dados brutos do cartão e realiza a tokenização diretamente no servidor via gateway de pagamentos. Indicado para integrações via SDK onde a tokenização no navegador não está disponível.

Suporta credit_card (com tokenização server-side) e pix. Também aplica cupons de desconto no momento do pagamento.

Autenticação

Endpoint público — não requer Authorization. Utiliza o client_secret como autenticação implícita.

Parâmetros de Path

client_secret · string · required

Segredo do cliente do checkout

Corpo da Requisição

payment_method · string · required

Método de pagamento: credit_card ou pix

customer_email · string

E-mail do comprador (utilizado para PIX)

customer_name · string

Nome do comprador (utilizado para PIX)

customer_tax_id · string

CPF ou CNPJ (utilizado para PIX)

discount_code · string

Código de cupom de desconto a aplicar no momento do pagamento

card · object

Dados do cartão (obrigatório quando payment_method = credit_card)

Show Propriedades

number · string · required

Número do cartão

holder_name · string · required

Nome do titular

expiration_month · string · required

Mês de validade (ex: "03")

expiration_year · string · required

Ano de validade (ex: "2028")

cvv · string · required

Código de segurança (CVV)

installments · integer · default: "1"

Número de parcelas (1–12)

card_brand · string

Bandeira do cartão (ex: visa, mastercard). Opcional — seleciona a faixa de tarifas; se omitido, o BIN determina a tarifa.

Resposta

Retorna o checkout atualizado com status e dados da transação do gateway em zoop_payment_data (campo da API).

Exemplo

cURL (Cartão)

curl -X POST "https://api.chargefy.io/api/v1/checkouts/client/chks_secret_xyz/confirm-sdk" \
  -H "Content-Type: application/json" \
  -d '{
    "payment_method": "credit_card",
    "card": {
      "number": "4111111111111111",
      "holder_name": "JOAO SILVA",
      "expiration_month": "12",
      "expiration_year": "2028",
      "cvv": "123",
      "installments": 3
    }
  }'

Resposta de Exemplo

{
  "id": "chk_1a2b3c4d5e6f",
  "status": "succeeded",
  "payment_method": "credit_card",
  "amount": 29700,
  "currency": "BRL",
  "zoop_payment_data": {
    "transaction_id": "txn_abc123",
    "status": "succeeded",
    "authorization_code": "AUTH789",
    "installments": 3
  }
}