BabyGo Docs

Dokumentasi integrasi BabyGo

Semua yang dibutuhkan integrator ada di sini: create checkout, QR display, status endpoint, cancel invoice, sampai webhook callback.

Coba BabyGo Base URL OpenAPI LLMs.txt

Authx-client-api-key

QR OutputqrisString + qrUrl

RealtimeWebhook callback

Fallbackcheck-status

POSTWebhook

Webhook Callback

Webhook adalah jalur utama notifikasi pembayaran. BabyGo akan mengirim event ke callback URL kamu sesuai event yang diaktifkan.

Event yang tersedia meliputi transaction.received, invoice.paid, invoice.expired, dan invoice.cancelled.

Signature dibuat dari timestamp dan raw JSON body menggunakan HMAC-SHA256 agar payload bisa diverifikasi dengan aman.

User-AgentBabyGo-Callback/1.0

SignatureX-Signature: v1=<hmac_sha256_hex>

Replay guardSimpan X-Callback-Id

Hal yang perlu diingat

Verifikasi signature pakai body mentah sebelum JSON.parse()
Gunakan webhook sebagai jalur utama notifikasi
Simpan callbackId untuk mencegah double process

Signature Verification (Node.js)

# BabyGo callback headers
Content-Type: application/json
User-Agent: BabyGo-Callback/1.0
X-Callback-Event: invoice.paid
X-Signature: v1=<hmac_sha256_hex>
X-Callback-Id: cb_xxx
X-Callback-Timestamp: 2026-04-08T10:15:12.000Z
X-Client-Code: BG-YOUR-WORKSPACE

Webhook Payload Example

invoice.paid

{
  "callbackId": "cb_1234567890abcdef",
  "event": "invoice.paid",
  "occurredAt": "2026-04-08T10:15:12.000Z",
  "client": {
    "id": "cli_xxx",
    "code": "BG-YOUR-WORKSPACE",
    "name": "Workspace Demo"
  },
  "invoice": {
    "id": "inv_xxx",
    "referenceLabel": "INV-ABC123",
    "externalReference": "ORDER-20260408-001",
    "amount": 5000,
    "currency": "IDR",
    "status": "paid",
    "paidAt": "2026-04-08T10:15:11.000Z",
    "merchantConnectionId": "mconn_your_connected_merchant"
  },
  "transaction": {
    "journalReferenceId": "0187XXXXXXXX",
    "referenceId": "04202604070856276S75q7fjgPID",
    "referenceLabel": "INV-ABC123",
    "orderId": "QRIS-04202604070856276S75q7fjgPID",
    "amount": 5000,
    "currency": "IDR",
    "status": "success",
    "paymentType": "qris",
    "procedure": "static",
    "channelType": "STATIC_QR",
    "issuer": "BCAD",
    "transactionTime": "2026-04-08T10:15:08.000Z",
    "settlementTime": "2026-04-08T10:15:11.000Z"
  }
}

Dokumentasi integrasi BabyGo

Webhook Callback

Hal yang perlu diingat

Endpoint dan panduan yang biasanya dibaca bareng halaman ini

Endpoint dan panduan yang biasanya dibaca bareng halaman ini