URL

URL untuk transaksi diberikan oleh pihak server. Formatnya sebagai berikut:

http://host:port/path

Contoh:

http://server.siipul.org:9999/topup

URL Reversal

URL untuk pesan reversal didaftarkan oleh pihak client kepada pihak server. Formatnya sebagai berikut:

http://host:port/path

Contoh

http://client.siipul.org:80/reverse

Methods

Daftar method dan parameter untuk transaksi remote. Pihak client mengirim 'trans.Topup' dan server memberikan respon berisi status code 1xx. Selain itu, transaksi ditolak. Setelah transaksi diterima, server memproses transaksi. Jika terjadi kegagalan, server mengirim method 'trans.Reverse' ke pihak client. Pihak client harus memproses pesan tersebut.

trans.Topup

Deskripsi

Mengirim transaksi topup ke server Si-iPul.

.

Format

(struct)response trans.Topup( (struct) parameter)

Parameter

Parameter bertipe 'struct' dengan member sebagai berikut:

Catatan:

• Tanda '+' pada signature berarti 'disambung'

Response

Response bertipe struct dengan member sebagai berikut:

] trans.Reverse

Server mengirim 'trans.Reverse' ke pihak client jika terjadi kegagalan dalam proses topup.

Format

(boolean)response trans.Reverse( (struct) parameter)

Parameter

Parameter bertipe 'struct' dengan member sebagai berikut:

Response

Response bertipe boolean. Set nilai TRUE atau FALSE.

Server hanya mengirim pesan reversal melalui 'trans.Reverse' hanya satu kali.

Contoh

trans.Topup

Berikut contoh XML untuk 'trans.Topup'

MethodCall

<?xml version="1.0" ?>
<methodCall>
  <methodName>trans.Topup</methodName>
  <params>
    <param>
      <value>
        <struct>
          <member>
            <name>user</name>
            <value><string>10001</string></value>
          </member>
          <member>
            <name>idProduk</name>
            <value><string>S20</string></value>
          </member>
          <member>
            <name>msisdn</name>
            <value><string>081112</string></value>
          </member>
          <member>
            <name>ref</name>
            <value><string>12345678</string></value>
          </member>
          <member>
            <name>signature</name>
            <value><string>38c531c12dd33d0ddc54bfcf9cefe347</string></value>
          </member>
        </struct>
      </value>
    </param>
  </params>
</methodCall>

Contoh XML untuk fault code

<?xml version="1.0"?>
<methodResponse>
 <fault>
   <value>
     <struct>
       <member>
         <name>faultCode</name>
         <value><int>204</int></value>
       </member>
       <member>
         <name>faultString</name>
         <value><string>Invalid signature</string></value>
       </member>
     </struct>
   </value>
 </fault>
 </methodResponse>

Status Code

Daftar status code dari server Si-iPul.

Normal

1xx, Normal. Transaksi berhasil diterima. Menunggu diproses.

• 100, Transaksi menunggu diproses.
• 101, Transaksi sedang diproses.
• 102, Transaksi sudah diproses.

Normal Error

2xx, Normal error. Transaksi ditolak.

• 200, Parameter tidak ditemukan
• 201, Parameter tidak valid
• 202, Parameter tidak lengkap
• 203, Account tidak valid
• 204, Signature tidak valid
• 205, IP Address tidak valid atau diblokir
• 206, Account tidak aktif atau diblokir
• 207, Produk tidak terdaftar
• 208, Produk sedang kosong atau tidak tersedia
• 209, Saldo tidak cukup untuk melakukan transaksi
• 210, Transaksi yang sama belum bisa dilakukan
• 211, MSISDN xxxx tidak dapat ditopup dengan produk XYY
• 212, Timeout.
• 213, MSISDN tidak valid atau expired.
• 299, Error belum diketahui.

System Error

3xx, System error. Transaksi/perintah ditolak. Terjadi kesalahan di server.

• 300, Unknown internal error
• 301, General error
• 303, System out of order

Link

Link >> XML-RPC Specification