Introdução

Princípios básicos

Bem-vindo ao guia de referência da API RESTful da Marlim!
Todas as chamadas para nossa API usam verbos REST comuns e todas as respostas são retornadas no formato JSON.

Tipos de Pagamento

Os Links de Pagamento podem ser vistos como uma "ordem" para ser paga posteriormente. A Marlim disponibiliza uma URL que contém um Front-End pronto para o cliente realizar o pagamento, não sendo necessária a implementação de um checkout.

Enquanto que as Transações, são usadas caso você queria implementar um checkout transparente e customizado para as suas necessidades direto na sua aplicação.

Ambientes

Para realizar requests para ambos os tipos de pagamento, você tem acesso a duas chaves de API diferentes e dois ambientes diferentes: Sandbox e Produção. Desta forma, é possível diferenciar o ambiente escolhendo a api_key e o endpoint base apropriados para o tipo de transação que você deseja realizar, seguindo as orientações abaixo:

Sandbox

https://sandbox.api.marlim.co

Produção

https://api.marlim.co

atenção

As chaves de autenticação para o ambiente de produção têm o poder de realizar qualquer transação em nossa API, por isso é extremamente importante que você as guarde em um local seguro, e que não as exponha no cliente-side do seu aplicativo.

Autenticação

Sempre que sua aplicação chamar um de nossos endpoints, você deverá passar sua API Key adicionada ao Header da requisição como forma de autenticação, utilizando o seguinte formato:

"api_key": "sua_api_key_value"

nota

Sua api_key deve ser solicitada à nossa equipe de Suporte ou Desenvolvimento.

Códigos de resposta

Nossa API usa códigos HTTP padrão como retorno para indicar o sucesso de uma solicitação e para indicar falha.

Código	Significado
200	Tudo correu como deveria e sua solicitação foi processada com sucesso.
400	Algum parâmetro obrigatório não foi passado ou os parâmetros passados não estão corretos.
401	Falta de autorização para acessar este endpoint.
403	O valor passado no parâmetro está incorreto.
404	Endpoint ou algum valor não encontrado.
405	Método não autorizado.
408	Tempo limite de 60 segundos atingido.
500	Erro interno do Marlim, tente novamente. Se continuar, entre em contato conosco.

Versão

A versão mais atual da API é: v3