Pagar.me v5 · Docs Legacy
Editar metadados da fatura
Com o verbo HTTP PATCH, através do identificador da fatura (invoice_id) é possível atualizar o objeto metadata da fatura.
patch
https://api.stone.com.br/core/v5/invoices/{invoice_id}/metadata
Path Parameters
invoice_idstringrequired
Código da fatura.
Formato: in_XXXXXXXXXXXXXXXX.
Body
application/json
Body
application/json
metadatastringrequired
Objeto chave/valor utilizado para armazenar informações adicionais sobre a fatura.
Saiba mais sobre metadata
Response
application/json
Response
application/json
200
idstring
Example:in_l9JGwX1MsNS3g614
codestring
Example:X8J8HG6HR3
urlstring
Example:/invoices/in_l9JGwX1MsNS3g614
amountinteger
Default:0
Example:1490
statusstring
Example:paid
payment_methodstring
Example:credit_card
due_atstring
Example:2017-08-10T00:00:00Z
created_atstring
Example:2017-08-10T16:02:40Z
itemsarray[object]
Show Child Parameters
customerobject
Show Child Parameters
subscriptionobject
Show Child Parameters
cycleobject
Show Child Parameters
chargeobject
Show Child Parameters
metadataobject
Show Child Parameters
patch/invoices/{invoice_id}/metadata
Authentication
Path Parameters
Body
{
"metadata": {
"code": "1234",
"company": "Avengers"
}
}
application/json
Renovar ciclo
Através do identificador da assinatura (subscription_id) é possível renovar o ciclo de uma assinatura. A utilização do método irá sempre renovar o ciclo à frente. Para Listar os ciclos de uma assinatura, acesse Listar Ciclos.
post
https://api.stone.com.br/core/v5/subscriptions/{subscription_id}/cycles
Path Parameters
subscription_idstringrequired
Código da assinatura.
Response
application/json
Response
application/json
200
idstring
Example:cycle_Qal5a0LCpphoDpnR
billing_atstring
Example:2019-04-30T00:00:00Z
cycleinteger
Default:0
Example:1
start_atstring
Example:2019-04-30T00:00:00Z
end_atstring
Example:2019-07-29T23:59:59Z
durationinteger
Default:0
Example:7862399
created_atstring
Example:2019-04-30T18:09:32Z
updated_atstring
Example:2019-04-30T18:12:20Z
statusstring
Example:billed
post/subscriptions/{subscription_id}/cycles
Authentication
Path Parameters
application/json
Listar ciclos
Este recurso permite listar os ciclos associados a uma assinatura. Podem ser utilizados alguns parâmetros como filtro da listagem.
get
https://api.stone.com.br/core/v5/subscriptions/{subscription_id}/cycles
Query Parameters
idstring
Código do ciclo. Formato: cycle_XXXXXXXXXXXXXXXX.
billing_atstring(date)
Data de cobrança do ciclo
cyclestring
Quantidade de ciclos na assinatura
start_atstring
Data de início do ciclo
end_atstring
Data final do ciclo
durationstring
created_atstring
Data de criação da assinatura
updated_atstring(date)
Data de atualização do ciclo da assinatura.
statusstring
Status dos ciclos. Valores possíveis: billed ou unbilled
Path Parameters
subscription_idstringrequired
Código da assinatura.
Response
application/json
Response
application/json
200
dataarray[object]
Show Child Parameters
pagingobject
Show Child Parameters
get/subscriptions/{subscription_id}/cycles
Authentication
Path Parameters
Query Parameters
application/json
Obter ciclo
Através do identificador do ciclo (cycle_id) é possível recuperar as informação do ciclo de uma assinatura.
get
https://api.stone.com.br/core/v5/subscriptions/{subscription_id}/cycles/{cycle_id}
Path Parameters
subscription_idstringrequired
Código da assinatura.
cycle_idstringrequired
Código do ciclo. Formato: cycle_XXXXXXXXXXXXXXXX.
Response
application/json
Response
application/json
200
idstring
Example:cycle_Qal5a0LCpphoDpnR
billing_atstring
Example:2019-04-30T00:00:00Z
cycleinteger
Default:0
Example:1
start_atstring
Example:2019-04-30T00:00:00Z
end_atstring
Example:2019-07-29T23:59:59Z
durationinteger
Default:0
Example:7862399
created_atstring
Example:2019-04-30T18:09:32Z
updated_atstring
Example:2019-04-30T18:09:33Z
statusstring
Example:billed
get/subscriptions/{subscription_id}/cycles/{cycle_id}
Authentication
Path Parameters
application/json
Editar regras do Split
Com o verbo HTTP PATCH, através do identificador da assinatura (subscription_id) é possível ativar, desativar ou alterar as regras do split na recorrência.
Para realizar a edição tem que ser enviado pelo menos um dos campos, enabled ou rules, ambos campos são opcionais e independentes.
patch
https://api.stone.com.br/core/v5/subscriptions/{subscription_id}/split
Path Parameters
subscription_idstringrequired
Código da Assinatura.
Formato: sub_XXXXXXXXXXXXXXXX.
Body
application/json
Body
application/json
enabledboolean
Ativa ou desativa as regras de split na assinatura. Pode ser true ou False
rulesarray[object]
Show Child Parameters
Response
application/json
Response
application/json
200
idstring
Example:sub_WpkrQvNriRs6QKGz
codestring
Example:EP13T6I0KR
start_atstring
Example:2022-01-12T00:00:00Z
intervalstring
Example:month
interval_countinteger
Default:0
Example:1
billing_typestring
Example:postpaid
current_cycleobject
Show Child Parameters
next_billing_atstring
Example:2022-02-14T00:00:00Z
payment_methodstring
Example:credit_card
currencystring
Example:BRL
installmentsinteger
Default:0
Example:1
statusstring
Example:active
created_atstring
Example:2022-01-12T15:22:04Z
updated_atstring
Example:2022-01-12T15:59:58Z
customerobject
Show Child Parameters
cardobject
Show Child Parameters
itemsarray[object]
Show Child Parameters
splitobject
Show Child Parameters
metadataobject
Show Child Parameters
patch/subscriptions/{subscription_id}/split
Authentication
Path Parameters
Body
{}
application/json