Gerenciando sua carteira de clientes

A API MundiPagg possibilita a construção e o gerenciamento de seus clientes Customers, completamente customizável e armazenando dados de forma simples e segura. Para entender melhor cada conceito associado à carteira de cliente acesse a documentação:

Customer : informações sobre o cliente
Card : Informações sobre o cartão de um cliente
Address : Informações sobre o endereço de um Customer

O conjunto de Customers e Address é denominado Carteira de clientes , já o conjunto de Cards de um Customer é denominado Wallet.

Enquanto a Carteira de Clientes é o conjunto de clientes que transacionam ou transacionaram na loja, as Wallets são o conjunto de cartões de cada Customer.

Nesse tutorial iremos utilizar a SDK C# da Mundipagg disponível no gerenciador de pacotes NuGet com o nome de MundiAPI.PCL.

Gerenciando sua carteira de clientes

Vamos começar com o Customer.

Primeiro você deve importar o pacote MundiAPI.PCL para a nossa aplicação de teste e depois adicionar nossas credenciais instanciando a classe MundiAPIClient.

using MundiAPI.PCL;
using MundiAPI.PCL.Models;

namespace GerenciandoCarteira_Wallet {
    class Program {
        static void Main(string[] args) {

            string basicAuthUserName = "sk_test_4AdjlqpseatnmgbW";
            // Senha em branco. Passando apenas a secret key
            string basicAuthPassword = "";

            var client = new MundiAPIClient(basicAuthUserName, basicAuthPassword);
        }
    }
}

Um objeto Customer é composto por diversas propriedades, algumas delas são:

Name : nome do cliente
Email : e-mail do cliente
Document : CPF ou CNPJ do cliente

Para saber melhor sobre as outras propriedades consulte a nossa API Reference.

Apenas o campo Name é obrigatório. Recomendamos que envie também o campo Email. Enviando esse campo, conseguiremos identificar se o cliente já esta na sua carteira de cliente, evitando assim qualquer duplicidade.

Para criar um Customer é necessário instanciar a classe de acordo com as propriedades. Em seguida utilizar o Client para realizar a requisição de CreateCustomer.

using MundiAPI.PCL;
using MundiAPI.PCL.Models;

namespace GerenciandoCarteira_Wallet {
    class Program {
        static void Main(string[] args) {

            string basicAuthUserName = "sk_test_4AdjlqpseatnmgbW";
            // Senha em branco. Passando apenas a secret key
            string basicAuthPassword = "";

            var client = new MundiAPIClient(basicAuthUserName, basicAuthPassword);

            var customer = new CreateCustomerRequest() {
                Name = "Gustavo Fonseca",
                Email = "Gustavo.fonseca@mundipagg.com"
            };
            var createCustomerRequest = client.Customers.CreateCustomer(customer);
        }
    }
}

Quando um Customer é criado, é retornado no response um identificador daquele cliente. Com esse Id é possível gerenciar diversas informações dele, como por exemplo adicionar um endereço, alterar seu e-mail, alterar o nome, entre outras informações.

Você pode atualizar algumas informações do Customer criado. Para isso utilizará o Id do Customer para criar um UpdateCustomerRequest, informando o Document e o Type.

using MundiAPI.PCL;
using MundiAPI.PCL.Models;

namespace GerenciandoCarteira_Wallet {
    class Program {
        static void Main(string[] args) {

            string basicAuthUserName = "sk_test_4AdjlqpseatnmgbW";
            // Senha em branco. Passando apenas a secret key
            string basicAuthPassword = "";

            var client = new MundiAPIClient(basicAuthUserName, basicAuthPassword);

            var customer = new CreateCustomerRequest() {
                Name = "Gustavo Fonseca",
                Email = "Gustavo.fonseca@mundipagg.com",
                Document = "13278201701",
                Type = "individual"
            };

            var createCustomerRequest = client.Customers.CreateCustomer(customer);

            var updateCustomer = new UpdateCustomerRequest() {
                Document = "123456789012",
                Type = "individual"
            };

            var updateCustomerRequest = client.Customers.UpdateCustomer(createCustomerRequest.Id, updateCustomer);
        }
    }
}

Para criar um Address você utilizará a classe CreateAddressRequest informando os campos de acordo com a necessidade. Logo depois utilizará novamente o UpdateCustomerRequest para informar o Address criado junto do identificador do Customer.

using MundiAPI.PCL;
using MundiAPI.PCL.Models;

namespace GerenciandoCarteira_Wallet {
    class Program {
        static void Main(string[] args) {

            string basicAuthUserName = "sk_test_4AdjlqpseatnmgbW";
            // Senha em branco. Passando apenas a secret key
            string basicAuthPassword = "";

            var client = new MundiAPIClient(basicAuthUserName, basicAuthPassword);

            var customer = new CreateCustomerRequest() {
                Name = "Gustavo Fonseca",
                Email = "Gustavo.fonseca@mundipagg.com",
                Document = "13278201701",
                Type = "individual"
            };

            var createCustomerRequest = client.Customers.CreateCustomer(customer);

            var address = new CreateAddressRequest() {
                Line1 = "375, Av. General Justo, Centro",
                Line2 = "7º andar, sala 01",
                City = "Rio de Janeiro",
                Country = "BR",
                State = "RJ",
                ZipCode = "22000111",
            };
            
            var updateCustomer = new UpdateCustomerRequest() {
                Address = address
            };

            var updateCustomerRequest = client.Customers.UpdateCustomer(createCustomerRequest.Id, updateCustomer);
        }
    }
}

📘
Para mais informações acesse a nossa API Reference.