Skip to content

Alternativa de PHP puro para o sistema de pagamentos MBWAY e Referências Multibanco https://ifthenpay.com/

Notifications You must be signed in to change notification settings

vladyslavkotyk/ifthenpay

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Pagamentos Ifthenpay

Alternativa de PHP puro para o sistema de pagamentos MBWAY e Ref Multibanco https://ifthenpay.com/.

Se houver necessidade escrevo uma versão do código em package composer Qualquer dúvida é so criar um issue, poderei também escrever o código em node.js ou python num breve futuro.

Como gerar uma referência

<?php
    
    require("class/multibanco.php");
    
    define("MULTIBANCO_ENTIDADE",       12345);
    define("MULTIBANCO_SUB_ENTIDADE",   123);

    define("URL_PROTOCOL",              "http");
    
    $multibanco = new Multibanco(MULTIBANCO_ENTIDADE, MULTIBANCO_SUB_ENTIDADE, URL_PROTOCOL);
    
    // Id da compra, neste caso um número random
    $order_id       = rand(1000, 10000);
    $order_value    = 39.99; 
    
    // Obter a referência
    echo $multibanco->generate($order_id, $order_value);

?>

Obter o status de uma referência

<?php
    
    require("class/multibanco.php");
    
    define("MULTIBANCO_ENTIDADE",       12345);
    define("MULTIBANCO_SUB_ENTIDADE",   123);

    define("URL_PROTOCOL",              "http");
    
    $multibanco = new Multibanco(MULTIBANCO_ENTIDADE, MULTIBANCO_SUB_ENTIDADE, URL_PROTOCOL);
    $reference  = "123 456 123";

    // Obter o estado do pagamento
    $data = $multibanco->status(IFTHENPAY_BACKOFFICE_KEY, $reference);

    var_dump($data);
?>

Erros do status de pagamento multibanco

Código Mensagem
0 Sucesso.
1 Não existem pagamentos.
2 Erro nas Datas/Horas.
3 Chave inválida.
9 Erro desconhecido.

Gerar novo pagamento mbway

<?php 

require("class/mbway.php");

define("MBWAY_KEY",                 "DTM-0000000"); // Key MbWay fornecida pelo IfThenpay
define("IFTHENPAY_MBWAY_CHANNEL",   "03");          // Canal predefinido na documentação do Ifthenpay

define("URL_PROTOCOL",              "http");

$mbway = new MBWay(MBWAY_KEY, IFTHENPAY_MBWAY_CHANNEL, URL_PROTOCOL);

// Id da compra, neste caso um número random
$phone_number           = "910000000";
$customer_email         = "[email protected]";
$description            = "Compra teste";
$internal_reference     = rand(1000, 10000);
$order_value            = 0.01;

// Obter a referência
$status = $mbway->create($phone_number, $internal_reference, $order_value, $customer_email, $description);

?>

Obter informações sobre pagamento MBWay

<?php 

require("class/mbway.php");

define("MBWAY_KEY",                 "DTM-0000000"); // Key MbWay fornecida pelo IfThenpay
define("IFTHENPAY_MBWAY_CHANNEL",   "03");          // Canal predefinido na documentação do Ifthenpay

define("URL_PROTOCOL",              "http");

$mbway = new MBWay(MBWAY_KEY, IFTHENPAY_MBWAY_CHANNEL, URL_PROTOCOL);

// Guardado numa database ou algo
$payment_id  = "jf7843hnfiernfui3wn";
$status      = $mbway->status($payment_id);

?>

Erros do status de pagamento MbWay

Código Descrição
000 Operação financeira concluída com sucesso
020 Operação financeira cancelada pelo utilizador
023 Operação financeira devolvida pelo Comerciante
048 Operação financeira anulada pelo Comerciante
100 Não foi possível concluir a Operação
104 Operação financeira não permitida
111 O formato do número de telemóvel não se encontrava no formato correto
113 O número de telemóvel usado como identificador não foi encontrado
122 Operação recusada ao utilizador
123 Operação financeira não encontrada
125 Operação recusada ao utilizador

Como funciona uma referência MB

A referência é composta sempre por 9 dígitos (em grupos de 3 facilita a visualização) e é composta do seguinte modo:

SSSDDDDCC

Em que:

SSS: três dígitos que identificam a subentidade (o vendedor). Este código é atribuído pela IFTHENPAY.
DDDD: ID - quatro dígitos que identificam o nº do documento/encomenda a pagar ou o nº do v/ cliente 
(conforme prefiram associar o pagamento a um documento ou a um cliente). 
Este ID terá que ter obrigatoriamente 4 dígitos, pelo que caso o nº do documento/encomenda ou o nº do 
cliente tenha mais que 4 dígito terá que utilizar apenas os 4 mais à direita, caso tenha menos de 4 dígitos
deverá preencher os restantes com zeros à esquerda.
CC: dois dígitos de controlo (check-digits). Serve para o terminal validar se a informação está correta. 
Nota: Se o dígito de controlo só tiver um algarismo terá que formatá-lo para 2 algarismos
colocando 0 (zero) á esquerda.

About

Alternativa de PHP puro para o sistema de pagamentos MBWAY e Referências Multibanco https://ifthenpay.com/

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages