包简介

ECPay e-Invoice API wrapper with DTO-based operations, Laravel coordinator, and sandbox-ready docs

README 文档

README

此套件封裝綠界電子發票（B2C）API，提供 Operations/Queries/Notifications 的一致介面、DTO-based 欄位建構、加密/解密與 Laravel 整合。

需求

PHP ^8.3

安裝

composer require carllee1983/ecpay-einvoice-b2c

快速開始

use CarlLee\EcPayB2C\EcPayClient;
use CarlLee\EcPayB2C\Operations\Invoice;
use CarlLee\EcPayB2C\DTO\InvoiceItemDto;

$server = 'https://einvoice-stage.ecpay.com.tw';
$merchantId = '2000132';
$hashKey = 'ejCk326UnaZWKisg';
$hashIV = 'q9jcZX8Ib9LM8wYk';

$client = new EcPayClient($server, $hashKey, $hashIV);

$invoice = new Invoice($merchantId, $hashKey, $hashIV);
$invoice->setRelateNumber('YEP' . date('YmdHis'))
    ->setCustomerEmail('demo@example.com')
    ->setItems([
        InvoiceItemDto::fromArray(['name' => '商品範例', 'quantity' => 1, 'unit' => '個', 'price' => 100]),
    ])
    ->setSalesAmount(100);

$response = $client->send($invoice);
$data = $response->getData();

命令契約（重要）

EcPayClient::send() 只接受 CarlLee\EcPayB2C\Contracts\SendableCommandInterface（通常直接繼承 CarlLee\EcPayB2C\Content 即可）。
舊的 CarlLee\EcPayB2C\InvoiceInterface 已標記 deprecated（相容層）。
若需自行檢視「實際送出的加密內容」，建議呼叫 Content::getTransportBody()（getContent() 為相容名稱）。

文件

docs/README.md：文件索引與流程圖
docs/api-overview.md：介接流程與模組總覽
docs/error-codes.md：常見錯誤碼與驗證訊息

carllee1983/ecpay-einvoice-b2c 适用场景与选型建议

carllee1983/ecpay-einvoice-b2c 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 0 次下载、GitHub Stars 达 0，最近一次更新时间为 2025 年 11 月 25 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「sandbox」「laravel」「dto」「Taiwan」「einvoice」「ecpay」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 carllee1983/ecpay-einvoice-b2c 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 carllee1983/ecpay-einvoice-b2c 我们能提供哪些服务？

定制开发 / 二次开发

基于 carllee1983/ecpay-einvoice-b2c 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发