Buscar Cliente

curl --request GET \
  --url https://pay.autorizou.dev/api/v1/customers/{identifier} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://pay.autorizou.dev/api/v1/customers/{identifier}', 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://pay.autorizou.dev/api/v1/customers/{identifier}",
  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: Bearer <token>"
  ],
]);

$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://pay.autorizou.dev/api/v1/customers/{identifier}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://pay.autorizou.dev/api/v1/customers/{identifier}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

GET

api

customers

{identifier}

Buscar Cliente

curl --request GET \
  --url https://pay.autorizou.dev/api/v1/customers/{identifier} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://pay.autorizou.dev/api/v1/customers/{identifier}', 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://pay.autorizou.dev/api/v1/customers/{identifier}",
  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: Bearer <token>"
  ],
]);

$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://pay.autorizou.dev/api/v1/customers/{identifier}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://pay.autorizou.dev/api/v1/customers/{identifier}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

Este endpoint permite recuperar as informações de um cliente específico usando seu ID único ou email.

Casos de Uso

Consulta de dados do cliente para exibição
Validação antes de processar pagamentos
Recuperação de informações para formulários
Sincronização de dados entre sistemas

Parâmetros de URL

string

required

Identificador do cliente. Pode ser UUID, email ou hash do cliente

UUID do cliente (ex: 142465c6-4c9d-4fd1-9632-2c40af316da3)
Email do cliente (ex: maria@exemplo.com.br)
Hash do cliente (ex: AUTCUS01K8RSCH3T5FNB7EVACV8DQVNX)

Exemplos de Requisição

Buscar por UUID

curl -X GET https://pay.autorizou.dev/api/v1/customers/142465c6-4c9d-4fd1-9632-2c40af316da3 \
  -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc"

const customer = await fetch('https://pay.autorizou.dev/api/v1/customers/142465c6-4c9d-4fd1-9632-2c40af316da3', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 4eC39HqLyjWDarjtT1zdp7dc'
  }
});

const result = await customer.json();
console.log('Cliente encontrado:', result);

<?php

$customerId = '142465c6-4c9d-4fd1-9632-2c40af316da3';

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://pay.autorizou.dev/api/v1/customers/{$customerId}",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc'
    ]
]);

$response = curl_exec($curl);
$customer = json_decode($response, true);
curl_close($curl);

echo "Cliente: " . json_encode($customer, JSON_PRETTY_PRINT);
?>

Buscar por Email

curl -X GET "https://pay.autorizou.dev/api/v1/customers/maria@exemplo.com.br" \
  -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc"

const email = encodeURIComponent('maria@exemplo.com.br');
const customer = await fetch(`https://pay.autorizou.dev/api/v1/customers/${email}`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 4eC39HqLyjWDarjtT1zdp7dc'
  }
});

const result = await customer.json();
console.log('Cliente encontrado:', result);

<?php

$email = urlencode('maria@exemplo.com.br');

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://pay.autorizou.dev/api/v1/customers/{$email}",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc'
    ]
]);

$response = curl_exec($curl);
$customer = json_decode($response, true);
curl_close($curl);

echo "Cliente: " . json_encode($customer, JSON_PRETTY_PRINT);
?>

Buscar por Hash

curl -X GET "https://pay.autorizou.dev/api/v1/customers/AUTCUS01K8RSCH3T5FNB7EVACV8DQVNX" \
  -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc"

const hash = encodeURIComponent('AUTCUS01K8RSCH3T5FNB7EVACV8DQVNX');
const customer = await fetch(`https://pay.autorizou.dev/api/v1/customers/${hash}`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 4eC39HqLyjWDarjtT1zdp7dc'
  }
});

const result = await customer.json();
console.log('Cliente encontrado:', result);

<?php

$hash = urlencode('AUTCUS01K8RSCH3T5FNB7EVACV8DQVNX');

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.autorizou.cloud/v1/customers/{$hash}",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc'
    ]
]);

$response = curl_exec($curl);
$customer = json_decode($response, true);
curl_close($curl);

echo "Cliente: " . json_encode($customer, JSON_PRETTY_PRINT);
?>

Resposta de Sucesso

{
  "id": "142465c6-4c9d-4fd1-9632-2c40af316da3",
  "hash": "AUTCUS01K8RSCH3T5FNB7EVACV8DQVNX",
  "name": "Maria da Silva Santos",
  "email": "maria.santos@exemplo.com.br",
  "created_at": "29/10/2025 17:08:42",
  "updated_at": "29/10/2025 17:08:42"
}

Códigos de Erro

404 - Not Found

Cliente não encontrado

{
   "message": "Cliente não encontrado."
}

Possíveis causas:

UUID, email ou hash não existe
Cliente pertence a outro merchant
Identificador malformado

400 - Bad Request

Parâmetro de identificação inválido

{
  "message": "Identificador do cliente é inválido"
}

Detalhes da Resposta

Campos Principais

Campo	Tipo	Descrição
`id`	string	UUID único do cliente
`hash`	string	Hash do cliente
`name`	string	Nome completo do cliente
`email`	string	Email do cliente
`created_at`	string	Data de criação
`updated_at`	string	Data da última atualização

Considerações de Performance

Cache recomendado: As informações do cliente mudam raramente. Considere implementar cache local com TTL de 1 hora para melhorar a performance.

Rate limiting: Este endpoint está sujeito aos limites de requisições por minuto do seu plano.

Próximos Passos

Após recuperar os dados do cliente:

Conta

Clientes

Cartões

Pedidos

Produtos e Ofertas

Assinaturas

Pagamentos

Links de Pagamento

POS / Maquininhas

Apple Pay

Reembolsos

Recebedores

Motivos de Recusa

Webhooks

Modelos de Dados

Buscar Cliente

Casos de Uso

Parâmetros de URL

Exemplos de Requisição

Buscar por UUID

Buscar por Email

Buscar por Hash

Resposta de Sucesso

Códigos de Erro

Detalhes da Resposta

Campos Principais

Considerações de Performance

Próximos Passos

​Casos de Uso

​Parâmetros de URL

​Exemplos de Requisição

​Buscar por UUID

​Buscar por Email

​Buscar por Hash

​Resposta de Sucesso

​Códigos de Erro

​Detalhes da Resposta

​Campos Principais

​Considerações de Performance

​Próximos Passos

Casos de Uso

Parâmetros de URL

Exemplos de Requisição

Buscar por UUID

Buscar por Email

Buscar por Hash

Resposta de Sucesso

Códigos de Erro

Detalhes da Resposta

Campos Principais

Considerações de Performance

Próximos Passos