---
title: "Carteira de Clientes (legado)"
url: "https://devcenter.stone.com.br/legacy-carteira-de-clientes"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_Carteira+de+Clientes+(legado),props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9sZWdhY3ktY2FydGVpcmEtZGUtY2xpZW50ZXMi,s_MvfRRyJep2UsTTDS.png"
---

# Carteira de Clientes

Documentação Pagar.me v5 — referência histórica.

Documentação legada do Pagar.me v5

Esta página descreve um conceito da **Pagar.me v5** (versão clássica). Para projetos novos, explore o **[API Catalog](https://devcenter.stone.com.br/catalog)**.

A nova API possibilita a construção e o gerenciamento de uma Carteira de Clientes, completamente customizável.

É possível criar um cliente (`customer`) informando os seguintes dados:

-   `Name` (Nome do cliente);
-   `Email` (Email do cliente);
-   `Document` (Documento);
-   `Type` (Pessoa física ou jurídica);
-   `Phones` (Telefones do cliente);
-   `Birthdate` (Data de nascimento);
-   `Address` (Endereço do cliente).

Sempre que um novo cliente (`customer`) é criado, o mesmo vai diretamente para a sua carteira. Sua coleção será alimentada automaticamente sempre que uma cobrança for gerada, seja de forma avulsa, através de pedidos ou assinaturas.

Dados obrigatórios

Apenas o nome (`name`) é obrigatório na criação de um cliente, porém ele não é único.

Atenção

A propriedade `email` não é obrigatória, porém é única e é uma chave forte! Ou seja, caso você envie o e-mail no objeto `customer`, o nosso sistema irá vincular as informações de cartão ao comprador já existente.

## [Funcionalidades relacionadas à carteira de clientes](#funcionalidades-relacionadas-à-carteira-de-clientes)

|              |
| :----------- |
| 1) Incluir   |
| 2) Obter     |
| 3) Atualizar |
| 4) Listar    |

Código identificador do seu cliente

Todo cliente (`customer`) possui um código como este: `cus_dbaKMJJiPtDmMlrp`  
Este `customer_Id` será sua chave de identificação na carteira.  
Dessa forma, você consegue armazenar os dados pessoais e dos cartões do cliente no ambiente PCI Compliance do Pagar.me, garantindo o tráfego de informações sem se preocupar com vulnerabilidades e falhas de segurança.

Saiba mais sobre clientes através de nossa [API Reference](https://devcenter.stone.com.br/apis/v5-docs-legacy/docs)!

---

**Jornada: [Cobrar um cliente](https://devcenter.stone.com.br/legacy-overview-transacao)**  
Etapa 6 de 22

[**Etapa anterior**Pedidos abertos](https://devcenter.stone.com.br/legacy-pedidos-abertos)[**Próxima etapa**Carteira de Cartões](https://devcenter.stone.com.br/legacy-wallets)

Siga a Stone nas redes sociais

[](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ)

© Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57

Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP

Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.