印尼支付系统沙箱环境及测试配置方法指南

一、印尼支付系统沙箱概述

印度尼西亚作为东南亚最大的数字经济体之一，其支付系统发展迅速。为促进金融科技创新，印尼金融服务管理局(OJK)和央行(BI)推出了支付系统沙箱环境，允许企业在受控条件下测试创新支付解决方案。

沙箱核心价值体现在三个方面：降低合规风险、加速产品迭代周期、优化用户体验。通过模拟真实交易环境但隔离实际资金流动，企业能够安全验证技术可行性。

二、申请接入印尼支付系统的条件与流程

2.1 基本资质要求

申请机构需满足以下条件：

• 在印尼合法注册的金融机构或持牌金融科技公司
• 具备最低10亿印尼盾(约合7万美元)的注册资本
• 拥有完善的反洗钱(AML)和客户身份识别(KYC)流程
• IT基础设施符合PCI DSS三级以上安全标准

2.2 API接口文档获取途径

开发者可通过以下渠道获取最新API文档：

1. BI-SPSS(Sistem Pembayaran Ritel Nasional)官方网站下载区
2. OJK金融科技办公室线下申请
3. Partner Sandbox提供商门户网站(如Doku, Midtrans等)

建议优先选择官方渠道获取材料，确保接口版本与生产环境一致。

三、本地化测试环境的搭建步骤

3.1 Java/Python开发示例代码结构分析

// Java示例：基础交易请求类结构 

public class IndoPaymentRequest {

    private String merchantCode; //商户编号(MID)

    private String transactionId; //遵循BI格式TRX2023MMDDHHmmssSSS 

    private BigDecimal amount;

    private Currency currency = Currency.getInstance("IDR");

    

    @NotNull 

    @Size(min=16,max=19)

    private String customerPAN; //卡号需符合BIN规则

    

    // Getter & Setter方法省略...

}

Python开发者应特别注意处理浮点精度问题：

# Python金额处理最佳实践示例  

from decimal import Decimal  



def format_idr_amount(value):

     return Decimal(str(value)).quantize(Decimal('0.00'))

XML报文特殊要求解析（表格）

注：所有XML节点名称必须使用小写字母

SSL证书双向认证配置要点（重点）

1）采用TLSv1_2及以上协议版本

openssl s_client -connect sandbox.bi.go.id:443 -tls1_2  

2）证书链必须包含以下CA：

• DigiCert Global Root CA
• Entrust Root Certification Authority

3）CRL检查频率设置不超过4小时

常见错误SSLHandshakeException排查步骤：
①确认密钥库(JKS/p12)包含完整证书链；②检查服务器SNI配置；③验证本地时间同步状态

QRIS标准测试案例设计模板（表格）

用例编号 Q001-TC003

操作步骤:

[Consumer]打开合作银行APP扫码功能 → [System]解析二维码显示金额 → [User]确认付款并输入PIN → [Acquirer]发送授权请求至BI清算中心 → [Issuer]返回批准响应码"00"

预期结果:

收单方收到清算通知的时间≤5秒；交易状态同步至商户管理后台≤30秒；结算文件生成符合ISO20022标准。

异常流处理:
当遇到响应码"51"(余额不足)，应触发智能路由切换至其他关联账户或提示用户充值。

压力测试参数建议值:

并发用户数 ≥500TPS持续15分钟；
网络延迟模拟 ≤800ms；
数据库连接池 ≥50个活跃连接；

性能达标指标平均响应时间<1200ms成功率≥99%。

四．监管报告自动化生成技巧关键字段映射关系:

原始日志字段→监管报表列名对照表：

transaction_date→TGL_TRANSAKSI(Dd/MM/yyyy格式)；customer_id→NIK_KT_PEMBELI(加密存储)；settlement_amount→NILAI_SETEL_IDR千分位分隔符)。

五．上线前合规检查清单重要项标记：

□完成所有BI-MDR费率计算验证 □通过PCI ASV扫描并获得合规证明 □存储类敏感信息加密方案获得OJK预审回执 □至少执行三轮完整的UAT循环测试。

六、印尼支付沙箱测试数据管理规范

6.1 测试账户分类体系

标准测试账户分为三类：

• 基础验证账户：用于基本交易流程验证

  • 固定余额账户（余额始终显示500万印尼盾）
  • 零余额账户（强制触发失败场景）

• 风控专用账户

  • 高频交易标记账号（单日限额20笔）
  • AML监控账号（预设可疑交易模式）

• 特殊业务账户
  二维码合并付款专用钱包
  跨境汇款模拟账号（支持USD/IDR双币种）

API响应码对照表开发必备参考：

Java/Python异常处理最佳实践示例：

// Java版智能错误处理框架 

try {

    IndoPaymentResponse resp = gateway.execute(req);

} catch (BIStandardException e) {

    switch(e.getErrorCode()) {

        case "9101": //系统维护中

            logger.warn("进入降级模式");

            fallbackService.process(req);

            break;

        default:

            throw new PaymentRetryableException(e); 

    }

}

Python开发者应特别注意异步回调的签名验证：

# Python回调验签实现示例 

def verify_bi_callback(data, signature):

    public_key = load_official_public_key()

    digest = hashlib.sha256(

        f"{data['txn_id']}{data['amount']}".encode()

    ).digest()

    

Mock Server配置黄金法则

1. 延迟模拟规则必须符合实际网络状况

// WireMock模拟雅加达地区延迟配置 

{

    "request": {"method": "POST","urlPath":"/api/vqr"},

    

}