Provider API

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

Provider adalah daftar bank dan e-wallet yang didukung Mutasiku. Panggil endpoint ini terlebih dahulu untuk mendapatkan nilai code yang Anda butuhkan sebagai providerCode saat membuat akun.

GET /api/v1/provider

Ambil daftar bank dan e-wallet yang tersedia.

Query Parameters

Parameter	Type	Required	Keterangan
`type`	string	No	Filter tipe: `bank` atau `ewallet`. Default: keduanya
`isActive`	boolean	No	Filter status aktif: `true` atau `false`
`search`	string	No	Cari berdasarkan nama atau kode provider

Response 200

{
  "status": "success",
  "data": {
    "banks": [
      {
        "id": "bank-id-123",
        "name": "Bank Central Asia",
        "code": "BCA",
        "isActive": true,
        "pointCost": 500
      },
      {
        "id": "bank-id-456",
        "name": "Bank Mandiri",
        "code": "MANDIRI",
        "isActive": true,
        "pointCost": 500
      }
    ],
    "ewallets": [
      {
        "id": "ewallet-id-123",
        "name": "DANA",
        "code": "DANA",
        "isActive": true,
        "pointCost": 1000
      },
      {
        "id": "ewallet-id-456",
        "name": "OVO",
        "code": "OVO",
        "isActive": true,
        "pointCost": 1000
      },
      {
        "id": "ewallet-id-789",
        "name": "GOPAY Merchant",
        "code": "GOPAY-MERCHANT",
        "isActive": true,
        "pointCost": 1500
      }
    ]
  }
}

Penjelasan Field Respons

Field	Keterangan
`code`	Gunakan nilai ini sebagai `providerCode` saat membuat akun
`isActive`	Hanya provider dengan `isActive: true` yang bisa digunakan
`pointCost`	Jumlah poin yang dikurangi dari saldo Anda setiap kali akun di-sync

Periksa isActive: true sebelum membuat akun. Provider dengan isActive: false tidak dapat digunakan dan akan mengembalikan error 400.

Errors

Status	Keterangan
`401`	API key tidak valid atau tidak ada
`500`	Internal server error

Contoh

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

# Hanya bank
curl 'https://mutasiku.co.id/api/v1/provider?type=bank' \
  -H 'x-api-key: YOUR_API_KEY'

# E-wallet aktif saja
curl 'https://mutasiku.co.id/api/v1/provider?type=ewallet&isActive=true' \
  -H 'x-api-key: YOUR_API_KEY'

# Cari provider
curl 'https://mutasiku.co.id/api/v1/provider?search=bca' \
  -H 'x-api-key: YOUR_API_KEY'