Paymenku Docs
Referensi APIKanal & fee

Hitung fee

GET
/merchant/fee-calculator

Menghitung fee untuk satu nominal, sebelum transaksi dibuat. Tanpa code, seluruh kanal aktif dikembalikan — berguna untuk menampilkan perbandingan biaya di halaman checkout.

total_fee sudah dipecah menjadi bagian merchant dan bagian pelanggan sesuai fee_mode, jadi Anda tidak perlu menghitung ulang.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Kirim kunci API sebagai bearer token pada header Authorization, dengan format Bearer YOUR_APIKEY.

Ada dua jenis kunci:

  • sk_live_ — produksi. Transaksi nyata, dan butuh KYC yang sudah disetujui.
  • sk_test_ — sandbox. Tanpa perpindahan dana, tanpa syarat KYC.

Ambil kunci di Dashboard Merchant, menu Settings lalu API Keys.

Kunci API adalah kredensial rahasia: simpan di environment variable atau secret manager. Jangan pernah menaruhnya di frontend, aplikasi mobile, atau repositori publik.

Query Parameters

amount*integer

Nominal dasar dalam rupiah.

Range1 <= value
code?string

Batasi ke satu kanal. Harus kode yang ada.

Response Body

Rincian fee per kanal.

application/json
  1. response
success?boolean
data?array<>
Example Request
curl -X GET 'https://paymenku.com/api/v1/merchant/fee-calculator?amount=100000'
Example Response
{  "success": true,  "data": [    {      "code": "qris",      "name": "QRIS",      "group": "QRIS",      "type": "qris",      "flow": "direct",      "fee": {        "flat": 200,        "percent": 0.7      },      "total_fee": {        "merchant": 0,        "customer": 900      },      "fee_mode": "customer",      "limits": {        "min_amount": 1000,        "max_amount": 10000000,        "min_expiry_minutes": 1440,        "max_expiry_minutes": 1440      }    }  ]}