Stone

A loja tem a possibilidade de configurar o roteamento de transações feitas no Carat por vários meios de pagamento, um desses meios é o e-commerce Stone, daqui em diante citado como StoneWS.

Nesta página será usada a nomenclatura "StoneWS" para referenciar o roteamento no Carat.

Interfaces Carat suportadas para integração#

É possível utilizar as seguintes interfaces para a integração com o roteamento StoneWS:

Pagamento REST
Pré-Autorização REST
Cancelamento REST
Pagamento HTML
Pré-Autorização HTML

Autorizadoras permitidas#

Para maiores informações sobre quais autorizadoras são permitidas pela StoneWS, por favor, entrar em contato com a mesma.

Credenciais necessárias#

Para começar a transacionar com a StoneWS, a loja deve obter o SAK(Sale Affliation Key), chave para integração no ambiente da Stone. Para isso, a loja deve solicitar sua credencial de acesso através do e-mail integracoes@stone.com.br, com as seguintes informações:

O nome da empresa parceira que realizará transações na Stone
O CNPJ da empresa
Uma descrição sucinta do negócio parceiro (em uma frase)
E-mail para onde a credencial deve ser enviada

Após recebimento, o lojista deve encaminhar o SAK(Sale Affliation Key) para a equipe produção da Software Express. Esses dados podem ser cadastrados também no Portal do Lojista do Carat no item de menu Configurar Autorizadoras.

Campo	Descrição	Tipo
`salesAffiliationKey`	Identificação do estabelecimento Comercial na adquirente Stone.	AN

Cancelamento#

O cancelamento pode ser feito do valor parcial ou total das seguintes formas:

Através do Cancelamento REST
Através do Portal do Lojista

Subadquirência#

A subadquirência é um recurso opcional e sua habilitação é feita inicialmente no cadastro da loja na StoneWS, e em paralelo, no sistema administrativo do Carat.

O lojista deve solicitar à equipe de atendimento a habilitação da subadquirência StoneWS no sistema administrativo do Carat.

Dados cadastrais necessários para subadquirência#

Uma vez que a loja tenha a subadquirência habilitada, as seguintes informações sobre a loja devem ser cadastradas no sistema administrativo do Carat:

Campo	Descrição	Formato
`País`	Código de país da Loja	= 3 A
`Estado`	Estado da Loja	= 2 A
`Cidade`	Cidade da Loja	< 25 A
`CEP`	CEP da Loja	< 9 N
`SoftDescriptor`	Descrição resumida que será apresentada na fatura do portador do cartão (mais detalhes no item SoftDescriptor).	< 30 AN

Todos os dados descritos serão enviados à StoneWS em todas as transações, assim que a subadquirência seja habilitada.

MCC dinâmico#

Adicionalmente, o lojista pode alterar o MCC (Merchant Category Code) dinamicamente em transações que envolvam subadquirência. Caso o MCC não seja enviada nas transações, será considerado o MCC padrão definido no cadastro da loja na StoneWS. O MCC dinâmico pode ser enviado conforme os itens a seguir.

Campo	Descrição	Formato
`MCC`	Merchant Category Code - código que indica a categoria do merchant	= 4 N

Os valores possíveis de MCC podem ser consultados em uma página descritiva da Stone http://credenciamento.stone.com.br/docs/mcc (link ativo em 2017/09/15) ou pela ISO - 18245.

O campo mcc está descrito em: Serviço de efetivação de pagamento