Author Image

excarplex_27431

Aug 17, 2024

Requisição de Teste com Split Pix e Configuração de Webhook

split pixpayloadwebhookconfiguraçãoAPIEfícontas externas

salve pessoal! cheguei hoje por aqui e to querendo fazer uma requisição de teste com split pix e to com algumas duvidas que nao encontrei no youtube, talvez alguem aqui possa ajudar:

1. Onde eu encontro o exemplo de payload da request? Seria uma cobranca instantanea com parametros a mais ou ele tem um payload esperado para o split em um endpoint especifico?

2. Só é possivel fazer split entre contas efi ou teria como por exemplo colocar uma chave externa na request?

3. Não entendi muito bem como configurar o webhook, seria via http request ou tem alguma interface em algum lugar? Vi o video dos caras fazendo com postman, mas eu uso insomnia no mac, nao manjo de postman

Respostas (2):
Avatar discord do usuario rubenskuhl

rubenskuhl

17/08/2024

2. Somente contas Efí

Avatar discord do usuario guilherme_efi

guilherme_efi

17/08/2024

Bom dia, @excarplex_27431! Tudo bem?
1. Para configurar um split de pagamento em uma cobrança Pix, você precisará seguir alguns passos específicos e utilizar os endpoints adequados da API. Aqui está um resumo das informações para te orientar:
1.1. Configuração do Split de Pagamento:
Primeiro, é necessário criar uma configuração de split. Isso é feito através do endpoint específico para configuração de split, disponível aqui. Esta configuração pode ser reutilizada em múltiplas cobranças Pix, o que facilita o processo se você tiver uma estrutura de split recorrente.
1.2. Criação da Cobrança Pix:
Após configurar o split, o próximo passo é criar a cobrança Pix. Isso pode ser feito de duas maneiras, dependendo do tipo de cobrança:
1.2.1. Cobrança Imediata: Utilize o endpoint para criar uma cobrança imediata com um TXID, disponível aqui.
1.2.2Cobrança com Vencimento: Se a cobrança tiver vencimento, utilize este endpoint.
1.3. Associação da Configuração de Split à Cobrança Pix:
Com a cobrança Pix criada, você precisará associar a configuração de split à cobrança. Isso é feito através do endpoint específico para vinculação de cobrança com split, disponível aqui.
Além disso, para melhor compreensão do processo de split de pagamento, você pode consultar o fluxograma disponível neste link.


2. O Split de pagamento Pix só pode ser realizado entre contas Efí, com limite máximo de 20 contas para o repasse.


3. Para configurar o webhook, você precisará fazer isso através de uma requisição HTTP utilizando o endpoint específico fornecido pela Efí. Esse processo envolve associar uma chave Pix registrada na sua conta Efí, que é a mesma chave que será utilizada na criação da cobrança, à URL de retorno da sua aplicação.
Você pode seguir o passo a passo detalhado na nossa documentação sobre webhooks. Lá, você encontrará o endpoint que deve ser utilizado para essa configuração.
Além disso, é essencial que você configure o mTLS (Mutual TLS) no seu servidor web para garantir que a comunicação siga os padrões de segurança estabelecidos. Mais detalhes sobre essa configuração podem ser encontrados na seção sobre mTLS na nossa documentação.

Se precisar de mais ajuda, conte com a gente!