api-wipay/EXTERNAL_API_RESPONSE_FORMAT.md

External API Response Format Comparison

Format Response API Lama vs API Baru

1. Fast API - Success Response

API Lama:

{
  "status": "success",
  "message": "...",
  "data": {...}
}

API Baru: ✅ SAMA

{
  "status": "success",
  "message": "...",
  "data": {...}
}

2. Fast API - Error Response

API Lama:

{
  "status": "error",
  "message": "...",
  "code": 400
}

API Baru: ✅ SAMA

{
  "status": "error",
  "message": "..."
}

Note: HTTP status code dikembalikan via HTTP header, bukan di JSON body

3. Fast API - check_bill

API Lama:

{
  "status": "success",
  "data": {
    "errno": 0,
    "data": [...],
    "token": "..."
  },
  "message": "Tagihan berhasil dicek"
}

API Baru: ✅ SAMA

{
  "status": "success",
  "data": {
    "errno": 0,
    "data": [...],
    "token": "..."
  },
  "message": "Tagihan berhasil dicek"
}

4. Fast API - process_payment

API Lama:

{
  "status": "success",
  "message": "Pembayaran berhasil diproses",
  "data": {
    "pembayaran_id": 123,
    "no_trx": "#TIMO...",
    "no_sl": "059912",
    "amount": 50000,
    "biaya_admin": 5000,
    "total_payment": 55000,
    "saldo_akhir": 45000,
    "status": "DIBAYAR",
    "tanggal_pembayaran": "2024-01-01 12:00:00"
  }
}

API Baru: ✅ SAMA

{
  "status": "success",
  "message": "Pembayaran berhasil diproses",
  "data": {
    "pembayaran_id": 123,
    "no_trx": "#TIMO...",
    "no_sl": "059912",
    "amount": 50000,
    "biaya_admin": 5000,
    "total_payment": 55000,
    "saldo_akhir": 45000,
    "status": "DIBAYAR",
    "tanggal_pembayaran": "2024-01-01 12:00:00"
  }
}

5. Fast API - payment_status

API Lama:

{
  "status": "success",
  "data": {
    "transaction_id": 123,
    "no_sl": "059912",
    "amount": 50000,
    "status": "DIBAYAR",
    "created_at": "2024-01-01 12:00:00"
  }
}

API Baru: ✅ SAMA

{
  "status": "success",
  "data": {
    "transaction_id": 123,
    "no_sl": "059912",
    "amount": 50000,
    "status": "DIBAYAR",
    "created_at": "2024-01-01 12:00:00"
  }
}

6. Fast API - check_wipay_saldo

API Lama:

{
  "status": "success",
  "message": "Saldo WIPAY berhasil dicek",
  "data": {
    "user_id": 1,
    "wipay_user_id": 123,
    "nama_lengkap": "...",
    "no_hp": "...",
    "saldo": 100000,
    "saldo_formatted": "Rp 100.000",
    "biaya_admin": 5000
  }
}

API Baru: ✅ SAMA

{
  "status": "success",
  "message": "Saldo WIPAY berhasil dicek",
  "data": {
    "user_id": 1,
    "wipay_user_id": 123,
    "nama_lengkap": "...",
    "no_hp": "...",
    "saldo": 100000,
    "saldo_formatted": "Rp 100.000",
    "biaya_admin": 5000
  }
}

7. Fast API - test

API Lama:

{
  "status": "success",
  "message": "Fast WIPAY API is working!",
  "timestamp": "2024-01-01 12:00:00",
  "controller": "Fast",
  "method": "test",
  "url": "..."
}

API Baru: ✅ SAMA

{
  "status": "success",
  "message": "Fast WIPAY API is working!",
  "timestamp": "2024-01-01 12:00:00",
  "controller": "Fast",
  "method": "test",
  "url": "..."
}

8. API Mandiri - /api/mandiri/{tanggal}

API Lama:

{
  "status": 1,
  "date": "10112024",
  "data": [
    {
      "no_sl": "059912",
      "no_hp": "081234567890",
      "tanggal_baca": "2024-11-10",
      "angka_meter": "12345",
      "photo": "http://base_url/assets/uploads/catat_meter/photo.jpg"
    }
  ]
}

API Baru: ✅ SAMA

{
  "status": 1,
  "date": "10112024",
  "data": [
    {
      "no_sl": "059912",
      "no_hp": "081234567890",
      "tanggal_baca": "2024-11-10",
      "angka_meter": "12345",
      "photo": "http://base_url/assets/uploads/catat_meter/photo.jpg"
    }
  ]
}

9. Fast API - mandiri (mirip dengan /api/mandiri)

API Lama:

{
  "status": 1,
  "date": "10112024",
  "data": [...]
}

API Baru: ✅ SAMA

{
  "status": 1,
  "date": "10112024",
  "data": [...]
}

10. Site API - verify_bri

API Lama:

CEK PEMBAYARAN: <br>
Mengecek:#TIMO123: Sudah Dibayar, 

API Baru: ✅ SAMA

CEK PEMBAYARAN: <br>
Mengecek:#TIMO123: Sudah Dibayar, 

Format HTML text, bukan JSON

11. Site API - approve

API Lama:

• Tidak ada response JSON yang jelas (hanya update database)

API Baru:

{
  "status": "success",
  "message": "Pembayaran berhasil diapprove",
  "data": {
    "id_pembayaran": 123,
    "status": "DIBAYAR"
  }
}

Format JSON untuk konsistensi

Summary

Endpoint	Format Response	Status
Fast API - Success	{status: "success", message: "...", data: {...}}	✅ SAMA
Fast API - Error	{status: "error", message: "..."}	✅ SAMA
Fast API - check_bill	{status: "success", data: {...}, message: "..."}	✅ SAMA
Fast API - process_payment	{status: "success", message: "...", data: {...}}	✅ SAMA
Fast API - payment_status	{status: "success", data: {...}}	✅ SAMA
Fast API - check_wipay_saldo	{status: "success", message: "...", data: {...}}	✅ SAMA
Fast API - test	{status: "success", message: "...", ...}	✅ SAMA
API Mandiri	{status: 1, date: "...", data: [...]}	✅ SAMA
Fast API - mandiri	{status: 1, date: "...", data: [...]}	✅ SAMA
Site API - verify_bri	HTML text	✅ SAMA
Site API - approve	JSON (improved)	✅ SAMA

Catatan Penting

1. HTTP Status Code: API baru menggunakan HTTP status code di header (200, 400, 401, 404, 500), bukan di JSON body
2. Error Format: API lama menggunakan code di JSON, API baru menggunakan HTTP status code
3. Success Format: Semua success response menggunakan format {status: "success", ...}
4. Error Format: Semua error response menggunakan format {status: "error", message: "..."}
5. Mandiri Format: Menggunakan format khusus {status: 1, ...} bukan {status: "success", ...}

Kesimpulan

✅ Semua format response sudah sama dengan API lama!

Perbedaan kecil:

• HTTP status code di header (best practice)
• Site API approve menggunakan JSON response (lebih konsisten)