scbz — SociaBuzz di-Go-kan. SDK dan REST gateway untuk platform donasi SociaBuzz.
18 negara, 100+ metode pembayaran — e-wallet, bank transfer, kartu kredit, USDT, BTC, ETH, Binance Pay.

import "github.com/hirotomasato/scbz/sociabuzz"

🇮🇩 Indonesia 🇲🇾 Malaysia 🇸🇬 Singapore 🇵🇭 Philippines 🇹🇭 Thailand
🇵🇰 Pakistan 🇧🇩 Bangladesh 🇱🇰 Sri Lanka
🇦🇪 UAE 🇸🇦 Saudi Arabia 🇶🇦 Qatar
🇳🇬 Nigeria 🇿🇦 South Africa
🇬🇧 UK 🇩🇰 Denmark
🇦🇺 Australia 🇳🇿 New Zealand
🇺🇸 United States

go get github.com/hirotomasato/scbz

scbz/
├── sociabuzz/              # Go SDK — 2.650 baris
│   ├── client.go           # SociaBuzz, Donation, Payment — OOP flow
│   ├── http.go             # HTTP client: cookie jar, CSRF, 6 endpoints
│   ├── fees.go             # FeeCalculator — cek fee tanpa donasi
│   ├── constants.go        # 18 negara + group labels
│   ├── models.go           # Semua struct data & DTO
│   ├── errors.go           # 5 error types
│   └── json.go             # Helpers JSON
├── server/                 # REST API gateway
│   ├── config.go           # Env-driven settings
│   ├── auth.go             # API key middleware (Bearer/X-API-Key/query)
│   ├── schemas.go          # Request/response JSON structs
│   ├── session.go          # Session store: Memory atau SQLite
│   ├── webhook.go          # Background poller + HMAC signature
│   └── routes/             # Handler per endpoint
│       ├── donate.go       # POST /api/donate
│       ├── fees.go         # POST /api/fees + GET /api/fees/countries
│       └── payment.go      # POST /api/payment/{methods,create,status}
└── cmd/
    ├── main.go             # CLI smoke test
    └── scbz-server/        # Server entry point (chi router)

sequenceDiagram
    participant Client
    participant Server as scbz Server
    participant SB as SociaBuzz

    Note over Client,SB: Langkah 0 — Cek fee (opsional)
    Client->>Server: POST /api/fees
    Server->>SB: Init session + submit mini-donate
    SB-->>Server: Fee table per metode
    Server-->>Client: 200 OK + daftar fee

    Note over Client,SB: Langkah 1 — Submit donasi
    Client->>Server: POST /api/donate
    Server->>SB: Init session + submit form
    SB-->>Server: Token + redirect URL
    Server-->>Client: 200 OK + token

    Note over Client,SB: Langkah 2 — List metode bayar
    Client->>Server: POST /api/payment/methods
    Server->>SB: Visit payment page + fetch settings
    SB-->>Server: Payment channels + fees
    Server-->>Client: 200 OK + daftar metode

    Note over Client,SB: Langkah 3 — Buat pembayaran
    Client->>Server: POST /api/payment/create
    Server->>SB: POST create payment
    SB-->>Server: Payment URL / QR string
    Server-->>Client: 200 OK + URL redirect

    Note over Client,SB: Langkah 4 — Cek status
    Client->>Server: POST /api/payment/status
    Server->>SB: GET /payment/pending
    SB-->>Server: HTML status page
    Server-->>Client: 200 OK + status

package main

import (
    "context"
    "fmt"
    "github.com/hirotomasato/scbz/sociabuzz"
)

func main() {
    ctx := context.Background()
    sb := sociabuzz.New("https://sociabuzz.com")

    // Langkah 1 — Submit donasi
    donation, err := sb.Donate(ctx, "creator_username", 10000, "Indonesia",
        "Budi", "budi@email.com", "Semangat!")
    if err != nil { panic(err) }
    defer donation.Close()

    // Langkah 2 — Lihat metode bayar + fee
    methods, _ := donation.GetPaymentMethods(ctx)
    for _, m := range methods {
        fmt.Printf("#%d %-20s fee=%s pay=%s\n", m.ID, m.Label, m.Fee.TotalFee, m.Fee.TotalPay)
    }

    // Langkah 3 — Pilih metode dan dapatkan payment URL
    payment, _ := donation.CreatePayment(ctx, "gopay")
    fmt.Println("Redirect user ke:", payment.PaymentURL)

    // Langkah 4 — Poll status
    status, _ := payment.CheckStatus(ctx)
    fmt.Println("Status:", status)
}

calc := sociabuzz.NewFeeCalculator("https://sociabuzz.com", "creator")
estimates, _ := calc.Estimate(ctx, "Indonesia", 10000, "creator")
for _, e := range estimates {
    fmt.Printf("%-20s %s fee=%s pay=%s\n", e.Label, e.Currency, e.Fee.TotalFee, e.Fee.TotalPay)
}
calc.Close()

git clone https://github.com/hirotomasato/scbz
cd scbz

export SOCIABUZZ_USERNAME=creator_kamu
export API_KEY=rahasia123
go run ./cmd/scbz-server/
# → http://localhost:8000

# Cek fee GoPay untuk donasi Rp10.000
curl -X POST http://localhost:8000/api/fees \
  -H "Content-Type: application/json" \
  -d '{"country":"Indonesia","amount":10000,"username":"creator"}'

# Submit donasi
curl -X POST http://localhost:8000/api/donate \
  -H "Content-Type: application/json" \
  -d '{"username":"creator","amount":10000,"country":"Indonesia","fullname":"Budi","email":"budi@test.com"}'

Semua endpoint POST dan GET — request/response JSON.

Cek biaya transaksi per metode pembayaran sebelum donasi. Tidak ada yang ditagih.

// Request
{"country":"Indonesia","amount":10000,"username":"msdigital"}

// Response (200)
{
  "success": true,
  "country": "Indonesia",
  "currency": "IDR",
  "amount": 10000,
  "methods": [
    {
      "id": 1,
      "name": "gopay",
      "label": "Gopay",
      "group": "E-Wallet",
      "gateway": "midtrans",
      "fee": {
        "fee_type": "percent",
        "fee_rate": 0.02,
        "total_fee": "204",
        "total_pay": "10,204",
        "min_amount": 1000,
        "max_amount": 5000000
      }
    }
  ],
  "total": 23
}

// Request
{"username":"msdigital","amount":10000,"country":"Indonesia",
 "fullname":"Budi","email":"budi@test.com","note":"Semangat!"}

// Response (200)
{
  "success": true,
  "token": "e1125eb6-bd41-11f1-bb82-cee239a73494",
  "country": "Indonesia",
  "currency": "IDR",
  "amount": 10000,
  "redirect_url": "https://sociabuzz.com/payment/x/e1125eb6-...",
  "expires_in": 3600
}

{"token":"e1125eb6-bd41-11f1-bb82-cee239a73494"}

{"token":"e1125eb6-...","payment_method":"gopay"}

{
  "success": true,
  "payment_method": "gopay",
  "label": "Gopay",
  "gateway": "midtrans",
  "payment_url": "https://app.midtrans.com/snap/v4/redirection/...",
  "inv_id": "TRIBE-IDR-261001-..."
}

{"token":"e1125eb6-...","inv_id":"TRIBE-IDR-...","payment_method":"gopay"}
// → {"success":true,"token":"...","status":"pending"}

{
  "success": true,
  "total": 18,
  "countries": [
    {"country":"Indonesia","currency":"IDR","iso2":"ID"},
    {"country":"Malaysia","currency":"MYR","iso2":"MY"},
    ...
  ]
}

Kalau callback_url disertakan saat donate, server polling status tiap WEBHOOK_POLL_INTERVAL detik. Ketika status terminal tercapai (paid/expired/failed), POST ke callback_url:

{
  "event": "payment.paid",
  "token": "uuid",
  "inv_id": "TRIBE-IDR-...",
  "payment_method": "gopay",
  "status": "paid",
  "timestamp": 1700000000
}

Header X-Webhook-Secret + X-Webhook-Signature (HMAC-SHA256) dikirim jika WEBHOOK_SECRET diset.

Catatan: Metode yang tersedia tergantung negara akun creator, bukan negara donor. Creator Indonesia → metode Indonesia (GoPay, OVO, DANA, QRIS, bank, kartu). Creator US/Malaysia → metode negara tsb + USDT/crypto via TripleA.

Touch n Go, GrabPay, ShopeePay, FPX, Credit Card, BTC/ETH/USDT/USDC/Binance

PayNow QR, GrabPay, BTC/ETH/USDT/USDC/Binance

GCash, Paymaya, GrabPay, ShopeePay, QR Ph, Bank Redirect, Crypto

PromptPay QR, LINE Pay, TrueMoney, ShopeePay, Bank, Crypto

Credit Card + Google Pay + Apple Pay + BTC/ETH/USDT/USDC/PYUSD/Binance via TripleA (1%)

Detail fee lengkap: lihat curl -X POST /api/fees dengan country tujuan.

MIT — bebas pakai, modifikasi, distribusi.

scbz adalah Go SDK untuk menerima donasi via SociaBuzz. Cocok untuk content creator Indonesia.

export SOCIABUZZ_USERNAME=nama_creator
export API_KEY=buat_key_acak
go run ./cmd/scbz-server/

# Cek fee GoPay untuk donasi Rp10.000
curl -X POST http://localhost:8000/api/fees \
  -H "Content-Type: application/json" \
  -d '{"country":"Indonesia","amount":10000}'

// SDK langsung
sb := sociabuzz.New("https://sociabuzz.com")
donation, err := sb.Donate(ctx, "creator", 10000, "Indonesia", "Budi", "budi@test.com", "")

💡 Mau USDT? Cukup ganti country ke Malaysia/US/Singapore saat donasi —
atau bikin akun SociaBuzz di negara yang support TripleA.

SDK ini tidak resmi — dibuat dengan reverse-engineer dari alur donasi publik SociaBuzz.
Tidak ada afiliasi dengan SociaBuzz. Perubahan upstream bisa merusak SDK tanpa peringatan.
Gunakan dengan risiko sendiri (lihat LICENSE).