Links de pagamento

Atualizar link de pagamento

Atualiza as configurações de uma página de pagamento, como preço vinculado, parcelamento ou aparência. Todos os campos são opcionais — envie apenas o que deseja alterar.

PUT/v1/checkouts/:id

Base URL Produção:https://api.validapay.com.br

Base URL Sandbox:https://sandbox.validapay.com.br

Pagamento internacional (internationalEnabled): com internationalEnabled: true, o checkout passa a aceitar compradores de fora do Brasil. Ele detecta o país do visitante (com seletor para trocar), traduz a página para o idioma do país e mostra o valor aproximado na moeda local; a cobrança continua sendo em reais. Para comprador estrangeiro, o checkout aceita somente cartão de crédito à vista, sem documento e com endereço internacional completo. Comprador brasileiro continua vendo o checkout de sempre. Inclua creditcard em allowedPaymentMethods, senão o comprador estrangeiro não tem como pagar.

A função precisa ser habilitada na sua conta: entre em contato com o suporte da ValidaPay para solicitar a habilitação. Sem ela, enviar internationalEnabled: true retorna 403 INTERNATIONAL_CHECKOUT_NOT_ENABLED e o link não é criado nem alterado. Regras completas do comprador estrangeiro em Gerar cobrança Cartão internacional.

Authorizations

bearer

Authorization

string obrigatório

Cabeçalho de autenticação Bearer no formato Bearer {{token}} onde {{token}} é o seu token OAuth2.

Escopos requeridos

checkouts/write

Path Parameters

idstringobrigatório

ID do checkout / payment link (ex: pl_xxx) - required

Body

application/json

Content-Type:application/json

JSON

{
  "priceId": "price_yyy",
  "discounts": [],
  "maxInstallments": 6,
  "primaryColor": "#FF0000",
  "showProductImage": false,
  "termsOfServiceUrl": "https://meusite.com/termos-de-servico",
  "privacyPolicyUrl": "https://meusite.com/politica-de-privacidade",
  "internationalEnabled": true,
  "applyBrandingToAllPrices": true
}

Schema

priceIdstringopcional

Novo preço vinculado ao checkout

discountsarray[0]opcional

Descontos aplicados

maxInstallmentsnumberopcional

Limite de parcelas (1 a 12)

Regra:1 a 12

primaryColorstringopcional

Cor primária em hex

showProductImagebooleanopcional

Exibir imagem do produto

termsOfServiceUrlstringopcional

Termos de serviço exibidos no checkout para aceite do cliente

Regra:uri

privacyPolicyUrlstringopcional

Política de privacidade exibida no checkout para aceite do cliente

Regra:uri

internationalEnabledbooleanopcional

Aceita pagamento de compradores de fora do Brasil (default false). Exige a habilitação do pagamento internacional na conta: entre em contato com o suporte da ValidaPay para solicitar. Sem ela, true retorna 403 INTERNATIONAL_CHECKOUT_NOT_ENABLED

applyBrandingToAllPricesbooleanopcional

Aplica a identidade visual a todos os preços

Headers

Content-Typeopcional

application/json

← Anterior

Buscar link de pagamento

Criar sessão de pagamento

const url = 'https://sandbox.validapay.com.br/v1/checkouts/:id';

const options = {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer {{token}}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "priceId": "price_yyy",
  "discounts": [],
  "maxInstallments": 6,
  "primaryColor": "#FF0000",
  "showProductImage": false,
  "termsOfServiceUrl": "https://meusite.com/termos-de-servico",
  "privacyPolicyUrl": "https://meusite.com/politica-de-privacidade",
  "internationalEnabled": true,
  "applyBrandingToAllPrices": true
})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response Examples

200▾

JSON

{
  "id": "pl_xxx",
  "priceId": "price_yyy"
}

404▾

JSON

{
    "error": {
        "message": "Checkout não encontrado",
        "code": "CHECKOUT_NOT_FOUND",
        "details": null,
        "timestamp": "2026-07-14T21:39:36.322Z"
    }
}

← Anterior

Buscar link de pagamento

Criar sessão de pagamento