Pembayaran (Payments)

Dokumentasi API untuk integrasi gateway pembayaran (Xendit, Doku, DANA) guna memproses transaksi secara aman.

Endpoint Overview

Method	Endpoint	Deskripsi
POST	`/payments/method`	Ambil daftar metode pembayaran berdasarkan nominal.
POST	`/payments/method/:bank_code`	Ambil instruksi pembayaran spesifik (VA/Bank).
POST	`/payments/create`	Membuat instruksi pembayaran (Xendit/DANA/dll).
POST	`/payments/status`	Mengecek status pembayaran terbaru dari gateway.

1. List Payment Methods

Mendapatkan metode pembayaran yang tersedia berdasarkan total nominal transaksi.

URL: /payments/method
Method: POST
Body:

{ "total": 150000.0 }

Response (200 OK): Mengembalikan grup pembayaran (VIRTUAL_ACCOUNT, EWALLET, QRIS) lengkap dengan biaya layanan (fee).

2. Create Payment Invoice

Membuat tautan atau kode bayar untuk pesanan tertentu menggunakan provider yang dipilih.

URL: /payments/create
Method: POST
Body (JSON):

{
  "gateway": "xendit",
  "payment_type": "va",
  "bank_code": "BCA",
  "amount": 150000.0,
  "external_id": "INV-001",
  "customer_name": "John Doe",
  "customer_email": "john@example.com"
}

Response (200 OK):

{
  "gateway_reference": "va_1234567890",
  "status": "pending",
  "va_data": {
    "va_number": "1234567890123456",
    "bank_name": "BCA"
  }
}

3. Check Payment Status

Sinkronisasi status pembayaran antara platform Atourin dan gateway pembayaran.

URL: /payments/status
Method: POST
Body:

{
  "invoice": "INV-001",
  "gateway": "xendit",
  "payment_type": "va"
}

Response Status: active (Pending), settled (Berhasil), expired.

🔥 Uji Coba API (Simulator)

Gunakan simulator di bawah ini untuk mencoba seluruh endpoint di atas secara langsung. Anda dapat mengubah URL, Method, Headers, dan Body sesuai kebutuhan.