Generate QRIS

创建 QRIS 收款交易。商户将获得可展示给用户扫码支付的二维码数据。

Endpoint

POST /api/v1/payin/qris/generate

Request Body

Parameter	Type	Required	Description
merchantTrxId	string	Yes	商户侧唯一交易 ID
amount	number	Yes	支付金额（印尼盾）
notifyUrl	string	Yes	接收交易状态通知的 webhook URL
productName	string	Yes	商品/服务名称

示例请求

{
  "merchantTrxId": "{{requestId}}",
  "amount": 10000,
  "notifyUrl": "https://webhook.site/f793fdb2-3881-4a2f-99bc-50c8d4ffc54f",
  "productName": "test aja"
}

交易 ID 唯一性

请确保 merchantTrxId 始终唯一。重复 ID 会返回 "Transaction ID duplicate" 错误。

成功响应

{
  "logId": "BZPkFn1N7zJCOBOQNaWh",
  "status": true,
  "message": "QRIS created successfully",
  "data": {
    "merchantTrxId": "2026011422090788287851188",
    "platformTrxId": "2026011415091972123",
    "qrData": "00020101021226650013ID.NETZME.WWW01189360081401001086120215ID20240000003170303UKE51440014ID.CO.QRIS.WWW0215ID20240000003170303UKE5204413153033605405110005802ID5908LAVISKA16005DEPOK61051641162690703A010812qris_invoice994200020001323154d168e6d14afd981d420a52828bdc63049739",
    "amount": 11000,
    "expired": 900
  }
}

响应字段

Field	Description
merchantTrxId	商户交易 ID
platformTrxId	KingsPay 平台交易 ID
qrData	可用于生成二维码的 QRIS 数据字符串
amount	最终金额（可能因手续费/管理费而变化）
expired	二维码有效期（秒）

失败响应（重复交易 ID）

{
  "status": false,
  "message": "Transaction ID duplicate",
  "logId": "HeKfJGECBgBCBJrDloEe"
}