QRIS

QRIS,全称 Quick Response Code Indonesian Standard,是印尼的全国统一二维码支付标准。由 Bank Indonesia(印尼央行) 推出,目的是让全国所有电子钱包(E-Wallet)、银行App、支付网关,都能用一个二维码实现互通支付。


支付方式属性

字段名称内容
可用国家代码印度尼西亚(ID)
消费者货币IDR
处理货币IDR
结算货币美元 (USD)
类型 I钱包(Wallet)
类型 IIqris
最小交易金额10000 IDR
会话超时30分钟
退款不支持退款
拒付无
集成类型异步
备注订单金额必须为整数

交易流程

  1. 消费者在商家的结账页面选择QRIS付款。
  2. 返回对应二维码
  3. 消费者通过APP扫码二维码完成支付。
  4. 消费者完成交易。

集成

请求参数说明:

参数名类型必填说明
referenceString是订单唯一标识
amountObject是订单金额(必须为整数)
├── currencyString是货币类型(如 IDR)
├── valueNumber是金额数值,单位为最小货币单位
productDetailString是订单描述
countryCodeString是国家代码(如 ID)
originString是订单来源,如商城域名
paymentMethodObject是支付方式信息
├── typeString是支付方式
returnUrlString是支付完成后返回的 URL
shopperReferenceString是付款人唯一标识
{
    "reference": "ljw1764656320899",
    "amount": {
        "currency": "IDR",
        "value": 1000000
    },
    "productDetail": "ljwtest",
    "countryCode": "ID",
    "origin": "fffmall.com",
    "paymentMethod": {
        "type": "qris"
    },
    "returnUrl": "https://www.baidu.com/",
    "shopperReference": "LLL176094740252"
}

响应参数说明

参数名类型必填说明
codeString是响应状态码,"0" 表示成功
msgString是响应消息
serverTimeNumber是服务器时间戳,单位毫秒
dataObject是业务数据对象
├── actionObject是支付跳转相关信息
│ ├── paymentMethodTypeString是支付方式类型(如 alipaycn)
│ ├── qrCodeString是二维码 URL
│ ├── methodString是请求方法(如 Get)
│ ├── typeString是操作类型(如 qrcode)
├── amountObject是订单金额信息
│ ├── currencyString是货币类型(如 HKD, USD)
│ ├── valueNumber是金额数值,单位为最小货币单位
├── merchantReferenceString是商户订单号
├── pspReferenceString是支付平台交易号
├── resultCodeString是支付结果状态(如 PENDING)
├── additionalDataObject是支付相关信息
│ ├── expireTimeString是过期时间
successBoolean是是否成功(true 表示成功)

交易调用输出示例

{
    "code": "0",
    "msg": "success",
    "serverTime": 1764656325447,
    "data": {
        "action": {
            "paymentMethodType": "qris",
            "method": "Get",
            "type": "qrcode",
            "qrCode": "https://i.snipboard.io/kYLlFf.jpg"
        },
        "additionalData": {
            "expireTime": "1764683325000"
        },
        "amount": {
            "currency": "IDR",
            "value": 1000000
        },
        "merchantReference": "ljw1764656320899",
        "pspReference": "1995739392320339968",
        "resultCode": "PENDING",
        "providerReference": "71ca686c-aa2b-4edd-86fe-fa205b3a282d"
    },
    "success": true
}

附加信息

无


Did this page help you?