Paymenku Docs
Referensi APIKanal & fee

Panduan cara bayar

GET
/payment/instruction

Langkah pembayaran per kanal, siap ditampilkan ke pelanggan. Bila pay_code dan amount diisi, keduanya disubstitusi ke dalam teks.

Langkah berisi tag HTML sederhana (<b>) untuk penekanan. Bila Anda merender sebagai teks biasa, bersihkan tag-nya sendiri.

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

code*string

Kode kanal. Harus kode yang ada.

pay_code?string

Nomor VA atau kode bayar; disubstitusi ke langkah.

Lengthlength <= 64
amount?integer

Nominal; diformat sebagai rupiah di dalam langkah.

Range0 <= value
allow_html?string

1 (bawaan) membiarkan tag seperti <b> di dalam langkah; 0 menghapus seluruh tag.

Default"1"
Value in"0""1"

Response Body

Daftar panduan, satu per metode.

application/json
  1. response
success?boolean
message?string
data?array<>
Example Request
curl -X GET 'https://paymenku.com/api/v1/payment/instruction?code=bca_va'
Example Response
{  "success": true,  "message": "",  "data": [    {      "title": "ATM BCA",      "steps": [        "Masukkan kartu ATM BCA dan PIN",        "Pilih menu <b>Transaksi Lainnya</b> > <b>Transfer</b> > <b>ke Rek BCA Virtual Account</b>",        "Masukkan Nomor Virtual Account (<b>1234567890</b>)",        "Konfirmasi nominal Rp 100.000, jika sesuai pilih <b>YA</b>",        "Transaksi sukses, simpan struk Anda"      ]    },    {      "title": "BCA mobile (m-BCA)",      "steps": [        "Login ke aplikasi BCA mobile",        "Pilih menu <b>m-Transfer</b> > <b>BCA Virtual Account</b>",        "Masukkan Nomor Virtual Account (<b>1234567890</b>)",        "Konfirmasi nominal Rp 100.000",        "Masukkan PIN m-BCA",        "Transaksi sukses"      ]    }  ]}