📘

O que você irá aprender com esse artigo?

• O que é Conta Espelho
• Como vincular Conta Espelho via API
• Como desvincular Conta Espelho via API

O que é Conta Espelho

A Conta Espelho, tem como objetivo o envio de valores da conta antiga para a conta nova (Conta Mestre para Conta Mestre, ou Subconta para Subconta) de forma automática.
Este cenário ocorre quando, uma Conta Mestre ou Subconta, teve alteração de informação como CNPJ ou CPF. Como a iugu não permite a mudança desta informação nas configurações da conta, é preciso criar uma nova Conta Mestre ou nova Subconta.

📘

Informações importantes:

Criar Conta Mestre
A criação de uma nova conta mestre, é preciso ser feita internamente. Para isto, é necessário primeiro entrar em contato com nosso time de CX, através do chat no portal ou enviando um e-mail para [email protected]
Caso prefira, poderá entrar em contato também com seu Executivo Comercial ou seu Gerente de Contas.

Criar Subconta via API
A criação da nova Subconta, pode ser realizada direto no Portal:

• Clique em Marketplace;
• Em seguida, irá apresentar as informações de Subconta, clique em Nova;
• Preencha as informações e clique em Salvar.

É possível realizar a criação de Subconta via API, segue o artigo explicando:
Como posso configurar uma subconta por API
Configuração de Subconta

Como vincular Conta Espelho

Após a criação e configuração da conta, é preciso ter as seguintes informações:

• Token API de Produção da conta antiga;
• ID da conta antiga;
• ID da conta nova.

Localizando ID da conta e gerando Token API

Id da Conta mestre

• Acesse seu portal iugu
• Clique em Configurações
  Na tela que irá aparecer, logo abaixo de Informações Gerais é apresentado o id da conta.

Id da Subconta

• Acesse seu portal iugu
• Clique em Configurações
• Clique em Marketplace
• Localize a Conta e em seguida clique em Ver
• Na próxima tela, irá apresentar o id da Subconta.

Gerando Token API

Conta Mestre
Clique em Configurações >> Integração via API >> Novo

Subconta

• Clique em Marketplace
• Localize a subconta e clique em Ver
• Em seguida, clique em Inspecionar
• Abrirá as informações da subconta
• Depois clique em Configurações >> Integração via API >> Novo

Abaixo, segue arquivo que explica como localizar o ID da Conta e gerar o Token API:
ID da conta e tokens de API

Em seguida, é preciso enviar uma requisição de criação (POST) de vínculo de Conta Espelho via API.

Modelo de request

curl --request POST \
     --url 'https://api.iugu.com/v1/87CC40FA3DBB4B0A89A0B93C095199E1/mirror_account' \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'Authorization: Basic {{api_token in base64}}' \
     --data '
{
     "mirror_account_id": "6474018CDEF140069465BB6CC64F8D92"
}
'

Modelo de response

Como Desvincular Conta Espelho

Caso queira desvincular a conta, para que a transferência de valores da conta antiga para a nova não ocorra mais

Para desvincular a Conta Espelho, via API, é preciso ter as seguintes informações:

• Token API de Produção da conta antiga;
• ID da conta antiga;
• ID da conta nova.

Em seguida, é preciso enviar uma requisição de remoção (DELETE) de vínculo de Conta Espelho via API.

Modelo de Request

curl --request DELETE \
     --url 'https://api.iugu.com/v1/87CC40FA3DBB4B0A89A0B93C095199E1/mirror_account' \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'Authorization: Basic {{api_token in base64}}' \
     --data '
{
     "mirror_account_id": "6474018CDEF140069465BB6CC64F8D92"
}
'

Modelo de Response