Stone Online · API (Legado)

1.0.0OAS 3.0

API transacional Stone Online — autorização, captura, cancelamento e consulta de cobranças, verificação de cartão.

Documentação legada importada de online.stone.com.br/reference — preservada como referência para integrações antigas. Para projetos novos, use a API Unificada Stone.

API Base URL
  • Server 1:https://payments.stone.com.br/v1

    Payment API Production Server

Security
bearer_auth (http)

Provide your bearer token in the Authorization header when making requests to protected resources.

Example: Authorization: Bearer 123

Additional Information
Contact Suporte Stone

Charges

/charges

Criação de uma nova cobrança.

A autenticação no endpoint é feita da seguinte forma:

  • Bearer Token Authorization: Token JWT.
post
https://payments.stone.com.br/v1/charges

Headers

Hoststringrequired

Domínio utilizado para processar a requisição. Neste caso, determina o ambiente do serviço, podendo ter os valores:

  • payments.stone.com.br: ambiente produtivo
  • sdx-payments.stone.com.br: ambiente de sandbox (pré-produção)

Body

application/json

PostChargeRequest

payment_methodstringrequired

Payment method da charge

Allowed values:card

amountinteger(int64)required

Valor requisitado na cobrança em centavos.

currency_codestring

Código da moeda de autorização da transação. Padrão ISO 3 dígitos. Quando não informado será considerado o valor default 986 (BRL).

>= 3 characters<= 3 characters

initiator_idstringrequired

Identificador externo (cliente) que pode ser utilizado em reversões e consultas.

<= 123 characters

reference_idstring

Identificador externo, geralmente relacionado a um pedido ou outra referência do cliente, apenas em fluxos informacionais.

<= 128 characters

local_datetimestring(yyyy-MM-ddTHH:mm:ss)required

Data e hora da operação utilizando o fuso horário do local do dispositivo no formato ISO8601.

channelstring

Canal de interação utilizado pelo cliente na inicialização da transação:

  • standalone_device - Dispositivos que processam a transação de forma autônoma e direta (ex. POS).
  • standalone_mobile - Dispositivos mobile que processam a transação de forma autônoma e direta (ex. TapPhone).
  • website - Transações realizadas via ecommerce.
  • app - Transações realizadas via aplicativo.
  • payment_link - Obrigatório para transações realizadas através de link de pagamento.

Allowed values:standalone_devicestandalone_mobilewebsiteapppayment_link

card_transactionobject

Informações específicas para transações utilizando o método de pagamento cartão

Show Child Parameters
sub_merchantobject

Dados do cliente que possui o cadastro com a adquirente e está utilizando um facilitador de pagamento.

Show Child Parameters
initiatorobject

Indicador de inicialização de transação

Show Child Parameters
first_transactionobject

Dados relacionados a transação original.

Show Child Parameters
partner_platform_idstring

Identificador do cliente em provedores externos.

print_line_sizeinteger(int32)

Limite máximo de caracteres por linha na impressão da filipeta.

>= 1<= 999

payeeobject

Dados para transações de aporte de recursos.

Show Child Parameters
customerobject

Dados do cliente que está realizando a compra.

Show Child Parameters
itemsarray[object]

Lista de itens da compra.

Show Child Parameters

Response

application/json

OK

PostChargeResponse

idstringrequired

Identificador único da cobrança.

initiator_idstringrequired

Identificador externo (cliente) que pode ser utilizado em reversões e consultas.

reference_idstring

Identificador externo, geralmente relacionado a um pedido ou outra referência do cliente, apenas em fluxos informacionais.

amountinteger(int64)required

Valor requisitado na cobrança em centavos.

payment_methodstringrequired

Meio de pagamento da cobrança.

Allowed values:card

statusstringrequired

Status atual da Charge

Allowed values:authorizedpaidcanceleddeclined

created_atstring(yyyy-MM-ddTHH:mm:ssZ)required

Data e hora da criação da cobrança no formato ISO8601.

card_transactionobject
Show Child Parameters
post/charges

Body

{ "amount": 923, "initiator_id": "1470375860-3.19.3.3-RG0DA3-0001", "local_datetime": "2023-07-15T10:53:16", "payment_method": "card", "card_transaction": { "type": "credit", "operation_type": "auth_and_capture", "installments": 3, "installments_type": "merchant", "statement_descriptor": "loja teste", "card": { "entry_mode": "magstripe", "expiration_date": "2608", "number": "4705980000007171", "cvv": "111", "holder_name": "TONY STARK" }, "authentication": { "type": "offline_pin" } } }
 
application/json