Anexar produtos à assinatura

Anexa produtos a uma assinatura já criada. Eles passam a ser cobrados junto do plano a partir da cobrança seguinte. Para que os produtos entrem já na primeira cobrança, envie-os no campo products na criação da assinatura.

application/json

Request Body required

Descreve os dados a serem incluídos no corpo da requisição.

products object[] required
Os produtos a anexar à assinatura.
Array [
identifier string required
Possible values: <= 50 characters
O nome do produto, como aparece na cobrança.
value integer required
O valor do produto, em centavos.
name string
Possible values: <= 191 characters
Opcional. O que o cliente lê na cobrança. O identifier é a chave pela qual o produto é removido, então costuma ser um valor técnico; o name é o rótulo apresentável. Sem name, o identifier continua sendo exibido.
]

Responses

• 200
• 401
• 422
• 500

---

Produtos anexados com sucesso

application/json

Schema

Example (from schema)

---

Schema

subscription object

id integer

O id da assinatura.

uuid uuid

O id publico da assinatura. Esse id pode ser usado para levar o cliente a página de checkout para pagamento.

amount number

O valor da assinatura em centavos.

plan_id number

O id do plano.

status SubscriptionStatus

Possible values: [new, trial, active, overdue, canceled, expired, paused]

O status da assinatura.

created_at date-time

Data de criação.

customer object

id integer required

O id do cliente na NinePay. Obrigatório se os demais dados do usuário não forem informados

name string required

O nome do cliente. Obrigatório se o id não for informado

email string required

O email do cliente. Obrigatório se o id não for informado

cpf string required

O cpf do cliente. Obrigatório se o id ou o cnpj não forem informados

cnpj string required

O cnpj do cliente. Obrigatório se o id ou o cpf não forem informados

phone string

O telefone do cliente

cep string

O CEP do cliente

address string

O endereço do cliente

number string

O endereço do cliente

district string

O bairro do cliente

city string

A cidade do cliente

state string

O estado do cliente

country string

O código do país do cliente, no formato Alpha 2 de acordo com a ISO 3166.

{
  "subscription": {
    "id": 42,
    "uuid": "8b2cad02-06f0-42be-84ac-101b23a1bb0d",
    "amount": 2500,
    "plan_id": 2500,
    "status": "credit",
    "created_at": "2017-07-21 05:20:00"
  },
  "customer": {
    "id": 42,
    "name": "Jhon Doe",
    "email": "jhon@doe.com",
    "cpf": "833.828.600-15",
    "cnpj": "95.135.209/0001-79",
    "phone": "(11) 11111-1111",
    "cep": "01423-910",
    "address": "Rua José Maria Lisboa",
    "number": 42,
    "district": "Jardim Paulista",
    "city": "São Paulo",
    "state": "SP",
    "country": "BR"
  }
}

Não autorizado

application/json

Schema

Example (from schema)

Example

---

Schema

message string required

{
  "message": "string"
}

{
  "message": "Unauthenticated"
}

Erro na validação de dados

application/json

Schema

Example (from schema)

Example

---

Schema

message string required
errors object
property name* string

{
  "message": "string",
  "errors": {}
}

{
  "message": "The given data was invalid.",
  "errors": {
    "name": "The name field is required."
  }
}

Houve um erro inesperado

application/json

Schema

Example (from schema)

Example

---

Schema

message string required

{
  "message": "string"
}

{
  "message": "An unexpected error occurred"
}

Loading...