WAGO APIv2.5

WAGO API Reference

Selamat datang di dokumentasi resmi API WAGO Payment ID. Dokumentasi ini dirancang agar mudah dibaca, dengan contoh kode langsung.

Gunakan API ini untuk menerima pembayaran QRIS, Virtual Account, dan E-Wallet secara otomatis.

Download PDF Manual Download Integrasi (.md)

Peraturan Integrasi Penting!

Merchant WAJIB mengarahkan (redirect) pelanggan ke Link Portal Pembayaran WAGO yang dikembalikan oleh API. Anda TIDAK DIBOLEHKAN melakukan embed (menanamkan) halaman pembayaran langsung ke dalam website Anda (misalnya menggunakan iframe atau menembak API secara langsung untuk ditampilkan di web Anda) tanpa adanya negosiasi dan persetujuan khusus dari pihak WAGO.

Base URL

https://wago-payment-id.vercel.app

Authentication

WAGO menggunakan otentikasi berbasis API Key. Setiap request wajib menyertakan API Key di header HTTP.

Key	Description
x-api-key	RequiredSecret Key dari Dasbor Merchant.

Example Headers

text

Content-Type: application/json
x-api-key: sk_live_your_secret_key_here

Create Order

Endpoint untuk men-generate link pembayaran baru. Response berisi URL Checkout unik.

Body Parameters (JSON)

Parameter	Description
order_id string	ID unik pesanan. Maks 50 karakter. Required
app_id string	Username / App ID Merchant Anda. Required
nominal integer	Total pembayaran tanpa desimal. Required
webhook_url string	URL webhook untuk notifikasi. Required
callback_url string	URL redirect setelah bayar. Optional

Example Request

POST /api/order

curl

curl --location 'https://wago-payment-id.vercel.app/api/order' \
--header 'Content-Type: application/json' \
--header 'x-api-key: sk_live_your_secret_key' \
--data-raw '{
  "order_id": "INV-2026-001",
  "app_id": "Toko_Saya",
  "nominal": 50000,
  "webhook_url": "https://toko.com/webhook",
  "callback_url": "https://toko.com/success"
}'

Example Response

json

{
  "status": "success",
  "data": {
    "order_id": "INV-2026-001",
    "nominal": 50000,
    "nominal_unik": 50123,
    "status": "PENDING",
    "payment_url": "https://wago-payment-id.vercel.app/checkout/64b..."
  }
}

Webhook Callback

Saat pelanggan berhasil membayar, WAGO mengirimkan HTTP POST (JSON) ke webhook_url.

Anti-Fraud Signature Verification

Wajib memvalidasi HMAC SHA256 Signature untuk memastikan request berasal dari WAGO.

Expected_Sig = hash("sha256", order_id + ":" + status + ":" + nominal_unik + ":" + t + ":" + api_key)

Incoming Webhook Payload

json

{
  "order_id": "INV-2026-001",
  "nominal_unik": 50123,
  "status": "SUCCESS",
  "t": "1716768000",
  "sig": "b94d27b9934d3e08a52e52..."
}

Check Status

Cek status pembayaran melalui endpoint GET dengan order ID.

Server-Side Redaction

Tanpa x-api-key yang valid, API menyembunyikan data sensitif.

Example Request

GET /api/order?id=[ORDER_ID]

curl

curl --location 'https://wago-payment-id.vercel.app/api/order?id=INV-2026-001' \
--header 'x-api-key: sk_live_your_secret_key'

Payment Methods

SUPERBANK

QRIS

BCA

CIMB

JAGO

NEO

SEABANK

BI-FAST

BI_FAST

CMS Integrations

Plugin resmi untuk menghemat waktu integrasi di platform favorit Anda.

WAGO WooCommerce Gateway

Plugin pembayaran untuk toko online WooCommerce.

Download .zip

WHMCS

WAGO WHMCS Module

Segera

Otomatiskan pembayaran invoice klien WHMCS.

WAGO OpenCart Extension

Segera

Integrasi pembayaran untuk OpenCart.