A.2 Error Code
B.1.21 From Account
Merupakan sumber akun yang melakukan pembayaran dan harus dicantumkan ke dalam setiap metode pembayaran. Terdiri dari 13 digit dengan
Merupakan akun tujuan pembayaran dan harus dicantumkan pada setiap metode transaksi pembayaran dan berisi nomor akun dengan total 20 nomor digit.
B.2 Method
Untuk mengakses API Maybank, API SolusiPay perlu token akses untuk membuat koneksi dengan metode lainnya. Untuk mendapatkan token akses API SolusiPay perlu mengakses metode AccessToken dengan menggunakan parameter ID client dan secret key client dengan nilai grant type “client_credentials”.
Metode diakses dengan menggunakan metode POST dan perlu menggunakan default trust manager. Apabila API Maybank langsung diakses tanpa menggunakan default trust manager, maka akan mengeluarkan pesan error pada sertifikat SSL handshake. Metode ini akan mengirim success response yang berupa nilai akses token, tipe token, dan waktu kadaluarsa token dalam satuan detik seperti pada Gambar 3.37 dibawah ini.
Gambar 3.37 Success response getAccessToken
API Maybank memiliki 3 metode yang terdiri dari proses inquiry, payment, dan reversal. inquiry, Proses inquiry bertujuan untuk menarik data Cyber Account (CA) ke aggregator IDS untuk ditransfer ke biller; payment, bertujuan untuk melakukan pembayaran dari CA ke biller dengan menggunakan data hasil inquiry sebelumnya; reversal, bertujuan untuk mengubah status pembayaran dari terbayar menjadi belum terbayar dan digunakan apabila proses pembayaran gagal ditengah jalan; advice, bertujuan untuk mengecek status suatu transaksi seperti adanya kesalahan parameter POST maupun di HTTPRequest serta apabila terjadi gangguan internal pada server tujuan dan sebagainya. Tipe pengiriman data menggunakan metode POST dan menggunakan tipe pengiriman dalam bentuk raw data.
Setiap metode header API Maybank memiliki nilai parameter yang sama dengan metode lainnya. Berikut adalah tabel 3.15 yang berisi daftar parameter header dan detailnya.
Tabel 3.15 Detail parameter header
Field Name Format Description
messageID Ans-32 UUID Unique Number
channelID An-10 Identification Channel Code (MBS for Mitra Bisnis/Payment Point and MRMT for Mitra Remittance)
Tabel 3.15 Detail parameter header (lanjutan)
Field Name Format Description
reference Ans-20 Mitra/Channel Reference Number transdatetime dd-MM-yyyy hh:mm:ss Message Transamission Date Time
B.2.1 Inquiry
Proses inquiry memiliki 2 macam metode akses, yaitu billinquiry dan transferInquiryInfo. Kedua metode ini bertujuan untuk menghubungkan cyber account pelanggan ke Maybank untuk melakukan permohonan pembayaran.
Berikut adalah contoh ketentuan dari metode billinquiry dan transferInquiryInfo yang dijelaskan pada tabel 3.16 dan tabel 3.17.
Tabel 3.16 Detail parameter billinquiry
Field Name & Description Request Response
MTI Message Type Identifier 0200 0210
DE032 Acquiring Institution Identification Code M M
DE037 Retrieval Reference Number M M
DE039 Response Code - M
DE041 Card Acceptor Terminal ID M M
DE042 Card Acceptor Identification C C
DE043 Card Acceptor Name/Location C C
DE048 Additional Data – Private M M
DE049 Transaction Currency Code M M
DE062 Additional Data - C
DE098 Payee M M
DE102 From Account M M
Tabel 3.17 Detail parameter transferInquiryInfo
Field Name & Description Request Response
MTI Message Type Identifier 0200 0210
DE032 Acquiring Institution Identification Code M M
DE037 Retrieval Reference Number M M
DE039 Response Code - M
DE041 Card Acceptor Terminal ID M M
DE042 Card Acceptor Identification C C
DE043 Card Acceptor Name/Location C C
DE048 Additional Data – Private M M
DE049 Transaction Currency Code M M
DE062 Additional Data - C
DE102 From Account M M
DE103 To Account M M
Untuk parameter body metode inquiry, pada nilai parameter MTI harus selalu bernilai “200” yang menandakan bahwa proses yang akan dilaksanakan adalah proses inquiry. Untuk 2 digit processing code bernilai “38” untuk proses bill inquiry atau “37” untuk proses transfer info inquiry, untuk digit ke-3 dan ke-4 bernilai “10” untuk menandakan bahwa akun yang digunakan berasal dari saving account atau “20” untuk menandakan bahwa akun yang digunakan berasal dari checking account, untuk digit ke-5 dan ke-6 selalu bernilai “0”. Berikut adalah contoh parameter untuk mengakses metode inquiry.
Gambar 3.38 Parameter akses inquiry
Apabila transaksi berhasil, maka metode inquiry akan mengembalikan data response dengan tambahan data pada variabel addData untuk menampilkan informasi Cyber Account yang akan melakukan pembayaran. Berikut adalah contoh response dari metode inquiry pada Gambar 3.39.
Gambar 3.39 Response message inquiry
B.2.2 Payment
Proses payment memiliki 2 macam metode akses, yaitu billPaymentAndPurchase dan transferSettle. Kedua metode ini bertujuan untuk melakukan proses pembayaran berdasarkan data dari cyber account pelanggan yang diajukan melalui proses inquiry ke API Maybank untuk melakukan melakukan proses pembayaran ke biller. Berikut adalah contoh ketentuan dari metode billPaymentAndPurchase dan transferSettle yang dijelaskan pada tabel 3.18 dan tabel 3.19.
Tabel 3.18 Detail parameter billPaymentAndPurchase
Field Name & Description Request Response
MTI Message Type Identifier 0200 0210
DE032 Acquiring Institution Identification Code M M
DE037 Retrieval Reference Number M M
DE039 Response Code - M
DE041 Card Acceptor Terminal ID M M
DE042 Card Acceptor Identification C C
DE043 Card Acceptor Name/Location C C
DE048 Additional Data – Private M M
DE049 Transaction Currency Code M M
DE062 Additional Data - C
DE098 Payee M M
DE102 From Account M M
Tabel 3.19 Detail parameter transferSettle
Field Name & Description Request Response
MTI Message Type Identifier 0200 0210
DE032 Acquiring Institution Identification Code M M
DE037 Retrieval Reference Number M M
DE039 Response Code - M
DE041 Card Acceptor Terminal ID M M
DE042 Card Acceptor Identification C C
DE043 Card Acceptor Name/Location C C
DE048 Additional Data – Private M M
DE049 Transaction Currency Code M M
DE062 Additional Data - C
DE102 From Account M M
DE103 To Account M M
Untuk parameter body metode payment, pada nilai parameter MTI harus selalu bernilai “200” yang menandakan bahwa proses yang akan dilaksanakan adalah proses payment. Untuk 2 digit processing code bernilai “17” untuk proses payment/settle atau “47” untuk proses transfer settle, untuk digit ke-3 dan ke-4 bernilai “10” untuk menandakan bahwa akun yang digunakan berasal dari saving account atau “20” untuk menandakan bahwa akun yang digunakan berasal dari checking account, untuk digit ke-5 dan ke-6 selalu bernilai “0”. Berikut adalah contoh parameter untuk mengakses metode payment.
Gambar 3.40 Body message payment
Apabila transaksi berhasil, maka metode payment akan mengembalikan data response untuk menyatakan bahwa pembayaran berhasil dilakukan. Berikut adalah contoh response dari metode payment pada Gambar 3.41.
Gambar 3.41 Response message payment