SelectwinSelectwin

Atualiza um plano de taxas

PATCH/v1/marketplace/plans/{planId}

Autentique com o header SelectKey: a chave sk_test_ opera no sandbox, a sk_live_ em produção. Como autenticar.

Parâmetros do caminho

  • planIdstringobrigatório

    Identificador público (rate_…)

Corpo da requisição

  • pixobject

    A taxa de um meio de pagamento.

    +3 campos de pix
    • fixedinteger

      Taxa fixa por venda, em centavos.

    • percentnumber

      Taxa como percentual da venda (0–100).

    • releaseDaysinteger

      Dias até o dinheiro deste meio ser liberado para a sub-conta (nunca antes de você recebê-lo).

  • namestring

    Nome do plano.

  • debitobject

    A taxa de um meio de pagamento.

    +3 campos de debit
    • fixedinteger

      Taxa fixa por venda, em centavos.

    • percentnumber

      Taxa como percentual da venda (0–100).

    • releaseDaysinteger

      Dias até o dinheiro deste meio ser liberado para a sub-conta (nunca antes de você recebê-lo).

  • boletoobject

    A taxa de um meio de pagamento.

    +3 campos de boleto
    • fixedinteger

      Taxa fixa por venda, em centavos.

    • percentnumber

      Taxa como percentual da venda (0–100).

    • releaseDaysinteger

      Dias até o dinheiro deste meio ser liberado para a sub-conta (nunca antes de você recebê-lo).

  • creditobject

    A taxa das vendas no cartão de crédito, opcionalmente por número de parcelas.

    +4 campos de credit
    • fixedinteger

      Taxa fixa por venda, em centavos.

    • percentnumber

      Taxa como percentual da venda (0–100).

    • releaseDaysinteger

      Dias até o dinheiro deste meio ser liberado para a sub-conta (nunca antes de você recebê-lo).

    • installmentsobject[]

      Taxa por número de parcelas, sobrepondo percent.

      +2 campos de installments
      • nintegerobrigatório

        Número de parcelas.

      • percentnumberobrigatório

        Taxa para esse número de parcelas (0–100).

  • withdrawalFeeinteger

    Taxa fixa cobrada da sub-conta em cada saque, em centavos.

Respostas

200Sucesso
  • idstringobrigatório

    Identificador público (rate_…)

  • pixobjectobrigatório

    A taxa de um meio de pagamento.

    +3 campos de pix
    • fixednumberobrigatório

      Taxa fixa por venda, em centavos.

    • percentnumberobrigatório

      Taxa como percentual da venda.

    • releaseDaysnumberobrigatóriopode ser nulo

      Dias até o dinheiro ser liberado para a sub-conta; null = o seu próprio prazo.

  • namestringobrigatóriopode ser nulo

    Nome do plano.

  • debitobjectobrigatório

    A taxa de um meio de pagamento.

    +3 campos de debit
    • fixednumberobrigatório

      Taxa fixa por venda, em centavos.

    • percentnumberobrigatório

      Taxa como percentual da venda.

    • releaseDaysnumberobrigatóriopode ser nulo

      Dias até o dinheiro ser liberado para a sub-conta; null = o seu próprio prazo.

  • boletoobjectobrigatório

    A taxa de um meio de pagamento.

    +3 campos de boleto
    • fixednumberobrigatório

      Taxa fixa por venda, em centavos.

    • percentnumberobrigatório

      Taxa como percentual da venda.

    • releaseDaysnumberobrigatóriopode ser nulo

      Dias até o dinheiro ser liberado para a sub-conta; null = o seu próprio prazo.

  • creditobjectobrigatório

    A taxa das vendas no cartão de crédito.

    +4 campos de credit
    • fixednumberobrigatório

      Taxa fixa por venda, em centavos.

    • percentnumberobrigatório

      Taxa como percentual da venda.

    • releaseDaysnumberobrigatóriopode ser nulo

      Dias até o dinheiro ser liberado para a sub-conta; null = o seu próprio prazo.

    • installmentsobject[]obrigatóriopode ser nulo

      Taxa por número de parcelas; null quando o mesmo percent vale para todas.

      +2 campos de installments
      • nintegerobrigatório

        Número de parcelas.

      • percentnumberobrigatório

        Taxa para esse número de parcelas.

  • createdAtstringobrigatório

    Quando o recurso foi criado (ISO 8601, UTC).

  • withdrawalFeenumberobrigatóriopode ser nulo

    Taxa fixa cobrada da sub-conta em cada saque, em centavos; null quando não há.

400Requisição inválida (validação)
  • errorobjectobrigatório
    +8 campos de error
    • codestringobrigatório
    • paramsobject[]
    • statusstringobrigatório
    • detailsstring
    • messagestringobrigatório
    • categorystringobrigatório
      Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
    • resourcestringobrigatório
    • statusCodeintegerobrigatório
401Não autenticado (credencial ausente ou inválida)
  • errorobjectobrigatório
    +8 campos de error
    • codestringobrigatório
    • paramsobject[]
    • statusstringobrigatório
    • detailsstring
    • messagestringobrigatório
    • categorystringobrigatório
      Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
    • resourcestringobrigatório
    • statusCodeintegerobrigatório
403Sem permissão
  • errorobjectobrigatório
    +8 campos de error
    • codestringobrigatório
    • paramsobject[]
    • statusstringobrigatório
    • detailsstring
    • messagestringobrigatório
    • categorystringobrigatório
      Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
    • resourcestringobrigatório
    • statusCodeintegerobrigatório
404Não encontrado
  • errorobjectobrigatório
    +8 campos de error
    • codestringobrigatório
    • paramsobject[]
    • statusstringobrigatório
    • detailsstring
    • messagestringobrigatório
    • categorystringobrigatório
      Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
    • resourcestringobrigatório
    • statusCodeintegerobrigatório
422Regra de negócio impede o processamento
  • errorobjectobrigatório
    +8 campos de error
    • codestringobrigatório
    • paramsobject[]
    • statusstringobrigatório
    • detailsstring
    • messagestringobrigatório
    • categorystringobrigatório
      Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
    • resourcestringobrigatório
    • statusCodeintegerobrigatório
500Erro interno do servidor
  • errorobjectobrigatório
    +8 campos de error
    • codestringobrigatório
    • paramsobject[]
    • statusstringobrigatório
    • detailsstring
    • messagestringobrigatório
    • categorystringobrigatório
      Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
    • resourcestringobrigatório
    • statusCodeintegerobrigatório

Preferências de cookies

Hoje o site usa só cookies essenciais: nenhuma ferramenta de medição ou de anúncios está ligada, e nada é compartilhado com terceiros. Se isso mudar, você decide aqui antes de qualquer coisa ser carregada.

  • Mantêm o site funcionando: segurança, a sua escolha sobre cookies e preferências como a versão da documentação. Não dependem de consentimento.

    Sempre ativos