Payin - Recon File

Endpoint: POST /api/v1/payin/reconFile

Headers:

• token: <string> (API token)
• Content-Type: application/json

Request body:

{
  "date": "2026-03-04"
}

Contoh curl:

curl --location '{ROOT_URL}/api/v1/payin/reconFile' \
  --header 'token: 0a1225c5-0930-4c55-b318-f530eb3333b9' \
  --header 'Content-Type: application/json' \
  --data '{"date": "2026-03-04"}'

Contoh response (job queued):

{
  "logId": "2wasdMZttp0UM00NAps0",
  "status": true,
  "message": "Export job queued",
  "data": {
    "jobId": "6527b5959ee883846f7c",
    "note": "Request accepted; re-submit same request to check status; will return download URL when ready"
  }
}

Contoh response (export ready):

{
  "logId": "20ExtHQSUb4qT3CheVLD",
  "status": true,
  "message": "Export ready",
  "data": {
    "jobId": "6527b5959ee883846f7c",
    "download": "https://.../recon_2026-03-04_6527b5959ee883846f7c.csv?X-Amz-..."
  }
}

Penjelasan:

• date: tanggal recon yang ingin diekspor (format YYYY-MM-DD).
• Saat pertama kali request, API akan mengantrikan job dan mengembalikan jobId.
• Jika job belum selesai, kirim ulang request yang sama untuk mengecek status.
• Ketika selesai, response akan berisi field download yang merupakan URL sementara untuk mengunduh CSV recon.

Field response utama:

• logId: ID log permintaan.
• status: boolean, true jika berhasil.
• message: pesan singkat status.
• data.jobId: ID job export.
• data.download: (jika siap) presigned URL untuk mengunduh file CSV.

Catatan keamanan:

• URL download biasanya bersifat sementara (presigned) dan memiliki masa berlaku.
• Jaga token API Anda dengan aman; jangan di-commit ke repo.