Informar Cobrança Pix Dinâmico Imediato ao Kore #1

New issue

Open

opened 2025-07-03 20:50:43 +00:00 by igor · 0 comments

igor commented

2025-07-03 20:50:43 +00:00

Member

Resumo

Um meio de comunicação para os Pipelines que utilizem a Cobrança de um Pix Dinâmico Imediato.

Motivação

Permitir a criação de todos os cenários possíveis de uma Cobrança Pix Dinâmica Imediata dentro do Kore por meio de sistemas terceiros.

Especificação

Dados aguardados pelo Kore

Nome	Descrição	Obrigatório	Condições	Tipo
calendario	Objeto que controla as relações de tempo da Cobrança.	Não		Object
calendario.expiracao	Indica a duração do da cobrança.	Não	Deve-se passar utilizando segundos como unidade de medida. Na ausência de tal informação será utilizado 86400 (24 Horas)	Number
devedor	Identifica a quem a cobrança é endereçada, mas não necessariamente define quem será o pagador	Não		Object
devedor.cpf	Determina o documento do devedor, caso foi Pessoa Fìsica	Não	Não pode coexistir com devedor.cnpj	String
devedor.cnpj	Determina o documento do devedor, caso foi Pessoa Jurídica	Não	Não pode coexistir com devedor.cpf String
devedor.nome	Nome de quem a cobrança é endereçada	Não	Se torna obrigatório caso exista devedor.cpf ou devedor.cnpj	String
valor	Indica tudo ligado aos valores que compõem a cobrança	Sim		Object
valor.original	Representa o Valor da Cobrança	Sim	Na maior parte dos casos deve ter um valor maior que 0. Aceita zero apenas se: valor.modalidadeAlteração for igual a 1 ou nos casos de Saque/Troco, em que deve ser 0	String
valor.modalidadeAlteracao	Indica a possibilidade de alteração do valora ser pago pelo pagador.	Não	Por padrão entende-se o valor 0, o qual não permite alteração. Valores aceitos: 0 - Não permite alteração, 1 - Permite alteração	Number
valor.retirada	Indica as informações sobre Pix Saque ou Pix Troco	Não		Object
valor.retirada.saque	Indica as informações sobre Pix Saque	Não	Não pode existir junto ao campo valor.retirada.troco	Object
valor.retirada.saque.valor	Representa o valor da cobrança do Pix Saque.	Não	O valor deverá ser maior que 0, caso valor.retirada.saque.modalidadeAlteração foi 0 (não permite alteração por parte do pagador). Tal se torna obrigatório com a existência do valor.retirada.saque	String
valor.retirada.saque.modalidadeAlteracao	Representa a possibilidade do Pagador alterar o valor da Cobrança Pix Saque	Não	Indica a possibilidade de alteração do valora ser pago pelo pagador.	Não
valor.retirada.saque.prestadorDoServicoDeSaque	Indica o ISPB do facilitador de serviço de saque	Não	Se torna obrigatório caso exista o objeto valor.retirada.saque	String
valor.retirada.saque.modalidadeAgente	Indica a modalidade do agente a qual se dará a facilitação do serviço.	Não	Aceita AGTEC, AGTOT ou AGPSS. Se torna obrigatório caso valor.retirada.saque existir	String
valor.retirada.troco	Indica as informações sobre Pix Troco	Não	Não pode existir junto ao campo valor.retirada.saque	Object
valor.retirada.troco.valor	Representa o valor da cobrança do Pix Troco.	Não	O valor deverá ser maior que 0, caso valor.retirada.troco.modalidadeAlteração foi 0 (não permite alteração por parte do pagador). Tal se torna obrigatório com a existência do valor.retirada.saque	String
valor.retirada.troco.modalidadeAlteracao	Representa a possibilidade do Pagador alterar o valor da Cobrança Pix Troco	Não	Indica a possibilidade de alteração do valora ser pago pelo pagador.	Não
valor.retirada.troco.prestadorDoServicoDeSaque	Indica o ISPB do facilitador de serviço de saque	Não	Se torna obrigatório caso exista o objeto valor.retirada.troco	String
valor.retirada.troco.modalidadeAgente	Indica a modalidade do agente a qual se dará a facilitação do serviço.	Não	Aceita AGTEC, ou AGTOT. Se torna obrigatório caso valor.retirada.saque existir	String
chave	Chave Pix que identifica o recebedor da cobrança	Sim		String
txid	Identificador da cobrança	Sim		String
solicitacaoPagador	Texto que será apresentado ao pagador para que tal possa oferecer informações ao recebedor	Não		String
infoAdicionais	Lista com informações adicionais.	Não	O array deverá ter um objeto com o campo nome, o qual receberá o valor do nome desta informação adicional e este mesmo array deverá ter outro objeto com o campo valor, o qual receberá o valor com as informações sobre o campo do mesmo array.	Array

Rota parar requisição no Kore @umgeher

Respostas esperadas @umgeher

Capacidade de funcionamento junto a Pipelines

O conceito principal será a simplificação das ações do usuário final, logo este módulo precisa ter condições de receber somente o necessário, via usuário, para realizar a ação por saber se autocompletar e assim satisfazer o contrato prévio do Kore.

Justificativa

Possibilitar que um sistema terceiro em PHP, utilizando tal biblioteca, consiga realizar a requisição de uma Cobrança Pix Dinâmica Imediata, na plataforma Kore.

P2A - Path to Active

Critérios de Aceitação

Garantir se os dados são válidos para o Kore
Completar os dados faltantes, de acordo com o pipeline de origem
Realizar ações de acordo com a resposta recebida

Plano de Implementação

Exemplo

## Resumo Um meio de comunicação para os Pipelines que utilizem a Cobrança de um Pix Dinâmico Imediato. ## Motivação Permitir a criação de todos os cenários possíveis de uma Cobrança Pix Dinâmica Imediata dentro do Kore por meio de sistemas terceiros. ## Especificação ### Dados aguardados pelo Kore | Nome | Descrição | Obrigatório | Condições | Tipo | |---------|---------|---------|---------|---------| | calendario | Objeto que controla as relações de tempo da Cobrança. | Não | | Object | | calendario.expiracao | Indica a duração do da cobrança. | Não | Deve-se passar utilizando segundos como unidade de medida. Na ausência de tal informação será utilizado 86400 (24 Horas) | Number | | devedor | Identifica a quem a cobrança é endereçada, mas não necessariamente define quem será o pagador | Não | | Object | | devedor.cpf | Determina o documento do devedor, caso foi Pessoa Fìsica | Não | Não pode coexistir com devedor.cnpj | String | | devedor.cnpj | Determina o documento do devedor, caso foi Pessoa Jurídica | Não | Não pode coexistir com devedor.cpf String | | devedor.nome | Nome de quem a cobrança é endereçada | Não | Se torna obrigatório caso exista devedor.cpf ou devedor.cnpj | String | | valor | Indica tudo ligado aos valores que compõem a cobrança | Sim | | Object | | valor.original | Representa o Valor da Cobrança | Sim | Na maior parte dos casos deve ter um valor maior que 0. Aceita zero apenas se: valor.modalidadeAlteração for igual a 1 ou nos casos de Saque/Troco, em que deve ser 0 | String | | valor.modalidadeAlteracao | Indica a possibilidade de alteração do valora ser pago pelo pagador.| Não | Por padrão entende-se o valor 0, o qual não permite alteração. Valores aceitos: 0 - Não permite alteração, 1 - Permite alteração | Number | | valor.retirada | Indica as informações sobre Pix Saque ou Pix Troco | Não | | Object | | valor.retirada.saque | Indica as informações sobre Pix Saque | Não | Não pode existir junto ao campo valor.retirada.troco | Object | | valor.retirada.saque.valor | Representa o valor da cobrança do Pix Saque. | Não | O valor deverá ser maior que 0, caso valor.retirada.saque.modalidadeAlteração foi 0 (não permite alteração por parte do pagador). Tal se torna obrigatório com a existência do valor.retirada.saque | String | | valor.retirada.saque.modalidadeAlteracao | Representa a possibilidade do Pagador alterar o valor da Cobrança Pix Saque | Não | Indica a possibilidade de alteração do valora ser pago pelo pagador. | Não | Por padrão entende-se o valor 0, o qual não permite alteração. Valores aceitos: 0 - Não permite alteração, 1 - Permite alteração. | Number | | valor.retirada.saque.prestadorDoServicoDeSaque | Indica o ISPB do facilitador de serviço de saque | Não | Se torna obrigatório caso exista o objeto valor.retirada.saque | String | | valor.retirada.saque.modalidadeAgente | Indica a modalidade do agente a qual se dará a facilitação do serviço. | Não | Aceita AGTEC, AGTOT ou AGPSS. Se torna obrigatório caso valor.retirada.saque existir | String | | valor.retirada.troco | Indica as informações sobre Pix Troco | Não | Não pode existir junto ao campo valor.retirada.saque | Object | | valor.retirada.troco.valor | Representa o valor da cobrança do Pix Troco. | Não | O valor deverá ser maior que 0, caso valor.retirada.troco.modalidadeAlteração foi 0 (não permite alteração por parte do pagador). Tal se torna obrigatório com a existência do valor.retirada.saque | String | | valor.retirada.troco.modalidadeAlteracao | Representa a possibilidade do Pagador alterar o valor da Cobrança Pix Troco | Não | Indica a possibilidade de alteração do valora ser pago pelo pagador. | Não | Por padrão entende-se o valor 0, o qual não permite alteração. Valores aceitos: 0 - Não permite alteração, 1 - Permite alteração. | Number | | valor.retirada.troco.prestadorDoServicoDeSaque | Indica o ISPB do facilitador de serviço de saque | Não | Se torna obrigatório caso exista o objeto valor.retirada.troco | String | | valor.retirada.troco.modalidadeAgente | Indica a modalidade do agente a qual se dará a facilitação do serviço. | Não | Aceita AGTEC, ou AGTOT. Se torna obrigatório caso valor.retirada.saque existir | String | | chave | Chave Pix que identifica o recebedor da cobrança | Sim | | String | | txid | Identificador da cobrança | Sim | | String | | solicitacaoPagador | Texto que será apresentado ao pagador para que tal possa oferecer informações ao recebedor | Não | | String | | infoAdicionais | Lista com informações adicionais. | Não | O array deverá ter um objeto com o campo nome, o qual receberá o valor do nome desta informação adicional e este mesmo array deverá ter outro objeto com o campo valor, o qual receberá o valor com as informações sobre o campo do mesmo array. | Array | ### Rota parar requisição no Kore @umgeher ### Respostas esperadas @umgeher ### Capacidade de funcionamento junto a Pipelines O conceito principal será a simplificação das ações do usuário final, logo este módulo precisa ter condições de receber somente o necessário, via usuário, para realizar a ação por saber se autocompletar e assim satisfazer o contrato prévio do Kore. ## Justificativa Possibilitar que um sistema terceiro em PHP, utilizando tal biblioteca, consiga realizar a requisição de uma Cobrança Pix Dinâmica Imediata, na plataforma Kore. ## P2A - Path to Active ### Critérios de Aceitação - [ ] Garantir se os dados são válidos para o Kore - [ ] Completar os dados faltantes, de acordo com o pipeline de origem - [ ] Realizar ações de acordo com a resposta recebida ### Plano de Implementação - [ ] Exemplo

bacarin was assigned by igor

2025-07-03 20:50:43 +00:00

No labels

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: kontrl/phpkore#1

No description provided.

Rows
Columns