Atualizar um link de pagamento

curl -X POST "https://api.chargefy.io/v1/payment-links/plink_HTFCXiiJFWgEdqH5" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Bio Instagram - Atualizado",
    "metadata": {},
    "payment_method_collection": "always",
    "subscription_data": {},
    "success_url": "https://meusite.com/nova-pagina"
  }'

{
  "id": "plink_HTFCXiiJFWgEdqH5",
  "object": "payment_link",
  "allow_discount_codes": false,
  "cancel_url": null,
  "created_at": "2026-05-02T18:31:00Z",
  "discount": null,
  "has_surcharge": false,
  "is_active": true,
  "label": "Bio Instagram - Atualizado",
  "line_items": [],
  "livemode": true,
  "metadata": {},
  "payment_method_collection": "always",
  "subscription_data": {},
  "success_url": "https://meusite.com/nova-pagina",
  "updated_at": "2026-05-02T18:35:00Z",
  "url": "https://pay.chargefy.io/link/9a1bc3d2e4f5..."
}

Atualiza campos de um payment link. Só os campos enviados são alterados — o resto fica como estava. Importante: atualizações afetam apenas cliques futuros. Sessões já materializadas a partir de cliques anteriores guardam os line_items que tinham no momento do clique — é cópia, não referência. Trocar o preço hoje não muda nada do que já está em cobrança; só novos cliques a partir de agora veem o novo preço.

Autenticação

Mesmo contrato de POST /v1/payment-links — Org API key (write ou admin) ou API key da plataforma (platform_admin) com header Organization.

Parâmetros de caminho

string

required

ID do payment link, prefixo plink_.

Attributes

Todos os campos são opcionais. Apenas o que for enviado é atualizado.

boolean

Liga ou desliga o campo de código de desconto no checkout deste link. Vale para cliques futuros; sessões já materializadas mantêm a configuração do momento do clique. Valor que não seja booleano retorna 400.

string

Envie null pra remover.

string

Desconto auto-aplicado. null remove.

boolean

Liga ou desliga o repasse de taxa. Vale para cliques futuros; sessões já materializadas mantêm a configuração do momento do clique. O repasse vale só para cobrança avulsa: não pode ser ligado num link de assinatura, e os itens de um link com repasse não podem ser trocados por itens recorrentes — as duas direções retornam 400.

boolean

Envie false para desativar o link. Cliques futuros retornam 404; sessões já materializadas continuam vivas. Envie true para reativar.

string

Nome interno. Envie null pra remover.

array

Substitui completamente os line items do link. Mesma forma de envio do POST. Os antigos são arquivados (cliques futuros não os enxergam mais); sessões já materializadas mantêm os antigos.

object

Substitui o objeto inteiro. Pra preservar chaves existentes, busque o link primeiro e envie o merge.

string

Mesma semântica do POST. Trocar os itens de recorrente para avulso derruba este campo de volta para always.

object

Substitui o objeto inteiro. Mesma forma de envio do POST. Trocar os itens de recorrente para avulso limpa a configuração, porque não haveria assinatura para configurar.

string

Envie null pra remover.

curl -X POST "https://api.chargefy.io/v1/payment-links/plink_HTFCXiiJFWgEdqH5" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Bio Instagram - Atualizado",
    "metadata": {},
    "payment_method_collection": "always",
    "subscription_data": {},
    "success_url": "https://meusite.com/nova-pagina"
  }'

Resposta

200 OK com o objeto canônico do payment link. Mesma forma da resposta de POST /v1/payment-links.

{
  "id": "plink_HTFCXiiJFWgEdqH5",
  "object": "payment_link",
  "allow_discount_codes": false,
  "cancel_url": null,
  "created_at": "2026-05-02T18:31:00Z",
  "discount": null,
  "has_surcharge": false,
  "is_active": true,
  "label": "Bio Instagram - Atualizado",
  "line_items": [],
  "livemode": true,
  "metadata": {},
  "payment_method_collection": "always",
  "subscription_data": {},
  "success_url": "https://meusite.com/nova-pagina",
  "updated_at": "2026-05-02T18:35:00Z",
  "url": "https://pay.chargefy.io/link/9a1bc3d2e4f5..."
}

Webhook

Quando a chamada altera algum campo, a Chargefy emite payment.link.updated. O webhook segue o payload padrão: data.object carrega o payment link completo já atualizado, e data.previous_attributes carrega apenas os campos alterados com o valor anterior.

{
  "id": "evt_Df6LzwhaEPuM2Hud",
  "object": "event",
  "created_at": "2026-05-02T18:35:00Z",
  "data": {
    "object": {
      "id": "plink_HTFCXiiJFWgEdqH5",
      "object": "payment_link",
      "allow_discount_codes": false,
      "cancel_url": null,
      "created_at": "2026-05-02T18:31:00Z",
      "discount": null,
      "has_surcharge": false,
      "is_active": true,
      "label": "Bio Instagram - Atualizado",
      "line_items": [],
      "livemode": true,
      "metadata": {},
      "payment_method_collection": "always",
      "subscription_data": {},
      "success_url": "https://meusite.com/nova-pagina",
      "updated_at": "2026-05-02T18:35:00Z",
      "url": "https://pay.chargefy.io/link/9a1bc3d2e4f5..."
    },
    "previous_attributes": {
      "label": "Bio Instagram - Plano Pro",
      "metadata": {},
      "payment_method_collection": "always",
      "subscription_data": {},
      "success_url": "https://meusite.com/obrigado"
    }
  },
  "livemode": true,
  "organization": "org_KfWXSeiuME53Ms77",
  "request": {
    "id": "req_yW7w9XbYsfXQmPN2"
  },
  "type": "payment.link.updated"
}

Trocar o preço de um link

curl -X POST "https://api.chargefy.io/v1/payment-links/plink_HTFCXiiJFWgEdqH5" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "line_items": [
      {
        "price_id": "price_QW2nSe8M5UjR3xKP",
        "quantity": 1
      }
    ]
  }'

A partir desse momento, novos cliques abrem checkout com o novo preço. Cliques anteriores (sessões já criadas) seguem com o preço antigo até concluírem ou expirarem.

Erros comuns

Status	`code`	Quando
`400`	`invalid_request`	`line_items` enviado mas vazio ou inválido.
`400`	`invalid_request`	O estado resultante combina `has_surcharge: true` com item recorrente — em qualquer direção do update.
`400`	`invalid_request`	`allow_discount_codes` enviado com valor que não é booleano.
`403`	`permission_denied`	API key sem acesso à organização dona do link.
`404`	`resource_missing`	`id` não existe na organização atuante.

curl -X POST "https://api.chargefy.io/v1/payment-links/plink_HTFCXiiJFWgEdqH5" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Bio Instagram - Atualizado",
    "metadata": {},
    "payment_method_collection": "always",
    "subscription_data": {},
    "success_url": "https://meusite.com/nova-pagina"
  }'

{
  "id": "plink_HTFCXiiJFWgEdqH5",
  "object": "payment_link",
  "allow_discount_codes": false,
  "cancel_url": null,
  "created_at": "2026-05-02T18:31:00Z",
  "discount": null,
  "has_surcharge": false,
  "is_active": true,
  "label": "Bio Instagram - Atualizado",
  "line_items": [],
  "livemode": true,
  "metadata": {},
  "payment_method_collection": "always",
  "subscription_data": {},
  "success_url": "https://meusite.com/nova-pagina",
  "updated_at": "2026-05-02T18:35:00Z",
  "url": "https://pay.chargefy.io/link/9a1bc3d2e4f5..."
}

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Atualizar um link de pagamento

Autenticação

Parâmetros de caminho

Attributes

Resposta

Webhook

Trocar o preço de um link

Erros comuns

​Autenticação

​Parâmetros de caminho

​Attributes

​Resposta

​Webhook

​Trocar o preço de um link

​Erros comuns

Autenticação

Parâmetros de caminho

Attributes

Resposta

Webhook

Trocar o preço de um link

Erros comuns