Pagar.me v5 · Docs Legacy
Criar assinatura de plano
Fornecemos a possibilidade de criação de uma assinatura (subscription) a partir de plano (plan).
post
https://api.stone.com.br/core/v5/subscriptions
Body
application/json
Body
application/json
codestring
Código da assinatura no sistema da loja. Máx.: 52 caracteres
plan_idstringrequired
Código do plano.
Formato: plan_XXXXXXXXXXXXXXXX
payment_methodstringrequired
Meio de pagamento.
Valores possíveis: credit_card, boleto e debit_card .
start_atstring(date)
Data de início da assinatura.
Se não for informada, a assinatura será iniciada imediatamente.
customer_idstringrequired
Código do cliente.
Obrigatório caso o customer não seja informado. Saiba mais sobre clientes.
customerobjectrequired
Dados do cliente.
Obrigatório caso o customer_id não seja informado. Saiba mais sobre clientes.
Show Child Parameters
cardobjectrequired
Cartão que será utilizado na assinatura.
- card_id é o código do cartão do cliente.
- card_token é token do cartão gerado pelo checkout transparente.
É obrigatório o envio de uma dessas identificações, caso o payment_method seja credit_card ou debit_card.
Saiba mais sobre cartões.
Show Child Parameters
installmentsinteger(int32)
Quantidade de parcelas.
O número de parcelas deverá ser 1 em recorrências.
Default:1
discountsarray[object]
Descontos.
Show Child Parameters
incrementsarray[object]
Incrementos
Show Child Parameters
boleto_due_daysinteger(int32)
Dias para expiração do boleto. (Caso não seja passado, será pego um valor padrão das configurações da loja)
metadatastring
Objeto chave/valor utilizado para armazenar informações adicionais sobre a assinatura.
Saiba mais sobre metadata.
Response
application/json
Response
application/json
200
idstring
Example:sub_bpYjMr9f8sA6QJNg
codestring
Example:XPLMBV9U10
start_atstring
Example:2018-04-04T00:00:00Z
intervalstring
Example:month
interval_countinteger
Default:0
Example:1
billing_typestring
Example:postpaid
current_cycleobject
Show Child Parameters
next_billing_atstring
Example:2018-05-04T00:00:00Z
payment_methodstring
Example:boleto
currencystring
Example:BRL
statement_descriptorstring
Example:Spotify
installmentsinteger
Default:0
Example:1
statusstring
Example:active
created_atstring
Example:2018-04-04T21:36:13Z
updated_atstring
Example:2018-04-04T21:36:13Z
customerobject
Show Child Parameters
planobject
Show Child Parameters
itemsarray[object]
Show Child Parameters
post/subscriptions
Authentication
Body
{
"plan_id": "plan_21r4CTG0ux77Qv13",
"payment_method": "credit_card",
"boleto_due_days": 5,
"customer": {
"name": "Tony Stark",
"email": "tonystark@avengers.com"
},
"card": {
"holder_name": "Tony Stark",
"number": "4532464862385322",
"exp_month": 1,
"exp_year": 30,
"cvv": "903",
"billing_address": {
"line_1": "375, Av. General Justo, Centro",
"line_2": "8º andar",
"zip_code": "20021130",
"city": "Rio de Janeiro",
"state": "RJ",
"country": "BR"
}
},
"discounts": [
{
"cycles": 3,
"value": 10,
"discount_type": "percentage"
}
],
"increments": [
{
"cycles": 2,
"value": 20,
"discount_type": "percentage"
}
],
"metadata": {
"id": "my_subscription_id"
}
}
application/json
Listar assinaturas
Este recurso permite listar as assinaturas. Pode ser utilizados alguns parâmetros como filtro da listagem.
get
https://api.stone.com.br/core/v5/subscriptions
Query Parameters
statusstring
Status da assinatura.
Valores possíveis: active, canceled ou future
codestring
Código da assinatura no sistema da loja. Máx.: 52 caracteres
billing_typestring
Tipo de cobrança.
Valores possíveis: prepaid, **postpaid **ou exact_day.
customer_idstring
Código do cliente. Saiba mais sobre clientes.
plan_idstring
Código do plano.
Formato: plan_XXXXXXXXXXXXXXXX.
card_idstring
Código do cartão.
Formato: card_XXXXXXXXXXXXXXXX.
next_billing_sincestring(date)
Data de início da próxima data de cobrança.
next_billing_untilstring(date)
Data final de próxima data de cobrança.
created_sincestring(date)
Data de início do período de criação a ser listado.
created_untilstring(date)
Data final do período de criação a ser listado.
pageinteger(int32)
Página atual
Default:1
sizeinteger(int32)
Quantidade de itens por página.
Default:10
Response
application/json
Response
application/json
200
dataarray[object]
Show Child Parameters
pagingobject
Show Child Parameters
get/subscriptions
Authentication
Query Parameters
application/json
Obter assinatura com split
Este recurso possibilita, através do identificador da assinatura (subscription_id), recuperar as informações da assinatura com Split.
get
https://api.stone.com.br/core/v5/subscriptions/{subscription_id}
Path Parameters
subscription_idstringrequired
Código da Assinatura.
Formato: sub_XXXXXXXXXXXXXXXX.
Response
application/json
Response
application/json
200
object
get/subscriptions/{subscription_id}
Authentication
Path Parameters
application/json
Cancelar assinatura
Com o verbo HTTP DELETE, através do identificador da assinatura (subscription_id) é possível cancelar a assinatura.
delete
https://api.stone.com.br/core/v5/subscriptions/{subscription_id}
Path Parameters
subscription_idstringrequired
Código da assinatura.
Formato: sub_XXXXXXXXXXXXXXXX.
Body
application/json
Body
application/json
cancel_pending_invoicesboolean
Parâmetro que define se as cobranças e faturas pendentes dentro de uma assinatura serão canceladas automaticamente com a execução do cancelamento da assinatura
Default:true
Response
application/json
Response
application/json
200
idstring
Example:sub_WeEMlp2FXFMjVq3Q
codestring
Example:8YNU49TD4Z
start_atstring
Example:2018-04-05T00:00:00Z
intervalstring
Example:month
interval_countinteger
Default:0
Example:1
billing_typestring
Example:postpaid
boleto_due_daysinteger
Default:0
Example:5
current_cycleobject
Show Child Parameters
setupobject
Show Child Parameters
next_billing_atstring
Example:2018-04-05T00:00:00Z
payment_methodstring
Example:boleto
currencystring
Example:BRL
statement_descriptorstring
Example:Spotify
installmentsinteger
Default:0
Example:1
statusstring
Example:canceled
created_atstring
Example:2018-04-05T03:20:16Z
updated_atstring
Example:2018-04-05T12:14:06Z
canceled_atstring
Example:2018-04-05T12:14:06Z
customerobject
Show Child Parameters
planobject
Show Child Parameters
itemsarray[object]
Show Child Parameters
delete/subscriptions/{subscription_id}
Authentication
Path Parameters
Body
{}
application/json
Editar cartão da assinatura
Com o verbo HTTP PATCH, através do identificador da assinatura (subscription_id) é possível atualizar o cartão utilizado para pagamento da assinatura.
patch
https://api.stone.com.br/core/v5/subscriptions/{subscription_id}/card
Path Parameters
subscription_idstringrequired
Código da assinatura.
Formato: sub_XXXXXXXXXXXXXXXX.
Body
application/json
Body
application/json
card_idstring
Código do cartão.
Formato: card_XXXXXXXXXXXXXXXX.
cardstring
Dados do novo cartão.Saiba mais sobre cartões
Response
application/json
Response
application/json
200
idstring
Example:sub_WeEMlp2FXFMjVq3Q
codestring
Example:8YNU49TD4Z
start_atstring
Example:2018-04-05T00:00:00Z
intervalstring
Example:month
interval_countinteger
Default:0
Example:1
billing_typestring
Example:postpaid
boleto_due_daysinteger
Default:0
Example:5
current_cycleobject
Show Child Parameters
setupobject
Show Child Parameters
next_billing_atstring
Example:2018-05-05T00:00:00Z
payment_methodstring
Example:credit_card
currencystring
Example:BRL
statement_descriptorstring
Example:Spotify
installmentsinteger
Default:0
Example:1
statusstring
Example:active
created_atstring
Example:2018-04-05T03:20:16Z
updated_atstring
Example:2018-04-05T03:20:16Z
customerobject
Show Child Parameters
cardobject
Show Child Parameters
planobject
Show Child Parameters
itemsarray[object]
Show Child Parameters
patch/subscriptions/{subscription_id}/card
Authentication
Path Parameters
Body
{
"card": {
"number": "4532912167490007",
"holder_name": "Tony Stark",
"exp_month": 6,
"exp_year": 30,
"cvv": "474",
"billing_address": {
"line_1": "375, Av. General Justo, Centro",
"line_2": "8º andar",
"zip_code": "20021130",
"city": "Rio de Janeiro",
"state": "RJ",
"country": "BR"
}
}
}
application/json