Introduction Last updated: 2023-16-01

Omega Tronik menyediakan jalur koneksi melalui Jabber, API, HTTP GET/POST, JSON untuk memudahkan Anda terkoneksi dengan sistem Omega Tronik.

Untuk para pengembang software, kami menyediakan API (Application Programming Interface) sebagai salah satu pilihan interkoneksi dengan sistem kami. API ini dapat digunakan untuk melakukan cek saldo, pengisian ulang pulsa reguler, paket data, pulsa sms, token PLN, voucher game, PPOB dan semua layanan lainnya yang tersedia di Omega Tronik.

Method yang digunakan untuk request yaitu HTTP GET / HTTP POST dan callback dalam format HTTP GET/JSON.

Syarat & petunjuk penggunaan API/HTTP GET/POST:
  1. Memiliki IP Statis.
  2. Anda hanya bisa melakukan transaksi dari IP yang terdaftar. Setiap ada perubahan IP anda harus menghubungi CS kami agar dapat melanjutkan transaksi kembali.
  3. Menyiapkan URL Callback / Report / Reversal.
  4. Setiap laporan transaksi sukses, gagal, ataupun refund akan kami kirimkan ke URL ini.
  5. PIN.
  6. PIN khusus transaksi API/IP, siapkan PIN transaksi yang rumit dan sulit ditebak.
  7. Password.
  8. Password khusus transaksi API/IP, siapkan password transaksi yang rumit dan sulit ditebak. Boleh mengandung karakter khusus.
  9. Support rumus signature versi kami.
  10. Untuk pengamanan transaksi kami menggunakan parameter signature sehingga setiap transaksi akan menghasilkan signature yang berbeda.
  11. Transaksi Tanpa Signature.
  12. Kami menyediakan pula transaksi tanpa menggunakan signature versi kami, namun PIN serta Password harus dicantumkan dalam setiap request.
  13. Menggunakan refid transaksi.
  14. Refid transaksi adalah id transaksi di server anda. Berfungsi sebagai proteksi transaksi dobel, yaitu mencegah transaksi dengan refid sama terproses dua kali jika dikirimkan ulang. Untuk mengisi dengan produk & No HP sama silakan gunakan refid yang berbeda.
  15. Transaksi PPOB.
  16. Alur transaksi PPOB yaitu anda cek tagihan terlebih dahulu, (setelah reply sukses cek tagihan dari kami keluar sistem anda mengecek apakah saldo reseller anda cukup untuk membayar tagihan ) lalu anda bisa kirim perintah bayar tagihan.

    Tapi apakah bisa langsung bayar tagihan tanpa cek terlebih dahulu? Bisa.. Dan untuk detail tambahan tagihan PPOB akan tercantum dalam variabel keterangan.

Rumus parameter signature

Untuk cek transaksi, cek saldo yang tidak terdapat parameter product, dest ataupun refID, rumus signature tidak berubah hanya saja parameter tersebut dikosongkan.
Contoh template : OtomaX|OT0000||||8715|yunw)uc&@

Koneksi Otomax IP

Untuk bisa terkoneksi dengan Omega Tronik melalui jalur Otomax pastikan Anda telah mengatur koneksi Otomax Anda dengan menghubungi User Agent kami.

Adapun beberapa credential yang anda perlukan:
  • Production IP: Daftar IP yang akan digunakan untuk live transaction.
  • Production Callback: IP tujuan yang akan menerima callback/report dari Omega Tronik.
  • PIN: Siapkan PIN transaksi yang rumit dan sulit ditebak.
  • Password Transaksi: Siapkan password transaksi yang rumit dan sulit ditebak. Boleh mengandung karakter khusus.
  • Setelah menghubungi User Agent kami untuk mendapatkan credential diatas, Anda akan mendapatkan ID Agen, User, Pin, serta production password yang perlu Anda setting di Otomax Anda.

    Protokol :

    Omega Tronik akan menerima request dan mengirim response dengan Protokol HTTP GET.

    IP Omega Tronik

    Silakan whitelist IP 116.193.172.216 di sistem Anda.

    Request

    Seluruh transaksi Otomax kami akan diproses secara sinkron, yang berarti seluruh permintaan request akan langsung mendapatkan respon status sukses/gagal/pending. Respon dengan status pending dapat dicek kembali dengan melakukan topup ulang dengan idtrx yang sama..

    Cek Status :

    Anda dapat melakukan Cek Status dengan melakukan topup ulang dengan idtrx yang sama pada transaksi sebelumnya.

    Mohon Perhatian

    Jangan pernah mencoba untuk melakukan Cek Status terhadap transaksi yang sudah lewat 90 HARI karena hal tersebut akan menyebabkan pembuatan transaksi BARU.

    Endpoint

    Deskripsi Request

    Parameter Deskripsi Wajib
    memberid ID Agen Anda Ya
    password Password Anda Ya
    pin Pin Anda Ya
    kodeproduk Kode produk yang ingin ditransaksikan Ya
    tujuan No tujuan transaksi (Format: counter.tujuan jika lebih dari sekali) Ya
    qty Transaksi Menggunakan Quantity/tanpa Nominal/Nominal Bebas Tidak
    trxid ID transaksi Anda yang unik Ya

    Contoh Request Transaksi Dengan Sign

    http://116.193.172.216:6969/trx?product=HSF10&qty=1&dest=0812345678&refID=123456789&memberID=OX9999&sign=[sign]

    Contoh Request Transaksi Tanpa Sign

    http://116.193.172.216:6969/trx?product=HSF10&qty=1&dest=0812345678&refID=123456789&memberID=OX9999&password=1234&pin=1234

    Response Transaksi Otomax

    Berikut ini format Balasan yang akan Anda terima jika Transaksi SUKSES atau GAGAL diproses oleh sistem:

    Transaksi Sukses

    Format Transaksi Sukses

    Format Transaksi Sukses Pengulangan

    Contoh Format Transaksi Sukses

    Contoh Format Transaksi Sukses Pengulangan


    Transaksi Voucher Sukses

    Format Transaksi Voucher Sukses

    Contoh Format Transaksi Voucher Sukses


    Transaksi Gagal Tujuan Salah

    Format Transaksi Gagal Tujuan Salah

    Format Transaksi Gagal Tujuan Salah Pengulangan

    Contoh Format Transaksi Gagal Tujuan Salah

    Contoh Format Transaksi Gagal Tujuan Salah Pengulangan


    Transaksi Gagal

    Format Transaksi Gagal

    Format Transaksi Gagal Pengulangan

    Contoh Format Transaksi Gagal

    Contoh Format Transaksi Gagal Pengulangan


    Produk Gangguan

    Format Produk Gangguan

    Format Produk Gangguan Pengulangan

    Contoh Format Produk Gangguan

    Contoh Format Produk Gangguan Pengulangan


    Transaksi Stok Kosong

    Format Transaksi Stok Kosong

    Format Transaksi Stok Kosong Pengulangan

    Contoh Format Transaksi Stok Kosong

    Contoh Format Transaksi Stok Kosong Pengulangan

    Otomax Report Transaksi

    Omega Tronik akan mengirimkan balasan SUKSES / GAGAL ke URL Anda dengan format sebagai berikut:

    Protokol

    Omega Tronik akan mengirimkan balasan dengan Protokol HTTP GET


    Deskripsi

    Nama Keterangan
    serverid ID Transaksi / RefF ID Omega Tronik
    clientid ID Transaksi / RefF ID Client
    statuscode Status Transaksi Server 20=Sukses 40=Gagal (Detail Kode Transaksi Silakan Cek Pada Table Dibawah Ini.)

    Status Jawaban Omega Tronik

    Kode Keterangan
    20 Sukses
    52 Tujuan Salah
    40 Gagal
    2 Menunggu Jawaban
    69 CutOff
    50 Dibatalkan
    56 Nomor Blacklist
    47 Produk Gangguan
    45 Stok Kosong
    55 TimeOut
    53 Tujuan Diluar Wilayah

    Koneksi Jabber/XMPP/WhatsApp

    Untuk melakukan transaksi melalui jalur WhatsApp, XMPP/Jabber dan sebagainya dibutuhkan perintah yang sudah kami standarkan demi kenyamanan anda. Setiap mengirim pesan ke center kami anda harus mengikuti format tersebut agar server kami dapat mengenali perintah anda.

    ID Jabber :

    omegatronik@jabb.im
    omegatronik@jabbim.cz
    omegatronik@jabber.cz
    omegatronik@st24.co.id
    omegatronik@jabberix.com

    WhatsApp Center :

    08567870299

    Cek Saldo

    Untuk melakukan cek saldo terkini silakan mengirimkan format pesan SAL, seperti berikut:

    Request

    SAL

    Response

    Yth. [Nama_Toko_Anda] #ID [Member_ID_Anda]. Saldo# [Sisa_Saldo_Anda] #Limit 0 Dlm proses 0 Pakai hari ini 0

    Cek Harga

    Anda sebagai mitra Omega Tronik dapat melakukan cek harga secara realtime..

    Request

    CH.[KODE_PRODUK]

    Contoh

    CH.VSFCEK

    Response

    Harga: VSFCEK = 0 Cek Voucher Smartfren ; * K=kosong, G=Gangguan

    Depsoit

    Anda sebagai Mitra Omega Tronik dapat melakukan permintaan penarikan tiket.

    Request

    TIKET.[NOMINAL].[PIN_ANDA]

    Contoh

    TIKET.1000000.123456

    Di asumsikan PIN Anda yang di daftarkan di Omega Tronik adalah 123456

    Response

    Mhn transfer Rp. 1.000.261 (HARUS SAMA) ke No. Rek BCA | BRI.

    Request

    Untuk melakukan Transaksi Pulsa, Data, Voucher, dll melalui Jabber / XMPP / WhatsApp berikut ini format Request yang valid.

    Silakan chat ke ID Jabber / WhatsApp Omega Tronik yang telah ditambahkan, dengan format berikut:

    Deskripsi Request

    Format Deskripsi Contoh
    KODE_PRODUK Kode Produk Omega Tronik HSF5
    NOMOR_TUJUAN Nomor Tujuan Pengisian 08812345678
    PIN Pin Anda 123456

    Contoh

    HSF5.08812345678.123456

    Di asumsikan PIN Anda yang di daftarkan di Omega Tronik adalah 123456

    Transaksi ke Nomor Tujuan yang Sama

    Jabber/WhatsApp/XMPP hanya akan memproses transaksi 1x ke nomor yang sama dalam hari sama untuk memastikan Transaksi tidak duplikat.
    Untuk bisa melakukan transaksi lebih dari sekali ke nomor yang sama dalam sehari, silahkan gunakan cara berikut:

    Format Deskripsi Contoh
    KODE_PRODUK Kode Produk Omega Tronik HSF5
    COUNTER Counter Transaksi [2..n]
    NOMOR_TUJUAN Nomor Tujuan Pengisian 08812345678
    PIN Pin Anda 123456

    Contoh

    HSF5.2.08812345678.123456

    Di asumsikan PIN Anda yang di daftarkan di Omega Tronik adalah 123456

    Contoh

    HSF5.3.08812345678.123456

    Di asumsikan PIN Anda yang di daftarkan di Omega Tronik adalah 123456

    Format Trxid

    Gunakan format ini jika Anda ingin transaksi menggunakan Trxid tanpa perlu khawatir terjadi double transaksi.
    Trxid berlaku untuk 90 Hari.
    Anda dapat melakukan cek status transaksi dengan mengirim pesan ke jabber center kami dengan Trxid yang sama.
    Anda hanya dapat melakukan cek status transaksi dengan umur di bawah 90 Hari, Jika Anda melakukan cek status untuk transaksi yang sudah melebihi 90 Hari, transaksi baru akan terbuat.

    Format Deskripsi Contoh
    KODE_PRODUK Kode Produk Omega Tronik HSF5
    NOMOR_TUJUAN Nomor Tujuan Pengisian 08812345678
    PIN Pin Anda 123456
    TRXID TRXID Anda 987654321

    Contoh

    HSF5.08812345678.123456 R#987654321

    Di asumsikan PIN Anda yang di daftarkan di Omega Tronik adalah 123456

    Transaksi ke Nomor Tujuan dengan Quantity Bebas Nominal

    Sebagai Mitra Omega Tronik, Anda bisa transaksi dengan nominal bebas, penggunaannya untuk transaksi E-Money dengan Nominal Bebas.

    Format Deskripsi Contoh
    KODE_PRODUK Kode Produk Omega Tronik OVO
    NOMINAL Nominal Pembelian 97851
    NOMOR_TUJUAN Nomor Tujuan Pengisian 08812345678
    PIN Pin Anda 123456

    Contoh

    OVO.97851.08812345678.123456

    Di asumsikan PIN Anda yang di daftarkan di Omega Tronik adalah 123456

    Transaksi Diproses

    Format Transaksi Diproses

    Contoh Format Transaksi Diproses

    Format Transaksi Sedang Dalam Proses

    Contoh Format Transaksi Sedang Dalam Proses


    Transaksi Sukses

    Format Transaksi Sukses

    Contoh Format Transaksi Sukses


    Transaksi Voucher Sukses

    Format Transaksi Voucher Sukses

    Contoh Format Transaksi Voucher Sukses


    Transaksi Gagal Tujuan Salah

    Format Transaksi Gagal Tujuan Salah

    Contoh Format Transaksi Gagal Tujuan Salah


    Transaksi Gagal

    Format Transaksi Gagal

    Contoh Format Transaksi Gagal


    Produk Gangguan

    Format Produk Gangguan

    Contoh Format Produk Gangguan


    Transaksi Stok Kosong

    Format Transaksi Stok Kosong

    Contoh Format Transaksi Stok Kosong

    Koneksi Serpul

    Persiapan

    Untuk bisa terkoneksi dengan Omega Tronik melalui jalur Serpul pastikan Anda telah mengatur koneksi Serpul Anda di Regist Omega Tronik. Adapun beberapa hal yang harus di siapkan:

    1. Production IP
    2. Daftar IP yang akan digunakan untuk live transaction.
    3. Production Callback
    4. IP tujuan yang akan menerima callback/report dari Omega Tronik apabila status transaksi berubah saat live.
    5. PIN.
    6. Siapkan PIN transaksi yang rumit dan sulit ditebak.
    7. Password.
    8. Siapkan password transaksi yang rumit dan sulit ditebak. Boleh mengandung karakter khusus.
    9. Transaksi Tanpa Signature.
    10. Kami menyediakan pula transaksi tanpa menggunakan signature versi kami, namun PIN serta Password harus dicantumkan dalam setiap request.
    11. Menggunakan refid transaksi.
    12. Refid transaksi adalah id transaksi di server anda. Berfungsi sebagai proteksi transaksi dobel, yaitu mencegah transaksi dengan refid sama terproses dua kali jika dikirimkan ulang. Untuk mengisi dengan produk & No HP sama silakan gunakan refid yang berbeda.
    Setelah menyiapkan info di atas, Anda akan mendapatkan ID Member, User, Pin, serta development dan production password yang perlu Anda setting di Serpul Anda.

    Protokol :

    Omega Tronik akan menerima request dan mengirim response dengan Protokol HTTP GET

    IP Omega Tronik :

    116.193.172.216

    Pengaturan Vendor

    Seluruh transaksi Serpul akan diproses secara sinkron, yang berarti seluruh permintaan request akan langsung mendapatkan respon status sukses/gagal/pending. Respon dengan status pending dapat dicek kembali dengan melakukan topup ulang dengan idtrx yang sama.

    Cek Status

    Anda dapat melakukan Cek Status dengan melakukan topup ulang dengan idtrx yang sama pada transaksi sebelumnya.


    Deskripsi Pengaturan Vendor

    Parameter Deskripsi Wajib
    Whitelist IP 116.193.172.216 Ya
    Protocol http:// Ya
    Center IP 116.193.172.216:6969 Ya
    Path Center /trx Ya
    ID Member Kode Agen Omega Tronik Anda Ya
    PIN PIN Transaksi yang Sudah Anda Daftarkan Ya
    Password Password Transaksi yang Sudah Anda Daftarkan Ya

    Pola Respons

    Berikut ini format Response dan Pola/Regex yang akan Anda terima jika Transaksi SUKSES diproses oleh sistem:

    Respons Pending.

    Regex

    R#(?<ref_id>[^.]+) (?<skip1>.+) akan diproses (?<skip2>.+). Saldo (?<skip3>.+) - (?<price>.+) = (?<balance>.+)

    Respons Sukses.

    Regex

    R#(?<ref_id>[\d\.,]+) \D+(?<skip1>\d+).(?<skip2>\d+) SUKSES. SN[\/]Ref: (?<serial_number>.+). Saldo (?<skip3>.+)-(?<price>.+)=(?<balance>.+) @

    Respons Gagal.

    Regex

    \D+(?<skip1>\d+).(?<skip2>\d+) GAGAL. . Saldo (?<balance>.+) @

    Respons Tujuan Salah.

    Regex

    R#(?<ref_id>[\d\.,]+) (?<skip1>.+) (?<skip2>.+).(?<skip3>.+) GAGAL. Nomor tujuan salah. Sal (?<balance>.+) @