Transaksi
IPN
Panduan Instant Payment Notification (Callback) TriPay
IPN (Instant Payment Notification) atau Callback adalah mekanisme notifikasi otomatis yang dikirimkan TriPay ke server Mitra saat status transaksi berubah (terutama saat pembayaran berhasil). Halaman ini menjelaskan cara kerja, konfigurasi, dan penanganan callback.
Pengertian Callback/IPN
Callback adalah HTTP request yang dikirimkan oleh server TriPay ke URL yang ditentukan oleh Mitra untuk memberitahukan perubahan status transaksi secara real-time.
Fungsi Callback
- Memberitahu Mitra bahwa pembayaran telah berhasil (PAID)
- Memungkinkan Mitra untuk update status pesanan secara otomatis
- Mendukung proses bisnis yang real-time dan otomatis
Cara Kerja Callback
1. Pelanggan Melakukan Pembayaran
↓
2. Status Transaksi Berubah ke PAID
↓
3. TriPay Mengirim HTTP POST ke Callback URL
↓
4. Server Mitra Memproses Data
↓
5. Mitra Update Status Pesanan
Konfigurasi Callback URL
Cara Mengatur
- Login ke Dashboard TriPay
- Masuk ke menu Merchant → Opsi → Edit
- Isi field Callback URL
- Simpan perubahan
Persyaratan
| Aspek | Ketentuan |
|---|---|
| Protokol | HTTPS (disarankan) |
| Akses | URL harus dapat diakses publik |
| Response | Harus return JSON |
| Timeout | < 30 detik |
Format Data Callback
Body (JSON)
{
"reference": "T1234567890",
"merchant_ref": "INV-001",
"payment_method": "BRIVA",
"total_amount": 100000,
"fee_merchant": 4250,
"amount_received": 95750,
"status": "PAID",
"paid_at": "2024-01-15 10:30:00"
}
Response yang Diharapkan
Sukses
{
"success": true
}
Pengulangan
Jika callback gagal, TriPay akan retry:
| Percobaan | Interval |
|---|---|
| 1 | Langsung |
| 2 | 2 menit |
| 3 | 4 menit |