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:

  1. Parcelado Loja
  2. 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.


What’s Next
Did this page help you?