https://github.com/autoftbot/qris-orderkuota
generate QRIS dan cek status pembayaran Dari Order kuota
https://github.com/autoftbot/qris-orderkuota
orderkuota payment-gateway qris
Last synced: 6 days ago
JSON representation
generate QRIS dan cek status pembayaran Dari Order kuota
- Host: GitHub
- URL: https://github.com/autoftbot/qris-orderkuota
- Owner: AutoFTbot
- License: mit
- Created: 2025-04-24T12:42:38.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2025-06-06T02:00:29.000Z (13 days ago)
- Last Synced: 2025-06-06T02:39:38.043Z (13 days ago)
- Topics: orderkuota, payment-gateway, qris
- Homepage: https://www.orderkuota.com
- Size: 65.4 KB
- Stars: 10
- Watchers: 1
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.go.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# 🚀 Paket Pembayaran QRIS untuk Go
Paket Go yang menyediakan integrasi pembayaran QRIS (Quick Response Code Indonesian Standard) untuk aplikasi Anda.
## 🎯 Fitur Utama
- Generate QRIS dengan format standar
- Pengecekan status pembayaran secara real-time
- Validasi format QRIS
- Kalkulasi checksum CRC16
- Dukungan base QRIS string
- Penanganan error yang lebih baik
- QR code dengan tingkat koreksi error tinggi
## 📦 Instalasi
```bash
go get github.com/AutoFTbot/OrderKuota-go
```
## 🚀 Penggunaan
### Inisialisasi
```go
import "github.com/AutoFTbot/OrderKuota-go/qris"
config := qris.QRISConfig{
MerchantID: "123456789",
APIKey: "your-api-key",
BaseQrString: "your-base-qr-string",
}
qrisInstance, err := qris.NewQRIS(config)
if err != nil {
// handle error
}
```
### Generate QR Code
```go
data := qris.QRISData{
Amount: 100000,
TransactionID: "TRX123",
}
qrCode, err := qrisInstance.GenerateQRCode(data)
if err != nil {
// handle error
}
// Simpan QR code ke file
err = qrCode.Save("qris.png")
```
### Generate QRIS String
```go
data := qris.QRISData{
Amount: 100000,
TransactionID: "TRX123",
}
qrString, err := qrisInstance.GetQRISString(data)
if err != nil {
// handle error
}
```
### Cek Status Pembayaran
```go
status, err := qrisInstance.CheckPaymentStatus("TRX123", 100000)
if err != nil {
// handle error
}
if status.Status == "PAID" {
// Pembayaran berhasil
fmt.Printf("Pembayaran diterima dari %s pada %s\n",
status.BrandName, status.Date)
}
```
### Validasi String QRIS
```go
err := qrisInstance.ValidateQRISString(qrString)
if err != nil {
// handle error
}
```
## 📝 Dokumentasi
### QRISConfig
```go
type QRISConfig struct {
MerchantID string // ID merchant dari payment gateway
APIKey string // API key untuk autentikasi
BaseQrString string // Base QRIS string dari merchant
}
```
### QRISData
```go
type QRISData struct {
Amount int64 // Nominal pembayaran
TransactionID string // ID transaksi unik
}
```
### PaymentStatus
```go
type PaymentStatus struct {
Status string // Status pembayaran (PAID/UNPAID)
Amount int64 // Nominal pembayaran
Reference string // Referensi pembayaran
Date string // Tanggal pembayaran (jika PAID)
BrandName string // Nama brand pembayar (jika PAID)
BuyerRef string // Referensi pembeli (jika PAID)
}
```
### Contoh Kode
```go
package main
import (
"fmt"
"log"
"time"
"github.com/autoftbot/orderkuota-go/qris"
)
func main() {
// Inisialisasi QRIS dengan konfigurasi
config := qris.QRISConfig{
MerchantID: "#",
APIKey: "#",
BaseQrString: "#",
}
// Buat instance QRIS
qrisInstance := qris.NewQRIS(config)
// Generate QR Code
data := qris.QRISData{
Amount: 1000,
TransactionID: "TRX123",
}
qrCode, err := qrisInstance.GenerateQRCode(data)
if err != nil {
log.Fatalf("Error generating QR code: %v", err)
}
// Simpan QR code ke file
err = qrCode.WriteFile(256, "qris.png")
if err != nil {
log.Fatalf("Error saving QR code: %v", err)
}
fmt.Println("QR Code berhasil dibuat dan disimpan sebagai qris.png")
fmt.Println("Silahkan scan QR code untuk melakukan pembayaran...")
// Cek status pembayaran secara berulang
for {
fmt.Println("\nMengecek status pembayaran...")
status, err := qrisInstance.CheckPaymentStatus("TRX123", 1000)
if err != nil {
log.Printf("Error checking payment status: %v", err)
time.Sleep(5 * time.Second)
continue
}
// Tampilkan detail status
fmt.Printf("Status Pembayaran: %s\n", status.Status)
fmt.Printf("Amount yang diharapkan: %d\n", 1000)
fmt.Printf("Amount yang diterima: %d\n", status.Amount)
fmt.Printf("Reference: %s\n", status.Reference)
if status.Status == "PAID" {
fmt.Printf("Pembayaran berhasil!\n")
fmt.Printf("Date: %s\n", status.Date)
fmt.Printf("Brand: %s\n", status.BrandName)
fmt.Printf("Buyer Ref: %s\n", status.BuyerRef)
break
} else {
fmt.Println("Menunggu pembayaran...")
}
// Tunggu 5 detik sebelum cek lagi
time.Sleep(5 * time.Second)
}
}
```
## 🔍 Penanganan Error
Paket ini menyediakan penanganan error yang lebih baik dengan pesan error yang jelas:
- Validasi input saat inisialisasi
- Validasi format QRIS
- Validasi checksum
- Error saat generate QR code
- Error saat cek status pembayaran
## 🛠️ Praktik Terbaik
1. Selalu cek error saat inisialisasi QRIS
2. Gunakan ID transaksi unik untuk setiap transaksi
3. Validasi string QRIS sebelum digunakan
4. Gunakan penanganan error yang tepat
5. Simpan QR code dalam format PNG untuk kualitas terbaik