Pilih SDK Bayarcash

Dikemas kini 30 September 2026

Bayarcash menerbitkan SDK rasmi untuk lapan bahasa pengaturcaraan, serta pakej untuk Laravel dan Django. Setiap SDK menguruskan base URL, Personal Access Token anda, checksum request dan pengesahan callback. Jadi, anda perlu menulis lebih sedikit kod. Semua SDK ini open source di github.com/bayarcash.

SDK mengikut bahasa

Install SDK untuk bahasa anda dengan package manager bahasa itu:

Bahasa	Pakej	Install	Keperluan	Sumber
PHP	`bayarcash/php-sdk`	`composer require bayarcash/php-sdk`	PHP 7.4 atau lebih baru	php-sdk
Node.js dan TypeScript	`bayarcash`	`npm install bayarcash`	Node.js 18 atau lebih baru	node-sdk
Python	`bayarcash`	`pip install bayarcash`	Python 3.8 atau lebih baru	python-sdk
Go	`github.com/bayarcash/go-sdk`	`go get github.com/bayarcash/go-sdk`	Go 1.21 atau lebih baru	go-sdk
C# dan .NET	`Bayarcash`	`dotnet add package Bayarcash`	.NET Standard 2.0 atau lebih baru	dotnet-sdk
Dart dan Flutter	`bayarcash`	`dart pub add bayarcash`	Dart 2.17 atau lebih baru	dart-sdk
Ruby	`bayarcash`	`gem install bayarcash`	Ruby 2.7 atau lebih baru	ruby-sdk
Rust	`bayarcash`	`cargo add bayarcash`	Rust 1.75 atau lebih baru	rust-sdk

Versi minimum ini betul semasa panduan ini ditulis. README setiap repository ada keperluan terkini, panduan penuh dan contoh.

Pakej framework

Jika app anda menggunakan Laravel atau Django, guna pakej framework dan bukan SDK biasa. Pakej ini menambah konfigurasi, serta route callback dan return yang sudah siap dan mengesahkan checksum untuk anda. Pakej ini juga menyediakan rekod database (jika perlu) dan reconciliation berjadual.

Framework	Pakej	Install	Keperluan	Sumber
Laravel	`bayarcash/laravel`	`composer require bayarcash/laravel`	PHP 8.1 atau lebih baru, Laravel 10 hingga 12	laravel
Django	`django-bayarcash`	`pip install django-bayarcash`	Python 3.8 atau lebih baru, Django 3.2 hingga 5	django

Kedua-dua pakej sentiasa menggunakan API v3.

Tukar SDK kepada API v3

SDK bahasa menyokong API v2 dan v3, dan bermula pada v2. API v2 sudah deprecated, jadi tukar kepada v3 sebaik sahaja anda mencipta client. Sesetengah method, seperti carian transaksi, hanya berfungsi pada v3.

SDK	Tukar kepada v3	Guna sandbox
PHP	`$bayarcash->setApiVersion('v3')`	`$bayarcash->useSandbox()`
Node.js	`bayarcash.setApiVersion('v3')`	`bayarcash.useSandbox()`
Python	`bayarcash.set_api_version("v3")`	`bayarcash.use_sandbox()`
Go	option `bayarcash.WithAPIVersion("v3")`	option `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()`

Buang panggilan sandbox dalam production. Untuk panduan penuh dalam PHP, lihat Terima bayaran dengan PHP SDK.

Pilihan tanpa kod

Untuk menggunakan Bayarcash dalam workflow automatik tanpa menulis kod, lihat Guna Bayarcash dalam n8n.

Tips

Simpan token dan secret key anda dalam environment variable. Setiap README SDK menggunakan placeholder seperti YOUR_API_TOKEN. Jangan commit keys sebenar ke repository anda.
Pin versi SDK dalam projek anda. Lock file package manager anda menghalang update daripada mengubah tingkah laku SDK antara deploy. Baca changelog SDK itu sebelum anda upgrade.

Isu-isu biasa

Kenapa SDK kata method itu hanya ada untuk API versi v3, walaupun saya sudah install SDK?

Kebanyakan SDK bermula pada API v2. Tukar client kepada v3 sebelum anda membuat sebarang request, contohnya setApiVersion('v3') dalam PHP. Pakej Laravel dan Django sudah ditetapkan kepada v3.

SDK mana yang perlu saya pilih jika bahasa pengaturcaraan saya tiada dalam senarai?

Panggil REST API secara terus. Hantar Personal Access Token anda sebagai bearer token dan ikut api-reference.bayarcash.com. Lihat Bina integrasi dengan Bayarcash API.

Adakah artikel ini membantu?