Autorização

post

https://payments.stone.com.br/v1/charges

Criação de uma nova cobrança.

📘
Header Host conforme o modelo de negócio
Para atender às regras específicas de autenticação, descritas neste link, é necessário que o Header Host das suas requisições seja ajustado de acordo com o seu modelo de negócio.
Se você é um Gateway de Pagamentos, utilize o Header Host:
ecommerce-payments.stone.com.br
Se você é uma Subadquirente, utilize o Header Host:
payments.stone.com.br

Body Params

payment_method

string

enum

required

Payment method da charge

Allowed:

amount

int64

required

Valor requisitado na cobrança em centavos.

currency_code

string

length between 3 and 3

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).

initiator_id

string

required

length ≤ 123

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

reference_id

string

length ≤ 128

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

local_datetime

string

required

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

channel

string

enum

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:

card_transaction

object

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

sub_merchant

object

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

initiator

object

Indicador de inicialização de transação

first_transaction

object

Dados relacionados a transação original.

partner_platform_id

string

Identificador do cliente em provedores externos.

print_line_size

int32

1 to 999

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

payee

object

Dados para transações de aporte de recursos.

customer

object

Dados do cliente que está realizando a compra.

items

array of objects

Lista de itens da compra.

items

Headers

Host

string

required

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)

Responses

📘Header Host conforme o modelo de negócio

200OK

400BadRequest

401Não autorizado

📘
Header Host conforme o modelo de negócio