Pular para o conteúdo principal

Contas de processamento

Sua conta SeventyOne Pay pode ter mais de uma conta de processamento. Cada uma tem saldo, taxa e limite de PIX próprios; o saldo nunca é compartilhado entre elas. No painel, em Contas, você escolhe qual está ativa.

Qual conta a API usa?​

Cobranças PIX (POST /pix) e saques (POST /withdrawals) feitos pela API operam por uma conta. Cada chave de API tem um de dois modos:

ModoComportamento
Segue a conta ativa (padrão)Usa a conta que estiver ativa no momento da chamada. Se você trocar a conta ativa no painel, a chave passa a operar pela nova conta.
Presa a uma contaUsa sempre a conta escolhida ao criar a chave (saldo, taxa e limite dela), mesmo que você troque a conta ativa.

Escolha o modo ao criar a chave, em Integração → Chaves de API → Conta de processamento.

Para integrações em produção

Se a sua loja depende de uma taxa ou de um limite específicos, prenda a chave a uma conta. Assim uma troca de conta no painel nunca altera, sem aviso, a conta usada pela integração.

Se a conta da chave não puder operar​

Quando a chave está presa a uma conta que foi desativada, não aceita depósitos (ou saques) ou tem um limite menor que o valor pedido, a chamada falha — a API não troca para outra conta automaticamente. Ative a conta de volta ou crie uma chave presa a outra conta.

Descobrir a conta de uma chave​

GET /me e GET /api-key informam o modo e a conta:

{
  "success": true,
  "data": {
    "account": { "id": "9d8c7b6a-0000-0000-0000-000000000004", "name": "Conta Principal" },
    "account_mode": "pinned"
  }
}

account_mode é pinned (presa) ou follows_active (segue a conta ativa; nesse caso account é a conta ativa naquele momento).

Conciliar por conta​

Para saber de qual conta veio cada operação:

  • API: account em POST /pix e GET /pix/{id}.
  • Webhooks: data.account nos eventos de pagamento e de saque.

O campo account traz o id e o nome da conta (o mesmo nome que você vê no painel). É null quando a origem não é conhecida.

Saldo e saques​

Um saque pela API debita apenas o saldo da conta que ele usa. Com uma chave presa à conta B, o saque sai do saldo de B, ainda que a conta ativa seja A. GET /withdrawals/quote mostra o saldo da conta usada pela chave.