Skip to content

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.

http
POST /v1/payments/create
json
{
  "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.

json
{
  "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.

Gerbang Pay API Documentation