API Reference

Flashlink

Gera um Flashlink de acesso ao checkout de pagamento.

Gerar Link: Flashlink

Gera um link (Flashlink), adaptando-se aos parâmetros específicos fornecidos na requisição, incluindo valores, quantidade de pagamentos que o link poderá receber, quantidade de parcelas e outros detalhes essenciais que serão abordados a seguir.

Como implementar:

Primeiramente, é necessário passar o token API do estabelecimento no header "Authorization" juntamente com a adição do Content-type: application/json. Esse token é disponibilizado através do Suporte. Os contatos estão disponibilizados em nossa página Fix Pay.

Abaixo temos um exemplo de como inserir o Header usando JSON.

{
 "Authorization": "Bearer 125SEBXXXXXX20150821",
  "Content-type": "application/json"
}

Como o método usado é o POST, devemos inserir os dados no body da requisição.

Abaixo temos um exemplo de como inserir estes dados usando JSON.

{
  "client_name": "maria",
  "client_email": "[email protected]",
  "client_phone": "(85)9484848484",
  "amount": 10.00,
  "freight": true,
  "amount_freight": 5.99,
  "installments":"2",
  "description": "Bolo de aniversário",
  "CreditOrDebit": "CREDIT"
}

📘

Aviso!

A descrição e o tipo de cada parâmetro estão especificados mais abaixo no tópico Testar Rota.

Exemplo:

Agora, veremos um exemplo da requisição feita em JavaScript e seu resultado.

const options = {
  method: 'POST',
  headers: {
    accept: 'application/json',
    Authorization: 'Bearer 125SEBXXXXXX20150821',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
   {
  "client_name": "maria",
  "client_email": "[email protected]",
  "client_phone": "859484848484",
  "amount": 10.00,
  "freight": true,
  "amount_freight": 5.99,
  "installments":"2",
  "description": "Bolo de aniversário",
  "CreditOrDebit": "CREDIT"
}

fetch('https://apis.fixpay.com.br/v1/link/12312313', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

O resultado desta requisição é um JSON contendo o link do checkout de pagamento, no parametro "link", que deve ser enviado ao cliente. Além disso, os caracteres presentes após a última barra ("/") são identificados como o token do link de pagamento.

{
    "link": "https://gateway.fixpay.com.br/payment/be58202a-85c9-49b7-ad72-a4e7ed123d73",
}

Ao acessar o link, terá 1 tela para o cliente realizar o pagamento.

Identificação do comprador e pagamento:

Basta o cliente preencher os dados que o pagamento será confirmado

Testar rota

Abaixo, você poderá testar a rota em produção, passando os valores nos parâmetros conforme sua descrição e tipo. Na lateral direita da tela, você poderá ver o código da requisição em várias linguagens diferentes e sua resposta. Além disso, na parte de resposta da requisição, você poderá ver todos os possíveis retornos gerados pela rota.

Language
Click Try It! to start a request and see the response here!