API de Transações
Confirmar Transação Pré-autorizada
Antes de prosseguir, certifique-se que leu todos os tópicos seção Primeiros Passos.
Estrutura
Para confirmar uma transação pré-autorizada é utilizada a estrutura, conforme Tabela 01:
Método |
POST |
---|---|
URL |
https://api.asteroidetecnologia.com.br
|
Recurso |
/transactions/confirm |
Endpoint |
https://api.asteroidetecnologia.com.br/transactions/confirm
|
Request Body - JSON
Para confirmar uma transação pré-autorizada é preciso enviar o Request Body JSON, conforme exemplo:
(em seguida veja o que cada parâmetro significa).
{ "guid": "venda.5c3f7cfc663a98.18407031" }
Parâmetros
Parâmetro | Padrão | Descrição |
---|---|---|
guid:String |
not null | O valor do guid no JSON de retorno ao criar uma transação de venda. |
Exemplos
Veja alguns exemplos de como realizar uma requisição à API de Transações enviando o Request Body JSON para confirmar uma transação.
# certifique-se de ter o comando "curl" instalado \ curl -X POST https://api.asteroidetecnologia.com.br/transactions/confirm \ -H 'Content-Type: application/json' \ -H 'asteroide-key: SEU_TOKEN_AQUI' \ -H 'asteroide-pass: SUA_SENHA_AQUI' \ -d '{ "guid": "venda.5c3f7cfc663a98.18407031" }'
// certifique-se de ter a extensão php_curl instalada $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://api.asteroidetecnologia.com.br/transactions/confirm', CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => array( 'Content-Type: application/json', 'asteroide-key: SEU_TOKEN_ASTEROIDE', 'asteroide-pass: SUA_SENHA_ASTEROIDE', ), CURLOPT_POSTFIELDS => json_encode(array( 'guid' => 'venda.5c3f7cfc663a98.18407031' )), )); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo 'cURL Error #:' . $err; } else { echo $response; }
// No mesmo diretório do arquivo "package.json" // npm install --save request var request = require("request"); var options = { method: 'POST', url: 'https://api.asteroidetecnologia.com.br/transactions/confirm', headers: { 'Content-Type': 'application/json', 'asteroide-key': 'SEU_TOKEN_ASTEROIDE', 'asteroide-pass': 'SUA_SENHA_ASTEROIDE' }, json: true body : { 'guid': 'venda.5c3f7cfc663a98.18407031' } }; request(options, function (error, response, body) { if (error) throw new Error(error); console.log(body); });
Retorno JSON
No caso de sucesso você deverá ver algo como:
{ "http_status": 200, "body": { "mensagem": "Venda confirmada" } }