> ## 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/payment-updates/:token/confirm

> Atualiza o cartão de pagamento da assinatura usando um token de atualização

Endpoint público que recebe o novo `card_id` (tokenizado no gateway) e atualiza o cartão vinculado à assinatura de recorrência no provedor de pagamentos. Também persiste os dados do cartão na base de dados da assinatura.

## Autenticação

Nenhuma. O `token` na URL é a prova de autorização.

## Parâmetros de Path

**token** `string` *required*

Token único gerado pelo endpoint `POST /api/v1/subscriptions/:id/payment-update-token`. Válido por 48 horas

## Corpo da Requisição

**card\_id** `string` *required*

ID do cartão tokenizado no gateway. O cartão deve pertencer ao comprador vinculado à assinatura

## Resposta

**success** `boolean`

`true` quando o cartão for atualizado com sucesso na assinatura no gateway

## Exemplo

```bash cURL theme={null}
curl -X POST "https://api.chargefy.io/api/v1/payment-updates/tok_abc123xyz/confirm" \
  -H "Content-Type: application/json" \
  -d '{"card_id": "card_gw_789"}'
```

## Resposta de Exemplo

```json theme={null}
{
  "success": true
}
```

## Erros Comuns

| Código | Descrição |
| - | - |
| `400` | `card_id` não informado |
| `404` | Token inválido ou expirado |
| `422` | Assinatura sem recorrência no gateway (`zoop_subscription_id` ausente) |
| `500` | Erro ao atualizar o cartão no provedor de pagamentos |


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