Atualizar link de pagamento
PUT
https://api.bestfy.io/public-api/payment-link/{paymentLinkId}
bankSlipEnabled e bankSlipDueDays, que são opcionais e, quando omitidos, preservam o valor original).slug e a url não mudam em nenhuma hipótese, então links já compartilhados continuam válidos depois da edição.Regras de uso
paymentLinkId precisa estar no formato correto.maxInterestFreeInstallments não pode exceder maxInstallments.amountInCents / maxInstallments precisa ser no mínimo 500, ou seja R$ 5,00 por parcela.name continua único por empresa. Mudar apenas a caixa do nome, de consultoria para CONSULTORIA, não dispara conflito com o próprio link.Efeito sobre vendas já realizadas
Resposta
204, sem corpo. Para conferir o estado resultante, chame Buscar link de pagamento.Erros comuns
| Código | Motivo. |
|---|---|
400 | paymentLinkId fora do formato correto. |
400 | Requisição inválida, por campo ausente ou valor fora dos limites. |
400 | PAYMENT_LINK_E002 — já existe outro link de pagamento com este nome. |
400 | PAYMENT_LINK_E003 — método de pagamento não permitido para esta empresa. |
400 | PAYMENT_LINK_E004 — habilite ao menos um método de pagamento no link. |
400 | PAYMENT_LINK_E005 — parcelas sem juros acima do parcelamento máximo. |
400 | PAYMENT_LINK_E006 — valor por parcela abaixo do mínimo de R$ 5,00. |
401 | x-api-key ausente ou inválida. |
403 | API_KEY_E001 — chave revogada. |
403 | Links de pagamento não habilitados para a sua conta. |
404 | PAYMENT_LINK_E001 — link inexistente, excluído ou de outra empresa. |
429 | Acima de 60 requisições por minuto, contadas por empresa e não por IP. |
500 | Erro interno — tente novamente após alguns segundos. |
400 de formato do paymentLinkId vem como { "message": "ID inválido", "error": "Bad Request", "statusCode": 400 }. Os erros de regra de negócio vêm com code e sem statusCode; os de api-key vêm com statusCode no corpo.Request
Path Params
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://api.bestfy.io/public-api/payment-link/' \
--header 'User-Agent: <nome-do-projeto>' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"name": "Consultoria 1h",
"amountInCents": 15000,
"pixEnabled": true,
"bankSlipEnabled": false,
"bankSlipDueDays": 1
"creditCardEnabled": true,
"maxInstallments": 12,
"maxInterestFreeInstallments": 3,
"isActive": true
}'Response Response Example
204 - Success
No contentModified at 2026-09-16 14:59:43