README

SwissPayment 是一个PHP库，用于生成瑞士pain.001 XML消息（符合ISO-20022标准）。

安装

只需安装 Composer 并在项目目录中运行 composer require ch2877/swiss-payment 即可。

使用方法

要了解消息的结构，请查看以下提到的资源。以下示例展示了如何创建包含两个交易的消息

<?php

require_once __DIR__.'/vendor/autoload.php';

use Z38\SwissPayment\BIC;
use Z38\SwissPayment\IBAN;
use Z38\SwissPayment\Message\CustomerCreditTransfer;
use Z38\SwissPayment\Money;
use Z38\SwissPayment\PaymentInformation\PaymentInformation;
use Z38\SwissPayment\PostalAccount;
use Z38\SwissPayment\StructuredPostalAddress;
use Z38\SwissPayment\TransactionInformation\BankCreditTransfer;
use Z38\SwissPayment\TransactionInformation\IS1CreditTransfer;
use Z38\SwissPayment\UnstructuredPostalAddress;

$transaction1 = new BankCreditTransfer(
    'instr-001',
    'e2e-001',
    new Money\CHF(130000), // CHF 1300.00
    'Muster Transport AG',
    new StructuredPostalAddress('Wiesenweg', '14b', '8058', 'Zürich-Flughafen'),
    new IBAN('CH51 0022 5225 9529 1301 C'),
    new BIC('UBSWCHZH80A')
);

$transaction2 = new IS1CreditTransfer(
    'instr-002',
    'e2e-002',
    new Money\CHF(30000), // CHF 300.00
    'Finanzverwaltung Stadt Musterhausen',
    UnstructuredPostalAddress::sanitize('Altstadt 1a', '4998 Musterhausen'),
    new PostalAccount('80-151-4')
);

$payment = new PaymentInformation(
    'payment-001',
    'InnoMuster AG',
    new BIC('ZKBKCHZZ80A'),
    new IBAN('CH6600700110000204481')
);
$payment->addTransaction($transaction1);
$payment->addTransaction($transaction2);

$message = new CustomerCreditTransfer('message-001', 'InnoMuster AG');
$message->addPayment($payment);

echo $message->asXml();

提示：查看 Z38\SwissPayment\Tests\Message\CustomerCreditTransferTest 了解所有支付类型的操作。

注意事项

• 并非所有业务规则和建议都得到强制执行，请查阅文档并与您的银行合作验证生成的交易文件。
• 目前不支持支票转账（有关详细信息，请参阅实施指南的第2.2节）
• 整个项目仍在开发中，因此可能发生BC中断。如果您需要稳定的代码库，请与我联系。

贡献

如果您想动手操作，太好了！以下是几个步骤/指南

• 分叉此存储库
• 添加您的更改并测试这些更改（在 tests/ 中）。
• 请尽可能遵守现有的代码风格。如有疑问，请遵循 PSR-2。
• 向我发送拉取请求！

如果您不想经历所有这些，但仍然发现了一些错误或遗漏，请告诉我，或者 打开一个新的问题报告，以便我或其他人员可以处理。

其他资源

• www.iso-payments.ch 关于瑞士对ISO 20022建议的一般网站
• 瑞士客户-银行消息的商业规则
• 瑞士pain.001和pain.002消息的实施指南
• SIX验证门户
• PostFinance验证门户