Pembayaran Sekali

  • Dipublikasikan pada Oct 17, 2025
Prev Next

Payment Sessions memungkinkan Anda untuk menagih pembayaran dari pelanggan Anda secara aman selama proses checkout. Fitur ini memastikan kepatuhan terhadap peraturan dan menyediakan pengalaman pembayaran yang lancar dan di-host melalui halaman checkout Xendit. Ini adalah alur umum untuk menerima pembayaran sekali jalan dengan integrasi yang sederhana.

Contoh penggunaan:

  • Checkout eCommerce: Tagih pembayaran langsung dari pelanggan saat melakukan pemesanan.

  • Pemesanan layanan: Konfirmasi reservasi hanya setelah pembayaran berhasil.

Cara berintegrasi

  1. Selama checkout atau kapan pun pelanggan Anda siap melakukan pembelian sekali jalan, sistem Anda harus Membuat Payment Session dengan Xendit menggunakan contoh payload yang disediakan di bawah ini.

Request - POST /sessions

{
    "reference_id": "{{$YOUR_REFERENCE_ID}}",
    "session_type": "PAY",
    "mode": "PAYMENT_LINK",
    "amount": 150000,
    "currency": "IDR",
    "country": "ID",
    "customer": {
        "reference_id": "{{$randomUUID}}",
        "type": "INDIVIDUAL",
        "email": "customer@yourdomain.com",
        "mobile_number": "+628123456789",
        "individual_detail": {
            "given_names": "John",
            "surname": "Doe"
        }
    },
    "success_return_url": "https://yourcompany.com/order/complete",
    "cancel_return_url": "https://yourcompany.com/order/cancel"
}

Response - POST /sessions

{
    "payment_session_id": "ps-67527107dda8b2513acdaef0",
    "created": "2024-12-06T03:35:36.032Z",
    "updated": "2024-12-06T03:35:36.032Z",
    "status": "ACTIVE",
    "reference_id": "b767f88f-b5bc-4836-9c47-c14261909dec",
    "currency": "IDR",
    "amount": 150000,
    "country": "ID",
    "customer_id": "cust-fe8743c3-f554-4d25-a0e9-9980226c4b1b",
    "expires_at": "2024-12-06T04:05:35.049Z",
    "session_type": "PAY",
    "mode": "PAYMENT_LINK",
    "locale": "en",
    "business_id": "62440e322008e87fb29c1fd0",
    "success_return_url": "https://yourcompany.com/order/complete",
    "cancel_return_url": "https://yourcompany.com/order/cancel",
    "payment_link_url": "https://dev.xen.to/qZx5RD_7"
}

  1. Setelah Payment Session dibuat, arahkan pengguna akhir Anda ke halaman checkout yang di-host oleh Xendit menggunakan payment_link_url dari respons.

  2. Pelanggan Anda akan menyelesaikan pembayaran di halaman yang di-host oleh Xendit menggunakan saluran pembayaran pilihan mereka (misalnya, kartu, eWallet, transfer bank, QR, dll.).

  3. Setelah pembayaran berhasil, Xendit akan mengirimkan webhook payment.capture atau payment.failed ke sistem Anda. Anda harus menggunakan webhook ini untuk memperbarui status pesanan di sistem Anda.