REST API & SDK

Integrasikan Malawali ke sistem Anda dalam hitungan menit.

Tersedia 50+ endpoint REST API, npm package resmi, dokumentasi OpenAPI, dan API key authentication — semuanya dirancang untuk developer.

Endpoints

Semua Endpoint Inti

Dari pembayaran QRIS hingga PPOB — akses semuanya melalui REST API yang konsisten dan terdokumentasi.

POST /v1/payment/create

Membuat transaksi QRIS baru. Menerima amount, orderId, webhookUrl. Mengembalikan QRIS URL dan data transaksi.

GET /v1/payment/:id/status

Cek status transaksi berdasarkan ID. Mengembalikan status pending, paid, expired, atau cancelled.

POST /v1/payment/:id/cancel

Batalkan transaksi yang masih pending. Membebaskan unique amount untuk digunakan kembali.

GET /v1/payment/list

Ambil daftar transaksi dengan pagination. Filter berdasarkan status. Mendukung page, limit, status.

Quick Start

Mulai dalam 3 Langkah

1

Daftar & Ambil API Key

Buat akun di app.malawalipayment.web.id. API key akan langsung muncul di dashboard.

2

Install SDK

npm install malawali-payment-gateway

3

Buat Transaksi Pertama

Panggil endpoint POST /v1/payment/create — QRIS payment langsung jadi dalam hitungan detik.

Contoh Kode

Copy-paste dan jalankan. Integrasi selesai dalam 5 menit.

Node.js — Create Payment + Check + List

const pg = require("malawali-payment-gateway");

async function run() {
  const apiKey = "YOUR_API_KEY";

  // Buat pembayaran
  const pay = await pg.createPayment(apiKey, 10000, {
    orderId: "INV-001",
    webhookUrl: "https://mysite.com/hooks/malawali"
  });
  console.log("QR:", pay.result.qris_url);

  // Cek status
  const check = await pg.checkPayment(apiKey, pay.result.idtrx);
  console.log("Status:", check.status);

  // List transaksi
  const list = await pg.getPaymentList(apiKey, { page: 1, limit: 5 });
  console.log("Total:", list.pagination.total);
}

run();
Spesifikasi

Teknis Integrasi

Base URL

https://api.malawali.ai.id

Autentikasi

API key via query param atau JSON body: apikey=HEROVR

Format

JSON request & response. HTTP status codes sesuai standar REST API.

Library

malawali-payment-gateway di npm. Satu dependency: axios.

Siap Integrasi?

Buka dokumentasi, ambil API key-nya, dan langsung integrasi.