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