O modelo empregado na integração das APIs é simples e se baseia na utilização de duas URLs:
- URL transacional: específica para operações como autorização, captura e cancelamento de transações.
- URL de consulta: para operações de consulta, como uma pesquisa de transações.
Para executar uma operação:
- Combine a base da URL do ambiente com o endpoint da operação desejada. Ex.:
https://api.braspag.com.br/_v2/sales/>\. - Envie a requisição para a URL utilizando o método HTTP adequado à operação.
| Método HTTP | Descrição |
|---|---|
| GET | Retorna recursos já existentes, ex.: consulta de transações. |
| POST | Cria um novo recurso, ex.: criação de uma transação. |
| PUT | Atualiza um recurso existente, ex.: captura ou cancelamento de uma transação previamente autorizada. |
- Todas a operações requerem as credenciais de acesso
MerchantIdeMerchantKey, que devem ser enviadas no cabeçalho (header) da requisição; - Cada envio de requisição irá retornar um código de Status HTTP.