Payment Detail

Mengambil detail spesifik dari sebuah invoice berdasarkan payment_code yang terdaftar di sistem Anda.

Untuk melihat daftar keseluruhan invoice, silakan merujuk pada halaman Payment List.

Gunakan endpoint ini untuk memeriksa status invoice kapan saja. Untuk mendapatkan pembaruan status secara real-time, kami sangat menyarankan Anda untuk mengatur Webhook.

Silakan lihat halaman Status & Error Code untuk melihat daftar lengkap status pembayaran.

Request

Endpoint

Method	URL
GET	https://api.bayar.digital/gateway/payments/{payment_code}

Parameter

Parameter	Tipe	Wajib	Deskripsi
payment_code	string	Ya	Kode invoice dari sistem Anda

Header

Header	Wajib	Deskripsi
X-Api-Key	Ya	API Key merchant Anda

Body

Field	Tipe	Wajib	Deskripsi
Tidak ada body pada request ini.

Contoh

    curl https://api.bayar.digital/gateway/payments/INV-2026-0001 \
      -H "X-Api-Key: pk_..."

Response

Sukses

Field	Tipe	Deskripsi
payment_id	uuid	ID unik invoice
payment_code	string	Kode invoice dari sistem Anda
payment_amount	int64	Nominal asli (tanpa kode unik)
payment_unique	int64	Kode unik pembayaran (1-999)
payment_total	int64	Total yang harus dibayar = amount + unique
payment_status	string	PENDING / PAID / EXPIRED / CANCELLED
payment_expired_at	datetime	Batas waktu pembayaran
payment_updated_at	datetime	Waktu pembaruan terakhir
payment_webhook_url	string/null	URL Webhook khusus untuk invoice ini
payment_checkout_url	string	URL halaman checkout publik
payment_return_url	string/null	URL untuk redirect pelanggan
customer_name	string/null	Nama pelanggan
customer_email	string/null	Email pelanggan
customer_phone	string/null	Nomor telepon pelanggan
customer_orders	array/null	Daftar item pesanan pelanggan
account_id	uuid	ID akun tujuan penerima dana
account_number	string/null	Nomor rekening / URL QRIS
account_name	string/null	Nama pemilik rekening
channel_id	uuid/null	ID channel pembayaran
channel_name	string/null	Nama bank / metode pembayaran
channel_type	string/null	TRANSFER / QRIS
channel_instructions	array	Langkah-langkah atau instruksi pembayaran
is_manual_match	bool	Indikator apakah transaksi dicocokkan secara manual
manual_matched_mutation_id	uuid/null	ID mutasi terkait (jika dicocokkan secara manual)

200 OK

    {
      "success": true,
      "message": "ok",
      "data": {
        "payment_id": "660e8400-e29b-41d4-a716-446655440010",
        "payment_code": "INV-2026-0001",
        "payment_amount": 50000,
        "payment_unique": 123,
        "payment_total": 50123,
        "payment_status": "PAID",
        "payment_expired_at": "2026-10-11T12:00:00Z",
        "payment_updated_at": "2026-06-11T10:05:00Z",
        "payment_webhook_url": "https://yourserver.com/webhooks/bayar",
        "payment_checkout_url": "https://bayar.digital/checkout/660e8400-e29b-41d4-a716-446655440010",
        "payment_return_url": "https://yourserver.com/orders/INV-2026-0001",
        "customer_name": "Budi Santoso",
        "customer_email": "budi@example.com",
        "customer_phone": "081234567890",
        "customer_orders": [
          {
            "name": "Produk A",
            "price": 50000,
            "quantity": 1,
            "subtotal": 50000
          }
        ],
        "account_id": "550e8400-e29b-41d4-a716-446655440000",
        "account_number": "1234567890",
        "account_name": "PT Merchant Contoh",
        "channel_id": "660e8400-e29b-41d4-a716-446655440001",
        "channel_name": "Bank Central Asia",
        "channel_type": "TRANSFER",
        "channel_instructions": [],
        "is_manual_match": false,
        "manual_matched_mutation_id": null
      }
    }

Gagal

Code	Status	Keterangan
tenant_api_key_required	403	API Key tidak valid atau tidak disertakan
not_found	404	payment_code tidak ditemukan di dalam sistem
internal_error	500	Terjadi kendala pada server, silakan coba beberapa saat lagi

404 Not Found

    {
      "success": false,
      "code": "not_found",
      "message": "payment not found"
    }