Developer

Membership lewat API: daftarkan member dari aplikasi Anda, buka akses otomatis

8 November 2026

Halaman pendaftaran membership Poketo (pay.poketo.id/m/…) sudah cukup untuk kebanyakan kelas dan komunitas. Tetapi bila member mendaftar di aplikasi, website, atau bot Anda sendiri, Anda butuh dua hal: membuat tagihan atas nama pengguna yang sudah login, dan tahu kapan aksesnya harus dibuka atau ditutup. API Membership Poketo mengurus keduanya.

Kapan perlu API

  • Cukup halaman pendaftaran bila member bisa mendaftar sendiri dan Anda mengelola akses secara manual, misalnya mengundang ke grup setelah melihat daftar member di dashboard.
  • Pakai API bila akses diberikan oleh sistem: LMS atau platform kelas, area member di website, bot Discord atau Telegram yang memberi role, atau aplikasi yang sudah punya akun pengguna.

1. Hubungkan membership ke proyek API

Buat merchant di dashboard → Merchant (tab Pengaturan API) untuk mendapat key sk_test_… (uji coba) dan sk_live_… (sungguhan). Lalu buka membership Anda: di panel Pakai lewat API, pilih merchant tersebut. Panel itu juga menampilkan ID membership, ID tiap paket, dan contoh kodenya. Membership juga bisa dibuat langsung lewat POST /v1/memberships.

2. Daftarkan member dan dapatkan link bayar

Saat pengguna memilih paket di aplikasi Anda, kirim nama dan emailnya ke endpoint checkout. Satu panggilan ini mendaftarkan member dan membuat tagihannya sekaligus:

curl
curl -X POST https://poketo.id/api/v1/memberships/mbp_…/checkout \
  -H "Authorization: Bearer $POKETO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: join-user-42" \
  -d '{
    "tierId": "mbt_…",
    "customer": { "name": "Budi", "email": "budi@example.com" },
    "metadata": { "userId": "42" },
    "redirectUrl": "https://kelasanda.com/selamat-datang"
  }'

Respons berisi member (simpan member.id di data pengguna Anda) dan invoice.paymentUrl. Arahkan pengguna ke paymentUrl: halaman bayarnya sudah atas nama member, jadi mereka tidak perlu mengisi nama atau email lagi, tinggal memilih QRIS, Virtual Account, PayLater, atau kartu debit. Bila email itu sudah menjadi member, panggilan yang sama menghasilkan tagihan perpanjangan.

3. Buka dan tutup akses dari webhook

Setelah dibayar, Poketo mengirim membership.activated ke webhook proyek, lengkap dengan expiresAt. Perpanjangan mengirim membership.renewed, dan bila masa aktif habis tanpa perpanjangan Anda menerima membership.expired:

Node.js (Express)
app.post('/webhooks/poketo', express.raw({ type: 'application/json' }), async (req, res) => {
  if (!validSignature(req)) return res.status(400).send('invalid signature'); // lihat dokumentasi webhook
  const event = JSON.parse(req.body);
  const member = event.data;

  if (event.type === 'membership.activated' || event.type === 'membership.renewed') {
    await db.users.update({ poketoMemberId: member.id }, { access: true, accessUntil: member.expiresAt });
  }
  if (event.type === 'membership.expired' || event.type === 'membership.cancelled') {
    await db.users.update({ poketoMemberId: member.id }, { access: false });
  }
  res.sendStatus(200);
});

Selalu periksa tanda tangan Poketo-Signature dan abaikan event yang id-nya sudah pernah diproses, karena webhook bisa dikirim ulang. Contoh verifikasi lengkap ada di dokumentasi webhook. Untuk mengecek status member kapan saja, panggil GET /v1/members/:id.

4. Perpanjangan tanpa kode tambahan

  • Poketo mengirim email pengingat 7, 3, dan 1 hari sebelum berakhir, pada hari berakhir, dan 3 hari setelahnya, masing-masing dengan tagihan perpanjangan.
  • Bayar lebih awal tidak menghilangkan hari: masa aktif diperpanjang dari tanggal berakhir.
  • Ingin menagih dari aplikasi sendiri? POST /v1/members/:id/renewal membuat tagihan perpanjangan, atau pakai tierId lain untuk pindah paket.
  • Hentikan member dengan PATCH /v1/members/:id { "status": "cancelled" }; tagihan terbukanya ikut dibatalkan.

Uji dulu di sandbox

Dengan key sk_test_, member dan tagihannya terpisah dari yang sungguhan: tidak ada uang yang berpindah, tidak ada email ke member, dan tidak muncul di daftar member dashboard. Email yang sama boleh dipakai di sandbox dan live. Bayar tagihan uji dengan simulasi, dan webhook tetap terkirim:

curl
curl -X POST https://poketo.id/api/v1/invoices/INV-PKT-…/simulate \
  -H "Authorization: Bearer $POKETO_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "result": "paid" }'

Mulai

Semua endpoint, kode error, dan contoh respons ada di dokumentasi Membership. Bila memakai AI agent, arahkan ke llms.txt; server MCP Poketo juga punya alat untuk membuat membership dan mendaftarkan member.

Buat membership
Ada pertanyaan? Hubungi kami di contact@dahono.com.