README

此包包含比利时银行转账中包含的结构化消息的验证器和生成器。常见用例

• 自动生成订单发票。
• 将支付提供者消息与存储在您应用程序中的订单关联。

结构化消息格式符合Febelfin 指南

安装

通过 Composer

$ composer require kouinkouin/be-bank-transfer-message

用法

生成结构化消息

基于随机数

$transferMessage = new BeBankTransferMessage\TransferMessage();
echo transferMessage->getStructuredMessage();

基于预定义的数字

$transferMessage = new BeBankTransferMessage\TransferMessage(12345);
echo transferMessage->getStructuredMessage();

更改到不同的预定义数字

$transferMessage->setNumber(54321);
$transferMessage->generate();
echo transferMessage->getStructuredMessage();

或随机数

$transferMessage->setNumber();
$transferMessage->generate();
echo transferMessage->getStructuredMessage();

结构化消息的默认、有效的定界符是加号。如果需要，也可以使用星号作为定界符。

$transferMessage->setNumber();
$transferMessage->generate(TransferMessage::CIRCUMFIX_ASTERISK);
echo transferMessage->getStructuredMessage();

验证结构化消息

有效消息

$transferMessage = new BeBankTransferMessage\TransferMessage();
$transferMessage->setStructuredMessage('+++090/9337/55493+++');
$result = $transferMessage->validate();  // TRUE

无效消息

$transferMessage = new BeBankTransferMessage\TransferMessage();
$transferMessage->setStructuredMessage('+++011/9337/55493+++');
$result = $transferMessage->validate();  // FALSE

此外，如果结构化消息的格式无效，setter 方法将抛出 TransferMessageException()。

测试

$ phpunit

贡献

请参阅CONTRIBUTING 了解详细信息。

鸣谢

• Matthias Vandermaesen
• kouinkouin

许可

MIT 许可证 (MIT)。有关更多信息，请参阅许可文件。