API reference

Payment status

The payment status lifecycle from CREATED to a final status, and the webhook event for each.

Statuses only move forward: CREATED → PENDING → PAID, FAILED, EXPIRED, or CANCELLED. A PENDING payment that passes expires_at becomes EXPIRED. Final statuses never change again; a refund does not change PAID.

§6 Status pembayaran#

Status	Arti	Final
`CREATED`	tercatat di AKD, belum terkirim ke provider	tidak
`PENDING`	menunggu pembeli membayar	tidak
`PAID`	lunas; webhook `payment.paid`	ya
`FAILED`	gagal di provider; webhook `payment.failed`	ya
`EXPIRED`	lewat `expires_at` tanpa pembayaran; webhook `payment.expired`	ya
`CANCELLED`	dibatalkan di provider; tidak ada webhook, terlihat lewat `GET /v1/payments/{id}`	ya

Status final tidak berubah lagi. Refund (sejak v1.0.3) tidak mengubah status PAID; jumlah yang direfund dikirim lewat event payment.refunded.