Skip to content

Create Transaction - Payment Gateway

Endpoint Create Transaction digunakan untuk membuat transaksi baru melalui Bisabiller Payment Gateway. Transaksi ini dapat menggunakan metode pembayaran seperti QRIS, E-Wallet, dan Virtual Account.

Setelah transaksi berhasil dibuat, pengguna akan mendapatkan URL pembayaran atau kode QR yang dapat digunakan untuk menyelesaikan pembayaran.

🚣️ Endpoint POST

https://api.bisabiller.com/api/payment/transaction

Authorization: Bearer <access_token>
Accept: application/json

📥 Request Body

{
  "payment_id": 33,
  "username": "Bisabiller Testing",
  "signature": "0ef7c7e2ab7eb6fbad1fff85fc93c6866783157fe2f261155a5741b8ddda955c",
  "expired_date": "2023-03-23 18:23:10",
  "nominal": 10000,
  "admin_fee": 3000,
  "transaction_id": "0030c97b-5ccc-4482-b4af-9ffdb4a039be",
  "transaction_total": 13000,
  "transaction_name": "testing",
  "transaction_desc": "testing",
  "customer_number": "085925065195",
  "customer_name": "testing",
  "customer_email": "[email protected]",
  "item_details": [
    {
      "item_id": "testing",
      "item_price": 10000,
      "item_total_price": 10000,
      "item_quantity": 1,
      "item_name": "testing"
    },
    {
      "item_id": "fee",
      "item_price": 3000,
      "item_total_price": 3000,
      "item_quantity": 1,
      "item_name": "fee"
    }
  ]
}

Penjelasan Field Utama

Field	Tipe	Wajib	Deskripsi
`payment_id`	integer	Ya	ID metode pembayaran (lihat di endpoint List Bank/Channel)
`signature`	string	Ya	Signature hash untuk validasi permintaan
`expired_date`	datetime	Opsional	Batas waktu transaksi
`transaction_id`	string	Ya	ID unik dari sistem Anda
`transaction_total`	integer	Ya	Total harga termasuk admin fee
`item_details`	array	Ya	Daftar item produk dan rincian harga

📤 Response

{
  "error": false,
  "message": "success",
  "data": {
    "id": 6,
    "payment_id": 37,
    "payment_name": "GOPAY",
    "status_id": 2,
    "status": "On processing",
    "transaction_id": "0030c97b-5ccc-4482-b4af-9ffdb4a039bc",
    "transaction_total": "13000",
    "expired_date": "2023-03-23 18:23:10",
    "transaction_name": "testing",
    "transaction_desc": "testing",
    "customer_number": "085925065195",
    "customer_name": "testing",
    "customer_email": "[email protected]",
    "payment_links": "https://app.midtrans.com/snap/v3/redirection/1ca52d24-1574-4f82-9f84-d4314a817348",
    "payment_code": null,
    "qr_code": null,
    "item_details": [
      {
        "item_id": "testing",
        "item_price": "10000",
        "item_quantity": "1",
        "item_total_price": "10000",
        "item_name": "testing"
      },
      {
        "item_id": "fee",
        "item_price": "3000",
        "item_quantity": "1",
        "item_total_price": "3000",
        "item_name": "fee"
      }
    ]
  }
}

Penjelasan Field Penting dalam Response

Field	Tipe	Deskripsi
`transaction_id`	string	ID unik dari transaksi yang dibuat
`status`	string	Status saat ini (contoh: On processing)
`payment_links`	string	Link untuk redirect ke halaman pembayaran
`payment_name`	string	Nama metode pembayaran yang digunakan
`qr_code` / `payment_code`	string	Bisa digunakan untuk channel QRIS atau VA

Catatan:

Signature dibutuhkan sebagai validasi keamanan — pastikan sesuai algoritma hash yang disepakati.

Gunakan payment_links untuk mengarahkan pengguna ke halaman pembayaran.

Jangan gunakan kembali transaction_id yang sudah dipakai sebelumnya.

Simpan transaction_id untuk cek status atau rekonsiliasi di kemudian hari.