Pengantar API Mitra

R1 Server menyediakan API transaksi agar Mitra dapat menghubungkan sistemnya sendiri (aplikasi/web/bot) langsung ke R1 untuk cek harga, transaksi prabayar & pascabayar, cek status, saldo, dan mutasi.

Alamat dasar (base URL)

Seluruh endpoint memakai alamat dasar server R1 Anda, ditulis {base_url} pada dokumen ini — misalnya https://server-anda.com. Contoh: {base_url}/V1/api/price.

Kredensial Mitra

Nilai berikut diberikan oleh admin R1 saat akun Mitra dibuat:

Nilai	Keterangan
mmid	ID Mitra (member id) Anda.
api_key	Kunci API rahasia. Pada mode HTTP-GET dikirim sebagai password.
pin	PIN transaksi (dipakai pada tanda tangan/sign dan HTTP-GET).

Dua cara autentikasi

Tergantung pengaturan akun Mitra, pilih salah satu:

1. rqid — kirim api_key pada header rqid.
2. sign (tanda tangan) — kirim tanda tangan pada header sign. Lebih aman karena api_key tidak dikirim langsung.

Cara membuat tanda tangan (sign)

Gabungkan nilai berikut dengan pemisah |:

R-ONE|mmid|product_code|customer_id|ref_1|pin|api_key

Lalu hitung SHA1 dari teks tersebut, ubah ke base64 URL-safe (ganti / menjadi _, + menjadi -, hapus = di akhir), dan kirim hasilnya pada header sign. Untuk field yang tidak dipakai (mis. customer_id pada produk prabayar), gunakan string kosong.

tip

Menu Supplier → Regex Tester di aplikasi memiliki tab Sign Tester untuk mencoba pembuatan tanda tangan.

Bentuk respons

Sebagian besar endpoint JSON membalas amplop berikut:

{ "status": "success", "code": 200, "message": "success", "rc": "00", "data": {} }

• status — success atau error.
• rc — kode respons; lihat halaman Kode respons (RC). 00 = berhasil.
• data — isi jawaban (harga, produk, transaksi, dll.).

Endpoint daftar (/products, /history, /product-categories, /balance, /mutations) memakai amplop tanpa rc.

Referensi penting

• ref_1 — nomor referensi transaksi dari sisi Anda; harus unik per transaksi. Untuk pascabayar, pakai ref_1 yang sama saat inquiry dan payment.
• Untuk cek status, kirim ulang endpoint Status dengan ref_1 yang sama sampai transaksi success atau failed.

Pilih kelompok endpoint pada menu di samping untuk detail tiap permintaan.