Langganan berulang & penagihan otomatis

Perpanjangan otomatis adalah bedanya antara portal dengan pendapatan berulang dan portal yang harus menjual ulang tiap bulan. Bagian tersulitnya bukan menagih — tapi menangani penagihan yang gagal.

Dua jalur

Untuk portal berita dengan beberapa paket dan kemungkinan promo, jalur kedua biasanya lebih tepat: kamu sudah punya penyapu berkala dan jurnal notifikasi dari materi sebelumnya, dan menjadwalkan sendiri berarti logika bisnis penagihanmu ada di satu tempat yang bisa kamu uji.

Menyimpan token, bukan kartu

// Saat pembayaran pertama dengan kartu, minta tokennya disimpan.
// Nomor kartu TIDAK PERNAH menyentuh servermu.
{
  transaction_details: { order_id, gross_amount },
  credit_card: {
    secure: true,        // 3D Secure
    save_card: true,     // minta token untuk penagihan berikutnya
  },
}

CREATE TABLE metode_bayar (
  id            INT AUTO_INCREMENT PRIMARY KEY,
  member_id     INT          NOT NULL,
  saved_token   VARCHAR(255) NOT NULL,
  masked_card   VARCHAR(32)  NULL,      -- "48111111-1114"
  jenis         VARCHAR(16)  NOT NULL,  -- "credit_card" | "gopay"
  kedaluwarsa   DATE         NULL,
  utama         TINYINT(1)   NOT NULL DEFAULT 0,
  dibuat_pada   DATETIME     NOT NULL,
  UNIQUE KEY uq_token (saved_token),
  INDEX idx_member (member_id)
) ENGINE=InnoDB;

Menagih dengan token

export async function tagihUlang(m: MetodeBayar, jumlah: number, orderId: string) {
  const basis = env.MIDTRANS_PRODUKSI
    ? "https://api.midtrans.com/v2"
    : "https://api.sandbox.midtrans.com/v2";

  const res = await fetch(`${basis}/charge`, {
    method: "POST",
    signal: AbortSignal.timeout(15_000),
    headers: {
      "Content-Type": "application/json",
      Accept: "application/json",
      Authorization: otorisasi(),
    },
    body: JSON.stringify({
      payment_type: "credit_card",
      transaction_details: { order_id: orderId, gross_amount: jumlah },
      credit_card: { token_id: m.saved_token },
    }),
  });

  return res.json();
}

Penjadwal penagihan

// Tugas terjadwal harian
export async function tagihYangJatuhTempo() {
  const jatuhTempo = await dbBaca
    .selectFrom("member as m")
    .innerJoin("metode_bayar as b", (j) =>
      j.onRef("b.member_id", "=", "m.id").on("b.utama", "=", 1),
    )
    .select(["m.id", "m.tier", "m.langganan_sampai", "b.saved_token", "b.id as metodeId"])
    .where("m.perpanjang_otomatis", "=", 1)
    .where("m.langganan_sampai", "<=", besok())
    .where("m.langganan_sampai", ">", sepuluhHariLalu())   // jangan kejar yang sudah lama mati
    .limit(500)
    .execute();

  for (const m of jatuhTempo) {
    const orderId = `RNW-${m.id}-${hariIniISO()}`;    // deterministik = idempoten

    try {
      const hasil = await tagihUlang(m, hargaPaket(m.tier), orderId);
      await prosesNotifikasi(hasil);                   // jalur yang sama dengan webhook
    } catch (e) {
      await catatKegagalanTagih(m.id, String(e));
    }
  }
}

Dunning: menangani penagihan yang gagal

Kartu yang akan kedaluwarsa

-- Kirim pengingat 30 hari sebelumnya
SELECT m.id, m.email, b.masked_card, b.kedaluwarsa
FROM member m
JOIN metode_bayar b ON b.member_id = m.id AND b.utama = 1
WHERE m.perpanjang_otomatis = 1
  AND b.kedaluwarsa BETWEEN CURDATE() AND DATE_ADD(CURDATE(), INTERVAL 30 DAY);

Ini pencegahan yang paling murah dari seluruh materi ini. Satu email sebulan sebelumnya menghindarkan seluruh rangkaian dunning, dan pelanggan tidak pernah mengalami gangguan akses sama sekali.

Pembatalan

export const batalkanPerpanjangan = defineAction({
  handler: async (_i, ctx) => {
    const m = ctx.locals.member;
    if (!m) throw new ActionError({ code: "UNAUTHORIZED" });

    await dbTulis.updateTable("member")
      .set({ perpanjang_otomatis: 0, dibatalkan_pada: new Date() })
      .where("id", "=", m.id)
      .execute();

    // Akses tetap sampai periode yang sudah dibayar berakhir.
    return { berlakuSampai: m.langgananSampai };
  },
});