> ## Documentation Index
> Fetch the complete documentation index at: https://scaleup-c34c4386.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`)

**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

```bash cURL (Cartão) theme={null}
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
    }
  }'
```

```typescript SDK theme={null}
import { Chargefy } from '@chargefy/sdk';

const chargefy = new Chargefy({
  accessToken: process.env.CHARGEFY_ACCESS_TOKEN,
});

const result = await chargefy.checkouts.confirmSdk('chks_secret_xyz', {
  paymentMethod: 'credit_card',
  card: {
    number: '4111111111111111',
    holderName: 'JOAO SILVA',
    expirationMonth: '12',
    expirationYear: '2028',
    cvv: '123',
    installments: 3,
  },
});
```

## Resposta de Exemplo

```json theme={null}
{
  "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
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.