Cliente - 3run01/marketplace GitHub Wiki

Crie um novo cliente e guarde o identificador retornado para que você possa executar cobranças recorrentes, vincular cartões de crédito a carteira do cliente, utilizar conta de pagamento em nome do cliente, realizar criação de faturas e pagamentos do tipo boletos.

Para criar um cliente você ter pelo menos uma dentre as informação a seguir: nome, sobrenome, cpf/cnpj, email, numero de telefone 1, data de nascimento e o id do seu usuário. Outras informações podem ser enviado na criação de um cliente, conforme documentação de referência.

O objeto cliente

first_name	(string) - Nome.
last_name	(string) - Sobrenome.
email	(string) - E-mail.
phone_number1	(string) - Número de telefone.
phone_number2	(string) - Número de telefone.
cpf_cnpj	(string) - CPF ou CNPJ.
birthdate	(date) - Data de nascimento
street	(string) - Logradouro/Rua/Avenida
number	(string) - Número do endereço
neighborhood	(string) - Bairro
complement	(string) - Complemento do endereço
city	(string) - Cidade
state	(string) - EStado
postal_code	(string) - EStado

Criar cliente

Cria um objeto cliente

Curl --request POST\
--header "Content-Type: application/json" \
--Authorization Bearer SEU TOKEN \
--url api/v1/customers \

--data'{
    "first_name": "Bruno",
    "last_name" : "Santos",
    "email": "[email protected]",
    "phone_number1": "96999999999",
    "cpf_cnpj": "22239844411",
    "birthdate": "1992-01-01",
    "user_id": "1"
}'

Alterar cliente

Alterar os dados de um Cliente. Quaisquer parâmetros não informados não serão alterados.

Curl --request PUT\
--header "Content-Type: application/json" \
--Authorization Bearer SEU TOKEN \
--url /api/v1/customers/{customer_id} \

--data '{
    "first_name": "Bruno",
    "last_name" : "Santos",
    "email": "[email protected]",
    "phone_number1": "96999999999",
    "cpf_cnpj": "22239844411",
    "birthdate": "1992-01-01"
}'

Listar clientes

Retorna uma lista com todos os clientes cadastrados em sua conta.

Curl --request GET\
--header "Content-Type: application/json" \
--Authorization Bearer SEU TOKEN \
--url /api/v1/customers \

Buscar cliente

Retorna os dados de um cliente.

Curl --request GET\
--header "Content-Type: application/json" \
--Authorization Bearer SEU TOKEN \
--url /api/v1/customers/{customer_id} \