Skip to main content
GET
Esta rota devolve as chaves de API (pública e secreta) de uma subconta (SubMerchant). Com a chave secreta da subconta, a sua plataforma cria cobranças em nome do vendedor: a venda fica registrada como originada pela subconta, e é a partir dela que o split distribui os valores.

Quando usar

Antes de chamar

  • Use as chaves para cobrar só depois que a subconta estiver ativa (active): antes da aprovação ela não está apta a transacionar. Confira com Consultar subconta. Se a API não encontrar chaves para a subconta, a rota devolve 404.
  • Autentique com a chave secreta (sk_) da conta master (Credenciais e ambientes).

Parâmetros de caminho

string
required
Identificador único da subconta. Ex.: 36OO3bcGjhPjjF3tzrqOGcmQuKo.

Respostas

string
Chave pública da subconta. Pode ser usada no navegador, nas rotas que pedem a chave pública. Ex.: pk_2vorkDcXyvzifL63YX09S9VqcnI.
string
Chave secreta da subconta. Só pode ser usada no servidor. Ex.: sk_2vorkDcXyvzifL63YX09S9VqcnI.
Em modo de teste, as chaves têm prefixo sk_test_ e pk_test_.
A chave secreta da subconta dá acesso às cobranças e aos dados dela. Guarde-a só no servidor, em um cofre de segredos, e nunca a envie ao navegador, ao aplicativo ou ao próprio vendedor por e-mail ou chat. A chave pública (pk_) é a que pode ir para o front-end.
Para o negócio: para que cada venda fique ligada ao vendedor certo, a cobrança precisa ser criada com a chave secreta da subconta que vendeu. Com a chave da conta master, a venda fica registrada na própria conta master. As regras de quem pode enviar valor para quem estão em Split de pagamentos.
Para o desenvolvedor: guarde a relação entre o id da subconta e a referência da chave no seu cofre. Na hora de cobrar, escolha a chave pelo vendedor do pedido. Se receber 404, confira primeiro o id e o status da subconta.

Erros comuns

Veja também

Split de pagamentos

Divisão de valores entre contas do grupo.

Criar cobrança

Cobrança com a chave da subconta.

Consultar subconta

Confirme que a subconta está ativa.

Visão geral do Connect

Conta master, subcontas e chaves.