Checkout links dan sessions

Ada dua cara menagih pembeli: checkout link (halaman hosted yang dibagikan) dan checkout session (dibuat lewat API).

Checkout link

Checkout link adalah URL tetap untuk satu produk dan satu harga: https://nyaur.id/checkout/<slug>. Cocok untuk README, landing page, atau DM. Link dibuat dan dikelola dari dashboard, Checkout links.

Halaman checkout menampilkan baris PPN dan keterangan bahwa pembayaran diproses oleh PT Joyo Digitama Solusi. Pembeli memilih QRIS atau virtual account (BCA, BNI, BRI).

Checkout session lewat API

POST /v1/checkouts

curl -X POST https://api.nyaur.id/v1/checkouts \
  -H "Authorization: Bearer $NYAUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "productId": "prd_xxx",
    "priceId": "prc_xxx",
    "customerEmail": "pembeli@example.com",
    "customerName": "Dewi",
    "locale": "id",
    "metadata": { "userId": "u_123" }
  }'

Respons 201 memuat id, status, mode, subtotal, ppn, total, dan expiresAt.

• Sesi berlaku 60 menit. Setelah itu GET /v1/checkouts/{id} melaporkan expired.
• status: open, paid, expired, failed, cancelled.
• total = subtotal + PPN. Contoh: subtotal Rp100.000 menjadi total Rp111.000.
• mode mengikuti token. Lihat Sandbox vs live.

Jangan polling status. Dengarkan webhook checkout.paid dan order.paid, lalu ambil order lewat GET /v1/orders/{id}.

Event

Orders dan customers

• GET /v1/orders dan GET /v1/orders/{id}: order sesuai mode token. Field penting: status (pending, paid, refunded, partially_refunded, disputed), subtotal, ppnAmount, total, platformFee, creatorCredit, invoiceNumber, refundedAmount.
• GET /v1/customers, POST /v1/customers, GET /v1/customers/{id}: email wajib, name, externalId, dan metadata opsional.