Data Model

Bagian Data Model mendefinisikan struktur data yang umum digunakan di seluruh layanan API PakaiLink — mulai dari tipe-data sederhana seperti Money, hingga objek kompleks seperti VirtualAccountData dan MultilanguageText. Setiap entitas data mencakup kolom seperti Name, Type, Length, Required, dan Remarks, yang membantu tim pengembangan dan integrasi memahami format, batasan, serta makna dari setiap field. Contoh:

  • Objek Money digunakan untuk menyampaikan nilai nominal beserta kode mata uang.
  • Objek VirtualAccountData mendeskripsikan data-VA yang meliputi nomor VA, nama pelanggan, status pembayaran, jumlah yang dibayar, saldo mitra, dan informasi tambahan.
  • Objek MultilanguageText memungkinkan penggunaan teks dalam dua bahasa (Indonesia dan Inggris) untuk alasan status pembayaran atau pesan lainnya.

Dengan pola yang konsisten ini, integrator dapat memastikan bahwa payload yang dikirim dan diterima sesuai spesifikasi, meminimalkan error pengiriman data, dan memudahkan proses validasi maupun rekonsiliasi.

NoNameTypeLengthRequiredConditionRemarks
1valueStringVariable, 19 maxWajibMenunjukkan besaran nominal yang digunakan dalam transaksi atau proses tertentu dalam sistem.
2currencyStringVariable, 3 maxWajibJenis mata uang yang digunakan dalam transaksi, biasanya direpresentasikan dalam format kode mata uang internasional.
NoNameTypeLengthRequiredConditionRemarks
1paymentFlagReasonMultilanguageTextVariableOptionalAlasan Status Pembayaran multi bahasa
2partnerServiceIdStringFixed, 8 maxWajibKode biller/merchant dari virtual account. Left Padding dengan spasi
3customerNoStringVariable, 20 maxWajibNomor unik (hingga 20 digit). Menggabungkan partnerServiceId dan customerNo atau virtualAccountNo
4virtualAccountNoStringVariable, 28 maxWajibInformasi nomor virtual account yang menggabungkan partnerServiceId dan customerNo
5virtualAccountNameStringVariable, 255 maxWajibInformasi nama pelanggan
6paymentFlagStatusStringFixed, 2 maxWajibStatus untuk pembayaran va. Nilai-nilai tersebut meliputi: Berhasil, pesanan telah dibayar Inisiasi, VA telah dibuat Dibatalkan, VA telah dihapus Gagal, VA telah ditutup karena sudah kedaluwarsa
7trxIdStringVariable, 64 maxWajibPengidentifikasi transaksi unik pada sistem mitra yang ditetapkan untuk setiap transaksi.
8inquiryRequestIdStringVariable, 64 maxWajibPengidentifikasi request unik untuk inquiry.
9paidAmountMoneyVariableOptionalBerisi nominal yang berhasil dibayarkan, berisi dua sub-bidang: Nilai: Transaction paidAmount, termasuk pecahan Mata Uang: Kode mata uang berdasarkan ISO
10feeAmountMoneyVariableOptionalBiaya yang dikenakan pada transaksi, berisi dua sub-bidang: Nilai: Transaction paidAmount, termasuk pecahan Mata Uang: Kode mata uang berdasarkan ISO
11creditbalanceMoneyVariableWajibNominal yang masuk ke saldo mitra, Berisi dua sub-bidang: Nilai: Transaction paidAmount, termasuk pecahan Mata Uang: Kode mata uang berdasarkan ISO
12expiredDateStringFixed, 25 maxOptionalTanggal kedaluwarsa untuk virtual account, dalam format YYYY-MM-DDTHH:mm:ss+07:00. Waktu harus dalam GMT+7 (waktu Jakarta).
13additionalInfoJSON ObjectVariableOptionalInformasi tambahan.
14additionalInfo.callbackUrlStringVariable, 8 maxOptionalURL untuk dapat menerima notifikasi pembayaran setelah pembayaran dilakukan oleh pelanggan.
15balanceMoneyVariableWajibSaldo mitra saat ini, berisi dua sub-bidang: Nilai: Transaction paidAmount, termasuk pecahan Mata Uang: Kode mata uang berdasarkan ISO
NoNameTypeLengthRequiredConditionRemarks
1englishStringVariable, 200 maxWajibAlasan Status Pembayaran dalam Bahasa Inggris.
2indonesiaStringVariable, 200 maxWajibAlasan Status Pembayaran dalam Bahasa Indonesia.

TBA

NoNameTypeLengthRequiredConditionRemarks
1settlementStringVariable, 64 maxWajibDana dari transaksi yang telah diproses dan diteruskan ke rekening tujuan
2paymentStringVariable, 64 maxWajibUntuk menandakan bahwa transaksi telah berhasil dilakukan dan pembayaran sudah diterima
NoNameRemarks
1bankMenunjukkan jenis produk yang berkaitan dengan layanan perbankan
2emoneyMenunjukkan jenis produk yang berkaitan dengan layanan uang elektronik (electronic money).
3retailMenunjukkan jenis produk yang menyediakan layanan pembayaran melalui jaringan gerai ritel fisik seperti Alfamart dan Indomaret
4bankva_dinamisMenunjukkan jenis produk yang menyediakan layanan Virtual Account (VA) dari bank
NoNameRemarks
1cash_inMenunjukkan jenis produk yang digunakan untuk menambahkan saldo
1cash_outMenunjukkan jenis produk yang digunakan untuk penarikan saldo