Dokumentasi API Toko Voucher

Transaksi - Metode POST

Transaksi - Metode POST

API ini digunakan untuk melakukan pembelian produk (pulsa, game, dll) menggunakan metode POST.

Endpoint

POST
https://api.tokovoucher.net/v1/transaksi

Parameter

ParameterDeskripsiTipe DataWajib
ref_idID referensi unik dari Anda (untuk tracking transaksi)StringYa
produkKode produk di Toko Voucher (contoh: FF5, ML86)StringYa
tujuanNomor tujuan (Player ID, User ID, atau Nomor HP)StringYa
server_idServer ID game (kosongkan "" jika tidak diperlukan)StringTidak
member_codeKode member AndaStringYa
signatureSignature dengan formula md5(MEMBER_CODE:SECRET:REF_ID)StringYa

Tips: Parameter tujuan bisa digabung dengan server_id (contoh: "12345678|2001") atau dipisah menggunakan parameter server_id terpisah.

Contoh Request

{
"ref_id": "tx334234",
"produk": "FF5",
"tujuan": "034344234",
"server_id": "exr33f",
"member_code": "MEM3532234432X34",
"signature": "f109a98c4f298ade23fb6c1f067dce53"
}

Response

Pending (Sedang Diproses)

{
"status": "pending",
"message": "TRXID:T220907UYXI026607. REFID:5467110. PENDING. HRG:1600. SALDO:17322134. KP:S1.085211223344 TGL:2022-09-07 22:46:36",
"sn": "",
"ref_id": "5467110",
"trx_id": "T220907UYXI026607",
"produk": "s1",
"sisa_saldo": 17322134,
"price": 1600
}

Sukses

{
"status": "sukses",
"message": "TRXID:T220907HTRK027479. REFID:6915241. SUKSES, SN: DLINR-_-. RefId : 11183039941543874221. HRG:789. SALDO:17317805. KP:FF5.50714103 TGL:2022-09-07 22:59:47",
"sn": "DLINR-_-. RefId : 11183039941543874221",
"ref_id": "6915241",
"trx_id": "T220907HTRK027479",
"produk": "ff5",
"sisa_saldo": 17317805,
"price": 789
}

Gagal

{
"status": "gagal",
"message": "TRXID:T220907JKYI026608. REFID:5467112. GAGAL, Nomor Tujuan Salah. HRG:1600. SALDO:172200. KP:S1.085222334455 TGL:2022-09-07 22:46:36",
"sn": "Nomor Tujuan Salah",
"ref_id": "5467112",
"trx_id": "T220907JKYI026608",
"produk": "S1",
"sisa_saldo": 172200,
"price": 1600
}

Response Error

IP Tidak Diizinkan

{
"status": 0,
"error_msg": "Ip Not Allow"
}

Pastikan IP server Anda sudah ditambahkan di whitelist pada Member Area.

Signature Tidak Valid

{
"status": 0,
"error_msg": "Signature Invalid"
}

Pastikan formula signature sudah benar: md5(MEMBER_CODE:SECRET:REF_ID)


Catatan Penting

Setiap ada perubahan status transaksi (dari pending ke sukses/gagal), kami akan mengirimkan notifikasi ke webhook Anda.

Lihat Dokumentasi Webhook