A Kore lib for PHP
Find a file
2025-07-11 19:04:33 +00:00
src Environment variable for Kore Class 2025-07-11 15:28:25 -03:00
.gitignore update gitignore: ignoring test.php file 2025-07-11 15:20:26 -03:00
composer.json Removing old package to made validation 2025-07-04 11:47:50 -03:00
LICENSE LICENSE 2025-07-11 16:04:06 -03:00
README.md documentation: updating to show 'environment' variable 2025-07-11 15:29:29 -03:00

KORE PHP LIB

Índice

Classe: PIX

Descrição: Classe padrão para consumo das funções de PIX do Kore, utilizado para gerar cobranças, transferir valores e etc.

Como Usar

$class = new \Kontrl\PhpKore\Pix($priv, $drone, $environment);

Parâmetros:

Nome Tipo Obrigatório Descrição
$priv string Sim Chave privada para assinatura da requisição
$drone string Sim ID do drone gerado e fornecido pela Kontrl
$environment string Não Ambiente a ser utilizado - Aceito: PROD ou DEV - Padrão: DEV

Função: pixCobrancaDinamicoImediataSemValor

Descrição: Gera uma cobrança PIX dinâmica e imediata sem valor predefinido, ou com valor sugerido. O usuário pagador poderá alterar o valor na hora do pagamento.

Como usar:

$class = new \Kontrl\PhpKore\Pix($priv, $drone, 'DEV');
$class->pixCobrancaDinamicoImediataSemValor($dados);

Parâmetros:

Nome Tipo Obrigatório Padrão Descrição
$dados array Sim Um array com os dados a serem enviados para geração da cobrança

Dados:

Chave Tipo Obrigatório Descrição Exemplo
expiracao int Sim Tempo de expiração em segundos 3600
devedor.documento string Não Documento do pagador "09432312054"
devedor.nome string Não, somente se o documento for informado Nome do pagador "Fulano da Silva"
valor int Não Valor sugerido 10000 (R$100,00)
chave string Sim Chave Pix de destino "12345678911"
txid string Sim Identificador da transação "098765432111"
solicitacaoPagador string Não Mensagem opcional ao pagador "Mensagem ao usuário"

Retorno: Tipo: array

Notas adicionais:

  • Lança Exception se algum dado obrigatório do array estiver vazio ou inválido.

Função: pixCobrancaDinamicoImediataComValor

Descrição: Gera uma cobrança PIX dinâmica e imediata com valor predefinido, o usuário pagador não poderá alterar o valor ao efetuar o pagamento.

Como usar:

$class = new \Kontrl\PhpKore\Pix($priv, $drone, 'DEV');
$class->pixCobrancaDinamicoImediataComValor($dados);

Parâmetros:

Nome Tipo Obrigatório Padrão Descrição
$dados array Sim Um array com os dados a serem enviados para geração da cobrança

Dados:

Chave Tipo Obrigatório Descrição Exemplo
expiracao int Sim Tempo de expiração em segundos 3600
devedor.documento string Não Documento do pagador "09432312054"
devedor.nome string Não, somente se o documento for informado Nome do pagador "Fulano da Silva"
valor int Sim Valor sugerido 10000 (R$100,00)
chave string Sim Chave Pix de destino "12345678911"
txid string Sim Identificador da transação "098765432111"
solicitacaoPagador string Não Mensagem opcional ao pagador "Mensagem ao usuário"

Retorno: Tipo: array

Notas adicionais:

  • Lança Exception se algum dado obrigatório do array estiver vazio ou inválido.

Função: pixCobrancaDinamicoImediataSaqueComValor

Descrição: Gera uma cobrança PIX dinâmica e imediata para SAQUE com valor predefinido, o usuário pagador não poderá alterar o valor ao efetuar o pagamento.

Como usar:

$class = new \Kontrl\PhpKore\Pix($priv, $drone, 'DEV');
$class->pixCobrancaDinamicoImediatoSaqueComValor($dados);

Parâmetros:

Nome Tipo Obrigatório Padrão Descrição
$dados array Sim Um array com os dados a serem enviados para geração da cobrança

Dados:

Chave Tipo Obrigatório Descrição Exemplo
expiracao int Sim Tempo de expiração em segundos 3600
devedor.documento string Não Documento do pagador "09432312054"
devedor.nome string Não, somente se o documento for informado Nome do pagador "Fulano da Silva"
valor int Sim Valor do saque 10000 (R$100,00)
chave string Sim Chave Pix de destino "12345678911"
txid string Sim Identificador da transação "098765432111"
solicitacaoPagador string Não Mensagem opcional ao pagador "Mensagem ao usuário"
ispb string Sim ISPB da instituição do prestador de serviço do saque "33233"
modalidadeAgente string Sim Indica a modalidade do agente a qual se dará a facilitação do serviço. DEVE SER: "agtot", "agtec" ou "agpss" "agtot"

Retorno: Tipo: array

Notas adicionais:

  • Lança Exception se algum dado obrigatório do array estiver vazio ou inválido.

Função: pixCobrancaDinamicoImediataSaqueSemValor

Descrição: Gera uma cobrança PIX dinâmica e imediata para SAQUE sem valor predefinido, o usuário pagador poderá alterar o valor ao efetuar o pagamento.

Como usar:

$class = new \Kontrl\PhpKore\Pix($priv, $drone, 'DEV');
$class->pixCobrancaDinamicoImediatoSaqueSemValor($dados);

Parâmetros:

Nome Tipo Obrigatório Padrão Descrição
$dados array Sim Um array com os dados a serem enviados para geração da cobrança

Dados:

Chave Tipo Obrigatório Descrição Exemplo
expiracao int Sim Tempo de expiração em segundos 3600
devedor.documento string Não Documento do pagador "09432312054"
devedor.nome string Não, somente se o documento for informado Nome do pagador "Fulano da Silva"
valor int Não Valor sugerido 10000 (R$100,00)
chave string Sim Chave Pix de destino "12345678911"
txid string Sim Identificador da transação "098765432111"
solicitacaoPagador string Não Mensagem opcional ao pagador "Mensagem ao usuário"
ispb string Sim ISPB da instituição do prestador de serviço do saque "33233"
modalidadeAgente string Sim Indica a modalidade do agente a qual se dará a facilitação do serviço. DEVE SER: "agtot", "agtec" ou "agpss" "agtot"

Retorno: Tipo: array

Notas adicionais:

  • Lança Exception se algum dado obrigatório do array estiver vazio ou inválido.

Função: pixCobrancaDinamicoImediataTrocoComValor

Descrição: Gera uma cobrança PIX dinâmica e imediata para TROCO com valor predefinido, o usuário pagador não poderá alterar o valor ao efetuar o pagamento.

Como usar:

$class = new \Kontrl\PhpKore\Pix($priv, $drone, 'DEV');
$class->pixCobrancaDinamicoImediatoTrocoComValor($dados);

Parâmetros:

Nome Tipo Obrigatório Padrão Descrição
$dados array Sim Um array com os dados a serem enviados para geração da cobrança

Dados:

Chave Tipo Obrigatório Descrição Exemplo
expiracao int Sim Tempo de expiração em segundos 3600
devedor.documento string Não Documento do pagador "09432312054"
devedor.nome string Não, somente se o documento for informado Nome do pagador "Fulano da Silva"
valor int Sim Valor do troco 10000 (R$100,00)
chave string Sim Chave Pix de destino "12345678911"
txid string Sim Identificador da transação "098765432111"
solicitacaoPagador string Não Mensagem opcional ao pagador "Mensagem ao usuário"
ispb string Sim ISPB da instituição do prestador de serviço do troco "33233"
modalidadeAgente string Sim Indica a modalidade do agente a qual se dará a facilitação do serviço. DEVE SER: "agtot" ou "agtec" "agtot"

Retorno: Tipo: array

Notas adicionais:

  • Lança Exception se algum dado obrigatório do array estiver vazio ou inválido.

Função: pixCobrancaDinamicoImediataTrocoSemValor

Descrição: Gera uma cobrança PIX dinâmica e imediata para TROCO sem valor predefinido, o usuário pagador poderá alterar o valor ao efetuar o pagamento.

Como usar:

$class = new \Kontrl\PhpKore\Pix($priv, $drone, 'DEV');
$class->pixCobrancaDinamicoImediatoTrocoSemValor($dados);

Parâmetros:

Nome Tipo Obrigatório Padrão Descrição
$dados array Sim Um array com os dados a serem enviados para geração da cobrança

Dados:

Chave Tipo Obrigatório Descrição Exemplo
expiracao int Sim Tempo de expiração em segundos 3600
devedor.documento string Não Documento do pagador "09432312054"
devedor.nome string Não, somente se o documento for informado Nome do pagador "Fulano da Silva"
valor int Não Valor sugerido 10000 (R$100,00)
chave string Sim Chave Pix de destino "12345678911"
txid string Sim Identificador da transação "098765432111"
solicitacaoPagador string Não Mensagem opcional ao pagador "Mensagem ao usuário"
ispb string Sim ISPB da instituição do prestador de serviço do troco "33233"
modalidadeAgente string Sim Indica a modalidade do agente a qual se dará a facilitação do serviço. DEVE SER: "agtot" ou "agtec" "agtot"

Retorno: Tipo: array

Notas adicionais:

  • Lança Exception se algum dado obrigatório do array estiver vazio ou inválido.

Função: pixCobrancaEstatico

Descrição: Gera uma cobrança PIX estática com ou sem valor predefinido.

Como usar:

$class = new \Kontrl\PhpKore\Pix($priv, $drone, 'DEV');
$class->pixCobrancaEstatico($dados);

Parâmetros:

Nome Tipo Obrigatório Padrão Descrição
$dados array Sim Um array com os dados a serem enviados para geração da cobrança

Dados:

Chave Tipo Obrigatório Descrição Exemplo
valor int Não Valor sugerido 10000 (R$100,00)
chave string Sim Chave Pix de destino "12345678911"
txid string Sim Identificador da transação "098765432111"
solicitacaoPagador string Não Mensagem opcional ao pagador "Mensagem ao usuário"

Retorno: Tipo: array

Notas adicionais:

  • Lança Exception se algum dado obrigatório do array estiver vazio ou inválido.