curl --request GET \
--url https://api-vendas.taximachine.com.br/api/v2/integracao/cupons/cliente/{cliente_id}/disponiveis \
--header 'Authorization: Basic <encoded-value>' \
--header 'api-key: <api-key>'import requests
url = "https://api-vendas.taximachine.com.br/api/v2/integracao/cupons/cliente/{cliente_id}/disponiveis"
headers = {
"Authorization": "Basic <encoded-value>",
"api-key": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {Authorization: 'Basic <encoded-value>', 'api-key': '<api-key>'}
};
fetch('https://api-vendas.taximachine.com.br/api/v2/integracao/cupons/cliente/{cliente_id}/disponiveis', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-vendas.taximachine.com.br/api/v2/integracao/cupons/cliente/{cliente_id}/disponiveis",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-vendas.taximachine.com.br/api/v2/integracao/cupons/cliente/{cliente_id}/disponiveis"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-vendas.taximachine.com.br/api/v2/integracao/cupons/cliente/{cliente_id}/disponiveis")
.header("Authorization", "Basic <encoded-value>")
.header("api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-vendas.taximachine.com.br/api/v2/integracao/cupons/cliente/{cliente_id}/disponiveis")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"cupons": [
{
"id": "1042",
"area_id": null,
"local_aplicacao": "P",
"codigo": "DESCONTO10",
"valor_maximo": "20.00",
"valor_maximo_corrida": "50.00",
"validade": "2026-10-01 23:59:59",
"limite_uso_individual": "3",
"uso_unico": "0",
"uso_apenas_novo_cliente": "0",
"qtd_usos_cupom": "1",
"perc_desconto": "10.00",
"valor_desconto": null,
"expirado": "0",
"tipos_pagamento": [
{
"id": "1",
"nome": "Dinheiro",
"tipo": "D"
}
],
"nome_area": null
},
{
"id": "1050",
"area_id": "7",
"codigo": "PRIMEIRAVIAGEM",
"perc_desconto": null,
"valor_desconto": "15.00",
"valor_maximo": "15.00",
"limite_uso_individual": null,
"uso_unico": "1",
"uso_apenas_novo_cliente": "1",
"criado_automaticamente": "1",
"qtd_usos_cupom": 0,
"primeira_viagem": "1",
"tipos_pagamento": [
{
"id": "1",
"nome": "Dinheiro",
"tipo": "D"
}
],
"nome_area": "Centro"
}
]
}
}{
"success": false,
"errors": [
{
"code": 0,
"message": "'lat_partida': Deve ser numérico."
}
]
}{
"success": false,
"errors": [
{
"code": 0,
"message": "Cliente não encontrado ou não pertence à bandeira autenticada."
}
]
}Consultar cupons disponíveis do cliente
Lista os cupons que um cliente pode aplicar em uma corrida — a mesma vitrine exibida no aplicativo do passageiro.
O retorno reúne os cupons cadastrados e vigentes da bandeira que o cliente já resgatou ou que estão publicados para exibição no aplicativo, mais o cupom automático de primeira viagem ou de inatividade quando o cliente é elegível. Cupons já esgotados para o cliente, fora da vigência ou indisponíveis para a bandeira não entram na lista.
Cupons restritos a uma área só aparecem quando as coordenadas da ponta correspondente são informadas: lat_partida/lng_partida liberam os cupons aplicados na partida e lat_destino/lng_destino os cupons aplicados no destino. Sem o par de coordenadas, o cupom daquela ponta fica fora da lista, porque não há como avaliar a área.
Requer Api-Key (bandeira) + autenticação HTTP Basic de um gestor ativo da bandeira.
curl --request GET \
--url https://api-vendas.taximachine.com.br/api/v2/integracao/cupons/cliente/{cliente_id}/disponiveis \
--header 'Authorization: Basic <encoded-value>' \
--header 'api-key: <api-key>'import requests
url = "https://api-vendas.taximachine.com.br/api/v2/integracao/cupons/cliente/{cliente_id}/disponiveis"
headers = {
"Authorization": "Basic <encoded-value>",
"api-key": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {Authorization: 'Basic <encoded-value>', 'api-key': '<api-key>'}
};
fetch('https://api-vendas.taximachine.com.br/api/v2/integracao/cupons/cliente/{cliente_id}/disponiveis', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-vendas.taximachine.com.br/api/v2/integracao/cupons/cliente/{cliente_id}/disponiveis",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-vendas.taximachine.com.br/api/v2/integracao/cupons/cliente/{cliente_id}/disponiveis"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-vendas.taximachine.com.br/api/v2/integracao/cupons/cliente/{cliente_id}/disponiveis")
.header("Authorization", "Basic <encoded-value>")
.header("api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-vendas.taximachine.com.br/api/v2/integracao/cupons/cliente/{cliente_id}/disponiveis")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"cupons": [
{
"id": "1042",
"area_id": null,
"local_aplicacao": "P",
"codigo": "DESCONTO10",
"valor_maximo": "20.00",
"valor_maximo_corrida": "50.00",
"validade": "2026-10-01 23:59:59",
"limite_uso_individual": "3",
"uso_unico": "0",
"uso_apenas_novo_cliente": "0",
"qtd_usos_cupom": "1",
"perc_desconto": "10.00",
"valor_desconto": null,
"expirado": "0",
"tipos_pagamento": [
{
"id": "1",
"nome": "Dinheiro",
"tipo": "D"
}
],
"nome_area": null
},
{
"id": "1050",
"area_id": "7",
"codigo": "PRIMEIRAVIAGEM",
"perc_desconto": null,
"valor_desconto": "15.00",
"valor_maximo": "15.00",
"limite_uso_individual": null,
"uso_unico": "1",
"uso_apenas_novo_cliente": "1",
"criado_automaticamente": "1",
"qtd_usos_cupom": 0,
"primeira_viagem": "1",
"tipos_pagamento": [
{
"id": "1",
"nome": "Dinheiro",
"tipo": "D"
}
],
"nome_area": "Centro"
}
]
}
}{
"success": false,
"errors": [
{
"code": 0,
"message": "'lat_partida': Deve ser numérico."
}
]
}{
"success": false,
"errors": [
{
"code": 0,
"message": "Cliente não encontrado ou não pertence à bandeira autenticada."
}
]
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Obrigatório. Sua chave API.
Path Parameters
Identificador interno do cliente. O cliente precisa pertencer à bandeira autenticada.
83605
Query Parameters
Latitude do local de partida da corrida. Usada para avaliar os cupons restritos a uma área de partida.
-22.8743056
Longitude do local de partida da corrida. Usada para avaliar os cupons restritos a uma área de partida.
-43.5626744
Latitude do destino da corrida. Usada para avaliar os cupons restritos a uma área de destino.
-22.9884209
Longitude do destino da corrida. Usada para avaliar os cupons restritos a uma área de destino.
-43.1934916
Response
Sucesso
The response is of type object.
