Winpay — Over The Counter (Gerai Ritel)

Metode Over The Counter (OTC) memungkinkan pelanggan yang tidak memiliki rekening bank untuk membayar pesanan dengan uang tunai melalui kasir gerai minimarket atau agen pembayaran.

Gerai yang Didukung

• ALFAMART (Juga berlaku untuk Alfamidi & Dan+Dan)
• INDOMARET
• FASTPAY

Cara Pembuatan (Create)

Set method_type menjadi over_the_counter dan berikan method_detail dengan field store.

POST /v1/payments/create

{
  "amount": 10000000, 
  "currency": "IDR",
  "method_type": "over_the_counter",
  "method_detail": {
    "type": "over_the_counter",
    "store": "ALFAMART"
  },
  "customer_name": "Budi Santoso",
  "expiry_minutes": 1440
}

Catatan Penting Request

• Waktu Kadaluarsa (expiry_minutes): Pembayaran OTC membutuhkan waktu fisik bagi pelanggan untuk berjalan ke gerai. Sangat disarankan untuk mengatur batas waktu minimal 1 hari (1440 menit).

Response

Jika berhasil, sistem akan mengembalikan kode pembayaran (payment_code) yang harus ditunjukkan oleh pelanggan kepada kasir.

{
  "success": true,
  "data": {
    "id": "...",
    "status": "pending",
    "method_data": {
      "type": "over_the_counter",
      "store_name": "ALFAMART",
      "payment_code": "88880123456"
    }
  }
}

Informasi untuk Ditampilkan ke Pelanggan

• method_data.payment_code: Kode unik yang diinput oleh kasir.
• method_data.store_name: Tampilkan nama gerai.
• Berikan instruksi kepada pelanggan:
  1. Datang ke gerai terdekat (Alfamart/Indomaret).
  2. Sampaikan ke kasir ingin membayar tagihan Winpay (atau merchant name yang sudah didaftarkan, misal: Koperasi XYZ).
  3. Berikan kode pembayaran (payment_code).
  4. Kasir akan menyebutkan nama dan nominal tagihan.
  5. Bayar sesuai nominal (kasir mungkin akan mengenakan biaya admin tambahan tergantung kebijakan gerai).
  6. Simpan struk sebagai bukti.

---

Alur Pembayaran End-to-End

1. Aplikasi Klien: Mengirim POST /v1/payments/create ke Gerbang Pay.
2. Gerbang Pay: Mengembalikan kode pembayaran.
3. Aplikasi Klien: Menampilkan kode pembayaran di HP pelanggan beserta panduan cara bayar di kasir.
4. Pelanggan: Menuju kasir gerai fisik dan membayar tunai.
5. Winpay: Mendeteksi dana masuk dari pihak ritel dan mengirim callback.
6. Gerbang Pay: Mengirimkan webhook payment.paid ke server Anda.