Como vincular um cliente de subconta a um cliente da conta master via API

Se você usa o nosso Split de Pagamentos, saiba que é possível vincular o meio de pagamento de um cliente criado na Conta Master à um mesmo cliente de uma Subconta. Isso permite que a subconta aproveite automaticamente o meio de pagamento salvo na conta master, como um cartão de crédito, sem a necessidade de novo cadastro.

 

Como configurar?

1. Crie o cliente e a forma de pagamento na conta master

Antes de tudo, é necessário que o cliente já esteja criado na conta master com a forma de pagamento salva. Você pode usar os seguintes endpoints da API:

Criar customer.
Criar Forma de Pagamento.

2. Crie o mesmo cliente na subconta

Na subconta, crie o mesmo customer com dados idênticos aos cadastrados na conta master (nome, e-mail, etc).

Em seguida, vincule esse cliente da subconta ao cliente da conta master usando o seguinte comando:

PUT - https://api.iugu.com/v1/customers/CUSTOMER_ID_SUBCONTA

--data

{ "proxy_payments_from_customer_id": "89A9961E8A124D039289EE436DEFB4D3" // customer_id da conta master }

Esse vínculo fará com que a subconta utilize automaticamente o default_payment_method_id (forma de pagamento padrão) da conta master.

 

O que acontece depois?

Se o cartão de crédito for atualizado na conta master, a alteração será refletida automaticamente em todas as subcontas que estiverem vinculadas.

ATENÇÃO: somente o campo default_payment_method_id (forma de pagamento padrão) é sincronizado entre as contas. Os demais dados do cliente permanecem independentes.

 

Observações importantes

• O vínculo entre os clientes precisa ser feito manualmente via API. A subconta deve enviar o proxy_payments_from_customer_id apontando para o ID da conta master;

• É imprescindível que você crie o customer na subconta com os mesmos dados utilizados para cadastrar na conta master;

• Isso não atualiza os dados do cliente, apenas replica o meio de pagamento

 

Para mais informações acesse nossa documentação API

Compartilhar meio de pagamento