PaystationdocsPaystation

Update one of your offers; only the fields sent change ​

POST /v1/offers/{id}

Update one of your offers; only the fields sent change

POST/v1/offers/{id}

Autenticação

  • Chave secretask_…, só no seu servidor

Envie a chave no cabeçalho Authorization: Bearer <chave>.

Parâmetros

  • idstring · path (uuid)obrigatório

Corpo da requisição

  • offer_idstring
  • offer_typestring

    Valores: defaultsubscription

  • titlestring
  • descriptionstringpode ser null
  • priceinteger
  • payment_methodsarray of string

    Valores: cardpixboleto

  • installmentsinteger
  • statusstring

    Valores: publishedarchived

  • subscriptionobject
    Mostrar campos de subscription
    • cyclesinteger
    • amountintegerpode ser null

Resposta

200OK

  • idstring (uuid)obrigatório
  • offer_idstringpode ser nullobrigatório
  • titlestringpode ser nullobrigatório
  • descriptionstringpode ser nullobrigatório
  • offer_typestringobrigatório
  • priceintegerpode ser nullobrigatório

    Integer cents: R$ 99,90 is `9990`.

  • payment_methodsarray of stringobrigatório

    Valores: cardpixboleto

  • document_typesarray of stringobrigatório

    `cpf` is always accepted.

  • subscriptionobjectpode ser nullobrigatório

    Only for `offer_type: subscription`. `GET /v1/offers/{id}/checkout` answers what the charge uses.

    Mostrar campos de subscription
    • cyclesintegerpode ser nullobrigatório

      Renewals after the first payment: the plan has `cycles + 1` payments. `null` or below 1: the offer cannot be sold.

    • amountintegerpode ser nullobrigatório

      Integer cents charged per renewal.

  • statusstringpode ser nullobrigatório

    `published` is sellable. A secret key also reads its offers in other statuses (`archived`, `draft`); a public key only `published` ones.

Erros

400The request path could not be decoded (`malformed_path`).
401Missing or invalid key, or a public key (`secret_key_required`).
404Not found, not yours, or not a well-formed id.
422The body is invalid (`invalid_param`, `unknown_parameter`), the offer it leaves could not be sold (`invalid_param`, naming the field), its price would fall under an order bump that sells it (`invalid_param` on `price`; `resource_id` names that bump's main offer), or this account serves its offers from its own webhook (`unsupported_integration`).
429Rate limited.
500Unexpected error, or `api_unavailable`.

Todo erro vem no mesmo envelope: error.type, error.code, error.message e error.request_id, também devolvido no cabeçalho X-Request-Id.