ChatGPT
Claude
Perplexity
Google AI Mode
Microsoft Copilot
Grok
Mistral Le Chat选择Bayarcash SDK
Bayarcash为八种编程语言发布了官方SDK，也为Laravel和Django提供package。每一个都会处理base URL、你的Personal Access Token、request checksum和callback验证，让你少写代码。它们全部开源，放在github.com/bayarcash。
各编程语言的SDK
Section titled “各编程语言的SDK”用你的编程语言的package manager安装对应的SDK：
| 编程语言 | Package | 安装 | 要求 | 源代码 |
|---|---|---|---|---|
| PHP | bayarcash/php-sdk |
composer require bayarcash/php-sdk |
PHP 7.4或更新版本 | php-sdk |
| Node.js和TypeScript | bayarcash |
npm install bayarcash |
Node.js 18或更新版本 | node-sdk |
| Python | bayarcash |
pip install bayarcash |
Python 3.8或更新版本 | python-sdk |
| Go | github.com/bayarcash/go-sdk |
go get github.com/bayarcash/go-sdk |
Go 1.21或更新版本 | go-sdk |
| C#和.NET | Bayarcash |
dotnet add package Bayarcash |
.NET Standard 2.0或更新版本 | dotnet-sdk |
| Dart和Flutter | bayarcash |
dart pub add bayarcash |
Dart 2.17或更新版本 | dart-sdk |
| Ruby | bayarcash |
gem install bayarcash |
Ruby 2.7或更新版本 | ruby-sdk |
| Rust | bayarcash |
cargo add bayarcash |
Rust 1.75或更新版本 | rust-sdk |
最低版本以撰写时为准。每个repository的README都有最新的要求、完整指南和示例。
框架package
Section titled “框架package”如果你的App在Laravel或Django上运行，请使用框架package，而不是普通的SDK。它会加入配置、现成的callback和return route（替你验证checksum）、可选的数据库记录，以及定时对账。
| 框架 | Package | 安装 | 要求 | 源代码 |
|---|---|---|---|---|
| Laravel | bayarcash/laravel |
composer require bayarcash/laravel |
PHP 8.1或更新版本，Laravel 10至12 | laravel |
| Django | django-bayarcash |
pip install django-bayarcash |
Python 3.8或更新版本，Django 3.2至5 | django |
这两个package都一直使用API v3。
把SDK切换到API v3
Section titled “把SDK切换到API v3”各编程语言的SDK支持API v2和v3，并从v2开始。API v2已停用（deprecated），所以创建client后要马上切换到v3。有些method，例如搜索交易，只能在v3使用。
| SDK | 切换到v3 | 使用sandbox |
|---|---|---|
| PHP | $bayarcash->setApiVersion('v3') |
$bayarcash->useSandbox() |
| Node.js | bayarcash.setApiVersion('v3') |
bayarcash.useSandbox() |
| Python | bayarcash.set_api_version("v3") |
bayarcash.use_sandbox() |
| Go | bayarcash.WithAPIVersion("v3")选项 |
bayarcash.WithSandbox(true)选项 |
| .NET | bayarcash.SetApiVersion("v3") |
bayarcash.UseSandbox() |
| Dart | bayarcash.setApiVersion('v3') |
bayarcash.useSandbox() |
| Ruby | bayarcash.set_api_version("v3") |
bayarcash.use_sandbox |
| Rust | .set_api_version(ApiVersion::V3) |
.use_sandbox() |
在正式环境（production）中删除sandbox调用。PHP的完整指南，见使用PHP SDK收款。
如果要在自动化工作流程中使用Bayarcash而不写代码，见在n8n中使用Bayarcash。
- 把token和secret key放在环境变量中。每个SDK的README都使用
YOUR_API_TOKEN之类的占位符。绝对不要把真实的key提交（commit）到你的repository。 - 在项目中固定SDK的版本。package manager的lock file能防止更新在两次部署之间改变运行方式。升级前先阅读SDK的changelog。
常见问题
我安装了SDK，但某个method说它只适用于API版本v3。为什么？
大多数SDK一开始使用API v2。在发出任何request之前，先把client切换到v3，例如PHP中的setApiVersion('v3')。Laravel和Django package已经设为v3。
如果列表中没有我用的编程语言，应该选哪个SDK？
直接调用REST API。把你的Personal Access Token作为bearer token发送，并按照api-reference.bayarcash.com操作。见用Bayarcash API开发。