Yuscom

Pola Respon Prabayar H2H Serpul Vendor Yuscom

Dokumentasi ini menjelaskan pola-pola callback response dari Vendor Yuscom untuk layanan H2H Serpul, khususnya pada transaksi prabayar. Setiap respon memiliki pola RegEx (Regular Expression) yang bisa digunakan untuk parsing data penting seperti SN/Ref, Price, Saldo, dan lainnya.


✅ Status: Sukses

Deskripsi: Callback - Sukses

  • Pattern RegEx:

(?<skip1>.+) SUKSES. SN\/Ref: (?<serial_number>.+).. Saldo (?<skip2>.+)-(?<price>.+)=(?<balance>.+) @
  • Contoh Response:

R#PRAd3e3eff823d7fdf0f T#68877919  UDDND100.082197895900 SUKSES. SN/Ref: ARYX SAPXXXX/100000/Ref:2025060210121481030100166129745458353.. Saldo 108.296-100.055=8.241 @02/06 07.50.58 C#1 KP#UDDND100.

❌ Status: Gagal

Deskripsi: Callback - Gagal saldo kurang

  • Pattern RegEx:

(?<skip1>.+) GAGAL. (?<description>.+). Saldo (?<balance>.+) @(?<skip2>.+)
  • Contoh Response:

R#PRA1f74b4f0b84677378 PLNB20.32106541934 GAGAL. Sisa saldo kamu kurang dari Rp 20.565. Saldo 1.748 @11:35

❌ Status: Gagal

Deskripsi: Callback - Saldo Tidak Cukup

  • Pattern RegEx:

(?<skip1>.+) GAGAL. Saldo tidak cukup. Hrg (?<price>.+), Saldo (?<balance>.+) Limit 0, proses 0.
  • Contoh Response:

0.140501 | R#PRA758e8ba220f1c348c T# SRVP20.082358649644 GAGAL. Saldo tidak cukup. Hrg 19.770, Saldo 2.816 Limit 0, proses 0.

❌ Status: Gagal

Deskripsi: Callback - Nomor tujuan salah

  • Pattern RegEx:

(?<skip1>.+) GAGAL. Nomor tujuan salah. Sal (?<balance>.+) @(?<skip2>.+)
  • Contoh Response:

R#PRA7ca7f1707094429e3 T#68917813 Token Listrik Promo 20.000 PLNP20.14033984844 GAGAL. Nomor tujuan salah. Sal 235.505 @19.54

❌ Status: Gagal

Deskripsi: Callback - Timeout

  • Pattern RegEx:

(?<skip1>.+), status Timeout. SN\/Ref: .(?<serial_number>.+) Trx (?<skip2>.+). Saldo (?<balance>.+)
  • Contoh Response:

SRVP5.085133676614 sdh pernah jam 20.27, status Timeout. SN/Ref: .Timeout Trx ke-2/hr: SRVP5.2.085133676614.pin.. Saldo 837.170

❌ Status: Gagal

Deskripsi: Callback - Gagal

  • Pattern RegEx:

(?<skip1>.+), status Gagal. SN\/Ref: .(?<serial_number>.+) Trx (?<skip2>.+). Saldo (?<balance>.+)
  • Contoh Response:

0.153201 | status=40&message=PLNP20.14300747756 sdh pernah jam 18.49, status Gagal. SN/Ref: .Gagal Trx ke-2/hr: PLNP20.2.14300747756.pin.. Saldo 253.611

📌 Daftar Pola RegEx Umum & Penjelasannya

Pattern

Nama Field

Fungsi / Penjelasan

Status Terkait

Wajib?

(?<skip[i]>.+)

Skip Data

Digunakan untuk melewati bagian data yang tidak dibutuhkan. Misalnya skip1, skip2, dst.

Semua status

(?<serial_number>.+)

Serial Number (SN)

Menangkap kode SN atau referensi transaksi vendor. Biasanya diperlukan untuk validasi.

Berhasil

(?<price>.+)

Harga

Menangkap harga pembelian dari produk atau layanan yang dibeli. Digunakan untuk pencatatan dan laporan.

Berhasil

(?<balance>.+)

Saldo

Menangkap sisa saldo akhir dari akun H2H setelah transaksi dilakukan (sukses/gagal).

Berhasil, Gagal, Pending

(?<description>.+)

Keterangan Gagal

Menangkap pesan error atau alasan kegagalan transaksi, misalnya "Saldo tidak cukup".

Gagal

Tips Penggunaan:

  • Gunakan skip1, skip2, dst. untuk bagian awal respon jika tidak diperlukan.

  • Field dengan ✅ Wajib harus selalu ditangkap jika ada dalam response.

  • Cocokkan pattern dengan struktur kalimat dari response vendor. Kadang formatnya berbeda-beda, jadi perlu diuji coba.

  • Contoh lengkap pola bisa dilihat di bagian atas dokumentasi untuk setiap jenis status (sukses/gagal).


ℹ️ Catatan Penting

Jika menemukan pola respon dari callback yang belum sesuai atau tidak dikenali, silakan gunakan Tool regex Telegram Bot serpul, Caranya kirim pesan ke https://t.me/SERPULCARE kemudian Kirim pesan dengan format: #REGEX diikuti penjelasan dan contoh response.


Last updated