PATCH /api/v1/checkouts/client/:client_secret

Atualiza os dados do cliente em um checkout antes da confirmação do pagamento

Endpoint público utilizado pelo frontend para atualizar informações do comprador (e-mail, nome, endereço, etc.) antes de confirmar o pagamento. Não requer autenticação — usa o client_secret como identificador.

​

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 gerado na criação do checkout

​

Corpo da Requisição

Todos os campos são opcionais — apenas os campos enviados serão atualizados.

customer_name · string

Nome completo do comprador

customer_email · string

E-mail do comprador

customer_billing_name · string

Nome de cobrança

customer_billing_address · object

Endereço de cobrança

Show Propriedades

line1 · string

Logradouro e número

line2 · string

Complemento

city · string

Cidade

state · string

Estado (UF)

postal_code · string

CEP

country · string

País (ex: BR)

customer_tax_id · string

CPF ou CNPJ

discount_code · string

Código de desconto a aplicar

amount · integer

Valor customizado em centavos (apenas para produtos com preço variável)

metadata · object

Metadados adicionais

​

Resposta

Retorna o objeto do checkout atualizado.

​

Exemplo

cURL

curl -X PATCH "https://api.chargefy.io/api/v1/checkouts/client/chks_secret_xyz" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_name": "João Silva",
    "customer_email": "[e-mail]",
    "customer_tax_id": "12345678901"
  }'

​

Resposta de Exemplo

{
  "id": "chk_1a2b3c4d5e6f",
  "status": "open",
  "customer_name": "João Silva",
  "customer_email": "[e-mail]",
  "customer_tax_id": "12345678901",
  "amount": 9900,
  "currency": "BRL"
}