Winpay — E-Wallet

Pembayaran E-Wallet pada Winpay menggunakan mekanisme Redirect (Web) atau Deep Link (Mobile App). Pelanggan Anda akan diarahkan ke aplikasi dompet digital atau halaman login e-wallet untuk menyelesaikan pembayaran.

E-Wallet yang Didukung

• DANA
• OVO
• SHOPEEPAY
• ASTRAPAY
• SPEEDCASH

Cara Pembuatan (Create)

Set method_type menjadi e_wallet dan berikan method_detail dengan field wallet_type.

POST /v1/payments/create

{
  "amount": 2500000, 
  "currency": "IDR",
  "method_type": "e_wallet",
  "method_detail": {
    "type": "e_wallet",
    "wallet_type": "DANA"
  },
  "customer_name": "Budi Santoso",
  "customer_phone": "081234567890"
}

Catatan Penting Request

• Nomor HP (customer_phone): Sebagian besar e-wallet (seperti OVO) sangat mewajibkan input nomor handphone. Pastikan field customer_phone selalu terisi dengan nomor handphone pelanggan yang valid (contoh format: 081... atau 6281...).
• Expiry Fixed 15 Menit: Khusus untuk transaksi E-Wallet via Winpay, batas waktu (expiry) di-hardcode menjadi 15 menit dari sisi sistem Winpay. Nilai expiry_minutes yang Anda kirimkan pada request akan diabaikan.

Response

Jika berhasil, Anda akan menerima response yang berisi URL redirect untuk mengarahkan pengguna ke halaman pembayaran.

{
  "success": true,
  "data": {
    "id": "...",
    "status": "pending",
    "method_data": {
      "type": "e_wallet",
      "wallet_type": "DANA",
      "redirect_url": "https://m.dana.id/i/biller-app/payment?id=...",
      "deeplink": "dana://biller-app/payment?id=..."
    }
  }
}

URL Pengalihan (Redirect)

• redirect_url: Gunakan ini jika pelanggan membuka website Anda melalui Desktop/Browser PC. Tautan ini akan membuka halaman web dari e-wallet (misal: halaman login web DANA).
• deeplink: Gunakan ini jika pelanggan menggunakan Mobile App (iOS/Android). Tautan ini akan langsung membuka aplikasi e-wallet terkait (misal aplikasi DANA) di HP pelanggan. (Catatan: Tidak semua e-wallet mendukung deeplink terpisah. Jika deeplink null, gunakan redirect_url sebagai fallback di semua platform).

---

Alur Pembayaran End-to-End

1. Aplikasi Klien: Mengirim POST /v1/payments/create ke Gerbang Pay.
2. Gerbang Pay: Mengembalikan URL checkout (redirect_url & deeplink).
3. Aplikasi Klien: Mengalihkan pelanggan (via tombol "Bayar Sekarang" atau redirect otomatis) menggunakan URL yang didapat.
4. Pelanggan: Menyelesaikan proses pembayaran di aplikasi E-Wallet (memasukkan PIN, dll).
5. Winpay: Mendeteksi dana masuk dan mengirim callback.
6. Gerbang Pay: Mengirimkan webhook payment.paid ke server Anda.