Sign in

v1

latestOpenAPI 3.0.32026-07-265974.7 KB
Cards

Validação de um novo cartão.<br><br> A autenticação no endpoint é feita da seguinte forma:

  • Bearer Token Authorization: Token JWT.
post/cards/verify

Headers

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

Request body

type'credit' | 'debit' | 'voucher' required

Tipo de cartão está sendo utilizado na cobrança.

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.

initiator_idstring required

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.

statement_descriptorstring

Informação adicional apresentada na filipeta para o comprador final. Em geral o nome fantasia do cliente.

merchant_category_codestring

Código de categoria do lojista ou sublojista relacionado à cobrança.

Response

OK

idstring required

Identificador único da validação.

initiator_idstring required

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.

status'authorized' | 'declined' required

Status atual da validação

result'success' | 'failed' required

Resultado da operação de validação

created_atstring yyyy-MM-ddTHH:mm:ssZ required

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

transaction_idstring required

Identificador da transação emitido pelo provedor (Adquirente).

operation_idstring

Identificador da operação gerado pela adquirente.

authorization_codestring

Código de autorização.

acquirer_messagestring

Mensagem de resultado da operação retornada pela adquirente.

acquirer_return_codestring required

Código de resultado da operação retornado pela adquirente.