Mutations API

Semua endpoint membutuhkan header x-api-key. Lihat Authentication.

Mutasi adalah data transaksi dari semua akun yang terhubung. CREDIT berarti uang masuk ke rekening, DEBIT berarti uang keluar. Data diperbarui otomatis sesuai intervalMinutes masing-masing akun, atau bisa di-trigger manual via refresh.

GET /api/v1/mutations

Ambil data transaksi dari semua rekening yang terhubung.

Query Parameters

Parameter	Type	Required	Keterangan
`accountId`	string	No	Filter berdasarkan ID akun spesifik
`accountType`	string	No	Filter tipe akun: `bank` atau `wallet`
`type`	string	No	Filter tipe transaksi: `CREDIT` atau `DEBIT` (case sensitive)
`search`	string	No	Cari di deskripsi, nomor rekening, atau nomor HP
`startDate`	string	No	Tanggal mulai format `YYYY-MM-DD` (inklusif)
`endDate`	string	No	Tanggal akhir format `YYYY-MM-DD` (inklusif)
`minAmount`	number	No	Jumlah minimum transaksi
`maxAmount`	number	No	Jumlah maksimum transaksi
`page`	number	No	Halaman pagination (default: `1`)
`limit`	number	No	Jumlah item per halaman (default: `10`, max: `100`)

Response 200

{
  "status": "success",
  "data": [
    {
      "id": "af0ab8bd-3051-411e-81d1-7e9a384e1d30",
      "amount": 39921,
      "type": "DEBIT",
      "description": "Kirim Uang",
      "senderName": "Ahmad Rahmat",
      "recipientName": "Siti Nurhaliza",
      "status": "SUCCESS",
      "createdAt": "2024-11-18T11:41:28.000Z",
      "account": {
        "type": "wallet",
        "id": "949382b6-f5e8-461f-88fc-d4f37fc62c22",
        "phoneNumber": "+62-85157367702",
        "accountName": "DANA Bisnis",
        "provider": {
          "name": "DANA",
          "code": "DANA"
        }
      },
      "payment": {
        "orderId": "ORD123",
        "customerName": "John Doe",
        "customerEmail": "john@example.com",
        "customerPhone": "+62-8123456789",
        "metadata": {}
      }
    }
  ],
  "pagination": {
    "total": 50,
    "page": 1,
    "limit": 10,
    "totalPages": 5,
    "hasMore": true
  }
}

Penjelasan Field Respons

Field	Keterangan
`type`	`CREDIT` = uang masuk, `DEBIT` = uang keluar
`amount`	Jumlah transaksi dalam Rupiah
`senderName`	Nama pengirim (tersedia untuk transaksi CREDIT)
`recipientName`	Nama penerima (tersedia untuk transaksi DEBIT)
`status`	Status transaksi: `SUCCESS`, `PENDING`, atau `FAILED`
`payment`	Hanya ada jika transaksi ini terkait dengan Payment yang dibuat via Mutasiku. `null` untuk transaksi organik.

Field payment berguna untuk mencocokkan pembayaran pelanggan dengan transaksi masuk. Jika payment tidak null, artinya uang masuk ini adalah hasil dari tagihan yang Anda buat via Payments API.

Errors

Status	Keterangan
`400`	Parameter tidak valid (contoh: format tanggal salah)
`401`	API key tidak valid atau tidak ada
`404`	Data tidak ditemukan
`500`	Internal server error

Contoh

# Semua mutasi
curl 'https://mutasiku.co.id/api/v1/mutations' \
  -H 'x-api-key: YOUR_API_KEY'

# Uang masuk saja
curl 'https://mutasiku.co.id/api/v1/mutations?type=CREDIT' \
  -H 'x-api-key: YOUR_API_KEY'

# Filter rentang tanggal
curl 'https://mutasiku.co.id/api/v1/mutations?startDate=2024-01-01&endDate=2024-12-31' \
  -H 'x-api-key: YOUR_API_KEY'

# Mutasi e-wallet + uang masuk
curl 'https://mutasiku.co.id/api/v1/mutations?accountType=wallet&type=CREDIT' \
  -H 'x-api-key: YOUR_API_KEY'

# Filter jumlah + pencarian
curl 'https://mutasiku.co.id/api/v1/mutations?search=transfer&minAmount=10000&maxAmount=1000000' \
  -H 'x-api-key: YOUR_API_KEY'

# Kombinasi lengkap
curl 'https://mutasiku.co.id/api/v1/mutations?accountType=bank&type=DEBIT&startDate=2024-01-01&endDate=2024-12-31&page=2&limit=20' \
  -H 'x-api-key: YOUR_API_KEY'