Obter item do pedido

Obter um item especifico dentro de um pedido especifico.

get
https://api.stone.com.br/core/v5/orders/{order_id}/items/{item_id}

Path Parameters

order_idstringrequired

Código do pedido.

item_idstringrequired

Código do item do pedido.

Response

application/json

200

idstring

Example:oi_gJ4RZVujNFDVRwpn

descriptionstring

Example:Chaveiro do Tesseract

amountinteger

Default:0

Example:2990

quantityinteger

Default:0

Example:1

statusstring

Example:active

created_atstring

Example:2017-12-18T16:49:43Z

updated_atstring

Example:2017-12-18T16:49:43Z

orderobject
Show Child Parameters
get/orders/{order_id}/items/{item_id}
 
application/json

Capturar cobrança com split

Rota para capturar uma cobrança com split, definindo a regra de split e os recebedor que irão participar da divisão dos pagamentos.

post
https://api.stone.com.br/core/v5/charges/{charge_id}/capture

Path Parameters

charge_idstringrequired

Código da cobrança.

Body

application/json
amountinteger(int32)

Valor a ser capturado. Caso não seja informado, será considerado o valor total da cobrança.

splitarray[object]

Lista de regras de split.

Show Child Parameters

Response

application/json

200

idstring

Example:ch_WOoyJ6u3kUzGyj46

codestring

Example:G11LT7MHVL

gateway_idstring

Example:3910377

amountinteger

Default:0

Example:100

paid_amountinteger

Default:0

Example:100

statusstring

Example:paid

currencystring

Example:BRL

payment_methodstring

Example:credit_card

paid_atstring

Example:2018-07-11T17:08:54Z

canceled_atstring

Example:2018-07-11T17:09:04Z

created_atstring

Example:2018-07-11T17:08:52Z

updated_atstring

Example:2018-07-11T17:09:04Z

customerobject
Show Child Parameters
last_transactionobject
Show Child Parameters
metadataobject
Show Child Parameters
post/charges/{charge_id}/capture

Body

{ "amount": 100, "split": [ { "amount": 50, "recipient_id": "rp_5yGwpMGckBHVYmb6", "type": "percentage", "options": { "charge_processing_fee": true, "charge_remainder_fee": true, "liable": true } }, { "amount": 50, "type": "percentage", "recipient_id": "rp_yLnAyVpHbQIqZxwO", "options": { "charge_processing_fee": false, "charge_remainder_fee": false, "liable": false } } ] }
 
application/json

Obter cobrança

get
https://api.stone.com.br/core/v5/charges/{charge_id}

Path Parameters

charge_idstringrequired

Código da cobrança.

Response

application/json

200

One Of
idstring

Example:ch_6NXoYXyiNfP3A54l

codestring

Example:ABCDE123

amountinteger

Default:0

Example:1490

paid_amountinteger

Default:0

Example:1490

statusstring

Example:paid

currencystring

Example:BRL

payment_methodstring

Example:credit_card

paid_atstring

Example:2019-01-22T14:31:36Z

created_atstring

Example:2019-01-22T14:30:12Z

updated_atstring

Example:2019-01-22T14:31:36Z

customerobject
Show Child Parameters
last_transactionobject
Show Child Parameters
metadataobject
Show Child Parameters
get/charges/{charge_id}
 
application/json

Cancelar cobrança

Rota para cancelar uma cobrança. O corpo é opcional: amount define o valor a cancelar (sem ele, vale o total da cobrança), bank_account é obrigatório apenas no estorno de boleto e split define as regras de split e os recebedores que irão participar da divisão dos pagamentos.

delete
https://api.stone.com.br/core/v5/charges/{charge_id}

Path Parameters

charge_idstringrequired

Código da cobrança.

Body

application/json
amountinteger(int32)

Valor a ser cancelado. Caso não seja informado, será considerado o valor total da cobrança.

splitarray[object]

Lista de regras de split.

Show Child Parameters
bank_accountobject

Dados da conta bancária do comprador. Somente utilizado para estorno de boleto, onde é um parâmetro obrigatório.

Show Child Parameters

Response

application/json

200

One Of
idstring

Example:ch_bz6VONxuriWqXY0l

codestring

Example:Q7KA3GIZDV

gateway_idstring

Example:7628472

amountinteger

Default:0

Example:200

paid_amountinteger

Default:0

Example:200

canceled_amountinteger

Default:0

Example:200

statusstring

Example:canceled

currencystring

Example:BRL

payment_methodstring

Example:credit_card

paid_atstring

Example:2020-01-16T15:14:27Z

canceled_atstring

Example:2020-01-16T16:03:49Z

created_atstring

Example:2020-01-16T15:14:21Z

updated_atstring

Example:2020-01-16T16:03:49Z

orderobject
Show Child Parameters
customerobject
Show Child Parameters
last_transactionobject
Show Child Parameters
delete/charges/{charge_id}

Body

{}
 
application/json

Editar cartão de cobrança

Esse recurso só pode ser chamado quando o cartão a ser editado teve a transação não autorizada.

patch
https://api.stone.com.br/core/v5/charges/{charge_id}/card

Path Parameters

charge_idstringrequired

Código da cobrança.

Body

application/json
update_subscriptionstring

Indica se o cartão da assinatura deve ser atualizado

Default:false

card_idstring

Código do cartão.

cardobject

Dados do cartão. Saiba mais sobre cartões.

Show Child Parameters
card_tokenstring

Token do cartão

initiated_typestring

Identificador do tipo de transação avulsa. Valores possíveis: partial_shipment (Remessa Parcial), related_or_delayed_charge (Cobrança Atrasada), no_show (Multa) ou retry (Retentativa). Mais detalhes.

recurrence_modelstring

Identificador do tipo de recorrência. Valores possíveis: standing_order (Ordem Permanente), instalment (Parcelamento) ou subscription (Assinatura convencional com valor e frequência fixa). Mais detalhes.

payment_originobject

Identificador da primeira cobrança de uma recorrência. Mais detalhes.

Show Child Parameters

Response

application/json

200

idstring

Example:ch_B4rpRdfBxsVv0NQo

codestring

Example:98ZZUL0F8Z

amountinteger

Default:0

Example:1490

paid_amountinteger

Default:0

Example:1490

statusstring

Example:paid

currencystring

Example:BRL

payment_methodstring

Example:credit_card

paid_atstring

Example:2019-01-22T14:40:47Z

created_atstring

Example:2019-01-22T14:39:35Z

updated_atstring

Example:2019-01-22T14:40:47Z

customerobject
Show Child Parameters
last_transactionobject
Show Child Parameters
metadataobject
Show Child Parameters
patch/charges/{charge_id}/card

Body

{ "card": { "number": "4000000000000010", "holder_name": "Tony Stark", "exp_month": 1, "exp_year": 30, "cvv": "3531", "billing_address": { "line_1": "10880, Malibu Point, Malibu Central", "zip_code": "90265", "city": "Malibu", "state": "CA", "country": "US" } } }
 
application/json