emmajiugo / flutterwave-cli
一个CLI应用程序,帮助您随时随地测试Flutterwave支付,并生成示例应用程序。
Requires
- php: ^7.2.5
- laminas/laminas-text: ^2.7
- laravel-zero/framework: ^7.0
- padraic/phar-updater: ^1.0.6
- vlucas/phpdotenv: ^4.0
- yuloh/open: ^0.1.0
Requires (Dev)
- mockery/mockery: ^1.3.1
- phpunit/phpunit: ^8.5
README
Flutterwave CLI
Flutterwave CLI应用程序可以帮助您随时随地测试Flutterwave的一些功能,并生成示例应用程序,展示这些功能如何以最简单、最便捷的方式工作,以及如何将它们集成到您自己的应用程序或平台中。
设置
- 确保您的计算机上已安装Composer。您可以通过在终端中运行
composer -v
来确认。如果没有安装,您可以使用Composer文档下载并安装。 - 安装Composer后,在终端中运行命令
composer global require emmajiugo/flutterwave-cli
,以全局要求安装。 - 在终端运行
flutterwave -v
以查看可用的命令。
注意:如果您收到错误command not found
,请不要担心 ;) 这不是错误,请访问这个Stackoverflow页面了解如何配置/修复它。 - 通过添加您的Flutterwave密钥(测试和实时)来设置您的CLI。
运行flutterwave setup
。
注意:这是一个一次性设置,您的密钥存储在您的计算机上,不会发送到任何服务器。
用法
NOTE: To use your LIVE credential when making a call,
add the LIVE tag (--live) to all your commands.
快速打开功能API文档
使用此命令flutterwave docs --feature=webhook
快速导航到Flutterwave任何功能的API文档。
要查看所有功能,请运行命令flutterwave docs
。
账户解析
您可以使用CLI快速解析账户号码。
运行flutterwave account:resolve accountNumber bankCode --live
。
注意:您可以使用CLI获取银行代码。以下是如何实现的方法。
检查Flutterwave余额
您可以在不登录仪表板的情况下快速了解您的余额。
运行flutterwave balance
。
要按货币获取,请运行命令flutterwave balance --currency=NGN
(例如,NGN、GHS、USD、EUR等)。
获取银行和银行代码
获取银行及其银行代码。
运行flutterwave bank:list country
。请将country
替换为NG、GH、KE、UG、ZA或TZ。
获取银行分支
获取银行及其分支。
运行flutterwave bank:branch ID
。ID是列出所有银行时返回的。
验证卡BIN
获取有关卡的详细信息。
运行flutterwave card:bin BIN
。请将BIN
替换为借记卡/信用卡上的前6位数字。
外汇汇率
获取Flutterwave使用的外汇汇率。
运行flutterwave fx:rate --amount=100 --from=USD --to=NGN
。
快速付款
使用Flutterwave模态快速进行付款。该命令将在您的浏览器中打开Flutterwave模态并传递信息。
运行flutterwave payment e@x.com 100 --currency=NGN
。
交易验证
快速验证交易以获取交易的最终状态。
运行flutterwave transaction:verify ID
。交易ID是收费响应中的data.id
参数。
重发失败的Webhook
您可以将失败的Webhook快速重发到您在Flutterwave仪表板中添加的Webhook URL。
运行 flutterwave webhook:resend ID
。 ID
是交易的唯一标识符。它在初始化交易调用中作为 data.id
返回。
向本地主机发送 Webhook
这是在不向网络公开您的本地主机的情况下测试 Webhook 的一种简单方法。
您可以使用此命令在开发期间快速测试 Webhook。
运行 flutterwave webhook:ping ID WEBHOOK-URL --event=transfer --hash=password1
。
来自 data.id
的交易 ID
。
在测试目的下,应将 WEBHOOK-URL
替换为您自己的 webhook URL(localhost:8080/flutterwave/webhook
)。--event=
应为 transfer|card
。--hash=
是您的测试密钥散列。
生成示例应用
要生成示例应用,运行 flutterwave generate:app
。
此命令将列出所有可用的或未来支持的示例应用。例如(flutterwave generate:app modal
)以下命令将生成 Flutterwave 模态的示例。
当前支持的示例应用包括
3DSecure
Charge
DB Logging
Extra-Info
即向 Flutterwave 传递额外信息Flutterwave Modal
即内联、标准设置Split Payment
Tokenized Charges
Transfers
Webhook
Chigbo Ezejiugo
emmajiugo@gmail.com