GATE2all Loja

No GATE2all Loja é possível realizar vendas sem a necessidade de desenvolver uma página segura de pagamentos, por meio do recurso chamado Intenção de Venda.

Através deste tipo de integração o comprador digita os dados do cartão no ambiente seguro do gateway de pagamentos GATE2all, isentando a loja, da manipulação dos dados sensíveis do cartão do comprador.

Intenção de Venda
Para realizar uma intenção de venda é necessário enviar um POST para o seguinte recurso:

Requisição
POST /v1/intention

PROPRIEDADE	TIPO	TAMANHO	OBRIGATÓRIO	DESCRIÇÃO
referenceId	Texto	100	Sim	Número de identificação da loja.
amount	Número	16	Sim	Valor da transação sem pontuação. Os dois últimos dígitos são os centavos. (Ex: amount: 100 = R$ 1,00)
description	Texto	300	Não	Descrição da transação.
postBackUrl	Texto	—	Sim	URL onde o GATE2all notificará eventuais status da trancação para o lojista notificação
redirectUrl	Texto	—	Não	URL onde o GATE2all redirecionará o comprador após o processamento da transação.
dtExpiration	Texto	20	Não	Data da expiração da intenção. Formato 2021-01-25T18:10:53
customer.name	Texto	100	Sim	Nome do portador do cartão.
customer.document	Texto	18	Sim	Número do CPF/CNPJ do portador do cartão.
customer.email	Texto	100	Sim	Email do portador do cartão.
customer.phoneNumber	Texto	18	Não	Número de telefone do portador do cartão.
address.address	Texto	60	Sim	Endereço do comprador.
address.number	Texto	10	Sim	Número do endereço do comprador.
address.complement	Texto	150	Não	Complemento do endereço do comprador.
address.district	Texto	80	Sim	Bairro do comprador.
address.zipcode	Número	8	Sim	CEP do comprador sem formatação. Exemplo: 04549002.
address.city	Texto	30	Sim	Cidade do comprador.
address.state	Texto	2	Sim	Sigla do estado do comprador.
card.type	Número	1	Não	Default: 0, configura as opcões disponíveis. 1 Configura cartão de crédito. 2 Configura cartão de débito.
card.capture	Booleano	-	Sim	true = Autoriza e confirma a transação. false = Autorização, mas não confirma a transação, necessitando realizar a confirmação (Captura) noutra requisição.
card.installments	Número	2	Sim	Número de parcelas.
card.fixedInstallments	Booleano	-	Não	Default: false - True = não permite que o comprador selecione a quantidade de parcelas no formulário de pagamento.
card.interestType	Número	1	Não	Default: 3 - Operações disponíveis: 3. Parcelado Loja 4. Parcelado Administrador
card.authenticate	Número	1	Não	Default: 3 - Opções disponíveis: 1. Autorizar só transações autenticadas 2. Autorizar transações autenticadas ou não autenticadas 3. Autorizar sem autenticação
card.softDescriptor	Texto	22	Não	Texto a ser exibido na fatura do portador do cartão.SoftDescriptor
card.saveCard	Booleano	—	Não	Configura salvar o cartão (tokenização).
card.recurrent	Booleano	—	Não	Informa se a transação é recorrente.
electronicTransfer.provider	Texto	20	Sim	Nome da instituição financeira: ITAU
bankSlip.expirationDate	Texto	20	Sim	Data de vencimento do boleto. formato YYYY-MM-DD
bankSlip.instructions	Texto	300	Sim	nstruções do boleto. Para o Itaú a quantidade máxima de caracteres será: 180, e o texto será truncado em 3 partes de 60 caracteres.
bankSlip.guarantor	Texto	45	Sim	Nome do avalista.
bankSlip.provider	Texto	20	Sim	Nome da instituição financeira: BRADESCO ITAU * SANTANDER
pix.provider	Texto	20	Não	Sandbox Nome da instituição financeira: C6BANK
pix.key	Texto	20	Não	Sandbox Campos utilizados para o Pix: RANDOM_KEY (Suportado) EMAIL DOCUMENT PHONE
pix.expirationDateTime	Texto	20	Não	Sandbox Data da expiração da qrcode. Formato 2021-01-25T18:10:53

🚧
Note que para Intenção de Venda de clientes de uma Sub, os dados do customer não serão obrigatórios na intenção, mas serão obrigatórios na autorização. O formulário de checkout já trata caso não tenha os dados do customer.

RESPOSTA SUCESSO

Status : 201

PROPRIEDADE	TIPO	TAMANHO	DESCRIÇÃO
transactionId	Texto	36	Identificador da transação do GATE2all.
url	Texto	150	URL da intenção.

{
  "transactionId": "b9bb32a8-401e-41a0-a9ee-af9e8ab0de92",
  "url": "https://api.gate2all.com.br/v1/payment/b9bb32a8-401e-41a0-a9ee-af9e8ab0de92"
}

RESPOSTA ERRO

Status : 400

PROPRIEDADE	TIPO	TAMANHO	DESCRIÇÃO
DESCRIÇÃO	Texto	50	Texto informando o erro na geração da Intenção de Venda.

{
  "error": {
    "message": "amount nao pode ser vazio"
  }
}

🚧
Redirecione o comprador para a URL da resposta.