Messaging Format

Format pesan yang dibahas pada bagian ini adalah format pesan request dan response yang terjadi antara Server Mitra dengan Plus. Dengan ketentuan sebagai berikut :

  1. Message dikirimkan melalui Webservice
  2. Protokol komunikasi yang digunakan HTTP/HTTPS
  3. Format messaging yang digunakan adalah REST-JSON. Nilai field/variable pada request dikirimkan lewat protocol HTTP dengan method POST, dan response yang diberikan adalah dalam format JSON.
  4. Enkripsi dilakukan pada field-field tertentu pada message request dan message response. Algoritma enkripsi yang digunakan adalah AES-128 dengan ketentuan :
    • Panjang Key 128 bit
    • Cipher mode CBC
    • Panjang IV 128 bit
    • Karakter padding null byte

Setiap parameter mempunyai atribut / tipe data dengan ketentuan yang bisa berbeda. Penulisan atribut / tipe data pada dokumen ini dituliskan dengan contoh ANS 100, yang artinya parameter tersebut dapat berupa alphanumeric dan special character dengan panjang maksimal 100 karakter.

Adapun ketentuan lengkapnya adalah sebagai berikut :

Attribute Keterangan
A Alpha character
N Numeric character
S Special character
AN Alphanumeric character
AS Alpha dan special character
NS Numeric dan special character
ANS Alphanumeric dan special character