HaiPay

简体中文

English

简体中文

English

外观

印尼支付接口

2041字约7分钟

注意

阅读该接口文档前，务必先查看 接口说明

限额

交易类型限额(单位:IDR)
代收qris：1w-1000w; VA: 1w-2000w; dana：1w-2000w; OVO：1.5w-2000w
代付银行(BANK_ACCOUNT): 1w-4000w 钱包(EWALLET): 1w-2000w

代收API

代收申请

简要描述：

  • 创建代收订单

URL：/idr/collect/apply

参数：

参数名必选类型说明
appId是Long业务ID（后台获取，需要根据URL中的币种传递对应的业务ID）
orderId是String商户订单号(必须保证唯一性，长度不超过48)
name是String付款人姓名(付款人姓名格式:英文或印尼语大小写且允许有空格,1-30位,"firstName middleName lastName" (middleName非必填,特殊字符支持!-)
phone是String真实手机号(08xxxxxxxxxx)，（格式参考 电话号码格式 ）
email是String真实电子邮件
amount是String交易金额(单位：印尼盾）
payType是String交易类型：QR，VA,EWALLET
inBankCode是String支付方式
callBackUrl是String支付重定向地址
notifyUrl否String回调地址
currency否String币种(默认IDR)
subject否String支付备注
body否String备注详情
partnerUserId是String用户唯一标识（如用户ID userId），用于风控系统，必须真实有效，否则会影响交易。 格式要求：数字、大小写字母或常用符号-~!@#$%&*()_。
sign是String签名

request

{
    "appId": 1054,
    "orderId": "M233323000059",
    "amount": "300",
    "phone": "08230219312",
    "email": "[email protected]",
    "name": "test",
    "inBankCode": "014",
    "payType": "QR",
    "partnerUserId": "149597870",
    "sign": "af0gAHkUOyYHu9owQp8NJ4mPEeUW4vuJcjdxqLIzrVw8AvpLSjD1DXupReSG/CyuSkFRyiIvCp5u703AuGGmfgD2gKDH3Ywau41bAbG2jnHJ8mtjiSJ5iWUzanyd4Kr7d1+rETbzUl7/BkW3t0X8UUFdqpxwG8DPUjAwUKfplWDHV7koG51Ozexd80DCsmW6eWdouAZ1uNXGLYmV3ftE3BmfNRtuv1C5bfTJWrTEIOxbF6g2uYOFZTlIgrQgd7/2PsAYwQQXNz8Q8CYl4OxqCv4pXJxaLWPbR5tqZu9og5kn32C9aHW/NlU1y39vzz+4ef81yPAqUV9oHlSMSPrMmw=="
}

response

{
    "status": "1",
    "error": "00000000",
    "msg": "",
    "data": {
        "orderId": "M233323000059",
        "orderNo": "6023071013539074",
        "payUrl": "https://a.api-uat.idr.com/1L9zQS2",
        "bankCode": "014",
        "qrCode": "00020101021228760011ph.ppmi.p2m0111OPDVPHM1XXX0315777148000000017041652948137245442930503001520460165303608540810000.vnd Of Mandalu62310010ph.allbank05062110000803***88310012ph.ppmi.qrph0111OPDVPHM1XXX63042763",
        "sign": "YEoA8Y2JzQFGVzwJSqmemm1Kfv/bfyIfCqv2dp7RNzT5B72AQvdD+nt2nR4sL1HWscvmNHyVt5ovAi7MMhy3ziih/sMph+wPx4YjH3W1h5DyBvSlWvaKfKrK5ViomZ0pPYWydwRHnnRnicxToHK9S6qtSy7Q73O0hdz4hJ9p41Th3ycBl2Q9SeqSZYSY1ohcPDhdyRf2y0prb8rHgpBKzxZ5BKX/1bsE9OmsSEHAEYT8OGgko6aNe8XPAhr4G48cpWTftvnGQuzh0O65nuZRI/PF+Axt2zJCVbFHDDSREI9NlAT82ebDqhlVdxQzKE67D1nxgjb3dPmDUYHOBpmwxQ=="
    }
}

返回data参数说明

参数名类型说明
orderIdString商户订单号(必须保证唯一性)
orderNoString平台订单号
payUrlString返回的是收款地址 其他时候返回的是指引或者详情
bankNoString收款卡号(VA)
bankCodeString收款银行
qrCodeString二维码内容-可自行生成二维码(QR)
signString签名

代收查询

简要描述：

  • 创建代付订单
  • 当“payType=PAYMENT_GATEWAY” 时同步返回orderNo可以直接查询
  • 其他支付方式异步通知后，通过orderNo查询二次确认状态

URL：/idr/collect/query

参数：

参数名必选类型说明
appId是Long业务ID（后台获取，需要根据URL中的币种传递对应的业务ID）
orderId是String商户订单号
orderNo否String平台订单号（响应快）
sign是String签名

request

{
    "appId": 1054,
    "orderId": "M22222000028",
    "sign": "EmyJGm3ELzG4FsOd0Krs9ncbSjo4oTGuXWML+7djYla3+VAwd9wS17z38p/7U2ZAjroO04XrE7YXcB1o76Dtyipj3h3bJzs7FYma1QNkMUdt9hh7m8U6hMsMQX7vIWHtXNwz4pbTSC75+kQWXaCew7KoE6LXECdJU8AISgNgeki2TK9R0pCfshr0Z2SZBPeuT6OvIH5LdmqgdZhuqnffGU2qnXk4KMkO848e6/WALLBR+LE1wyKHfPnYVcuKSMVYxkvKyyIL5JIPEgW0o5bh4RCbaUn3NZtyYwrU1uQ3ZDFRThm9j6XAQP+LBlmq3nOePqBtp/VDVarRaV+7FbQg3A=="
}

response

{
    "status": "1",
    "error": "00000000",
    "msg": "",
    "data": {
        "orderId": "M22222000028",
        "orderNo": "6023042811314347",
        "amount": "50000.00",
        "actualAmount": "0.00",
        "fee": "0.00",
        "status": 1,
        "sign": "fP433ygWVDLVGxYkVnIJj7riGq0U3vyVX+MbBAImxfGLZkZcEAHVEoVYuULZSmXAAXKRSyd67WlDNm+24pougM54ofAoH4HMtCL2tfCoBReFyz3z02AGKkrKE2xWhSpWoqfQoBvzwuN5iGMMu0s9Q1YvqiwJ8WDVIENnmiIyD8qDJN7caHTW2US14/faG+69AvnuIgJ/nu7/jogOlgEYdZdVYU7gcRDE+d47KjlFGswQkJ/h/uzV7cWtUqrtOO7ZnZ3/z33Xx8awokX36QoYcPSWAU0h+Ij9O9402HNhm1eTbYcLU0uI/z8xCAtyAI/tTyiFijpiNlxUKQj+zKsILw=="
    }
}

返回data参数说明

参数名类型说明
orderIdString商户订单号(必须保证唯一性)
orderNoString平台订单号
amountString交易金额
actualAmountString收到金额
feeString手续费
statusInteger状态(0未开始，1支付中，2成功（终态），3失败（终态）, -1异常待确认)
payTimeString支付成功时间（当status=2,4,5时有值）(印尼时间), 格式: yyyy-MM-dd HH:mm:ss
errorMsgString失败原因（当status=3时有值）
signString签名

支付方式

payTypeinBankCode说明
CASHIERCASHIER收银台模式
QRdynamicdynamic qris，动态码
EWALLETDANAdana 钱包
EWALLETSHOPEEPAYshopee 钱包
EWALLETOVOovo 钱包(注: OVO是直接推送订单到真实手机号注册的OVO账号内，
使用此种方式需要确保phone字段正确, 或使用payType = CASHIER)
CASHIEROVOOVO 钱包(注: 使用此种方式，haipay提供页面供用户输入手机号)
VA002BRI银行
VA009BNI银行
VA013PERMATA银行
VA022CIMB银行

代付API

代付申请

简要描述：

  • 创建代付订单

URL：/idr/pay/apply

参数：

参数名必选类型说明
appId是Long业务ID（后台获取，需要根据URL中的币种传递对应的业务ID）
orderId是String商户订单号(必须保证唯一性，长度不超过48)
amount是String交易金额(单位：印尼盾）
accountType是String账户类型： BANK_ACCOUNT,EWALLET
bankCode是String银行代码
accountNo是String用户银行账号
name是String收款人姓名(收款人姓名 格式：英文或印尼语大小写且允许有空格，1-30位,"firstName middleName lastName" (middleName 非必填, 特殊字符支持 '.-))
phone是String真实手机号（格式参考 电话号码格式 ）
email是String真实电子邮件
notifyUrl否String回调地址
subject否String支付备注（交易标题，商品名称，支付原因）
body否String备注详情
partnerUserId是String用户唯一标识（如用户ID userId），用于风控系统，必须真实有效，否则会影响交易。 格式要求：数字、大小写字母或常用符号-~!@#$%&*()_。
sign是String签名

request（accountType为BANK_CARD类型时）

{
    "appId": 1054,
    "orderId": "M100000450012",
    "amount": "500",
    "accountType": "BANK_ACCOUNT",
    "bankCode": "014",
    "accountNo": "09876543210",
    "name": "john doe",
    "phone": "08276543210",
    "email": "[email protected]",
    "subject": "iphone13",
    "body": "ProMotion technology with adaptive refresh rates up to 120Hz",
    "partnerUserId": "149597870",
    "sign": "I1PeK3eJOVsFFNowxVRqMXpeWm1lr/BcRpBi8WsW4wVo1+5CC3JsrFq/m/L2O69NzKHvtDWi4zia3DL3dPut0yMyUyqL91LNCSaeISbGsQPlhEsQpyTOryS/RKOfsrn2Xo37SCF/phAvndOk2jwwGwqM5xLz1ms9Ukl85wv27QFNrXIMxK2p18oe7MpMYrgf+xvEBE/VqCtKMtN9pO449wWwXzHWNPbZ76s4pAvKwRE9yXQDr7Iw14Dktcnl1FoLM4gWM/obkO+mz6SyAGDuXhVh/+OD/IGNiCyTCNq6ciQY28UnCFV6ZIP40gxsFhfBJKbK+Raw7y1Bh912ifYfug=="
}

response

{
    "status": "1",
    "error": "00000000",
    "msg": "",
    "data": {
        "orderId": "M100000450013",
        "orderNo": "3023062014149637",
        "sign": "LmhUnkw5j0pMiimsG8rKwdNNZGvXH5MpSmD6mdHZwq1SQwuK5BohmdEoqKB/jkMk28o3da4Cxh6Q+tW97+yTCemRrF+dMaHA73rpOeUuujKQl/UcFvJuMhfLBa2tp09L71NzoBqpPD6aXf37mYAz8E1HmERwFPpac5FVxIYanHG8cqmMLJYsVmHTSxWavgWU03ys9UczBePkBiR8sl2FSOhFABB0wAP28lswrV/ABS68IsLKtyd1fyI3GBfSbIK5nDEEnlE+EdElFdLs9taAxJImeVF1x4eT47+bkPJ2qS8z3K8QGzKLF3W+8SiRZGfSwDTsLKH+2Vycvy5auRl+ag=="
    }
}

返回data参数说明

参数名必选类型
orderIdString商户订单号(必须保证唯一性)
orderNoString平台订单号
signString签名

代付查询

简要描述：

  • 创建代付订单

URL：/idr/pay/query

参数：

参数名必选类型说明
appId是Long业务ID（后台获取，需要根据URL中的币种传递对应的业务ID）
orderId是String商户订单号
orderNo否String平台订单号（响应快）
sign是String签名

request

{
    "appId": 1000,
    "orderId": "M1234567111",
    "orderNo": "3022111516571436",
    "sign": "ZxkVZL+GAyv0VhvWn4IvuYahTzxgQuthkuV2ONWiqIfIDb2avvHlFOUJVzqZi1q8CPHXZm1ltanRTRVTxfsuftLvGeDioUHglWt46/RU6c1OPznpLGsZ35Q3n5tW2y1EnOsxPynXBFLuDQy+aZ3l9u6AQ30T0zQexMGT+IxuFkmUp02g/6juaHa5ZgNMv7lN67ixIp162wrM7OJuaOif872QijSceRdZhzaMGImAwB0D4MosRV4WMBOKkwgPdmS7GuZN66YUidXk3wTGqX3MYRw6M0kj4eNegSUwPXvp4q4p0KO8Y3xUMld54GY2ApX3WN3CBtC/vpJqEszjGBbbGg=="
}

response — 订单失败

{
    "status": "1",
    "error": "00000000",
    "msg": "",
    "data": {
        "orderId": "M1234567111",
        "orderNo": "3022111516571436",
        "amount": "100000.00",
        "fee": "0.00",
        "status": 3,
        "errorMsg": "Đơn hàng không tồn tại",
        "sign": "KKuvCl0SuNANJs+l2ogDaJm8pmV+Hi+Xa7q27vJ6D1Ehs4aOp13kRbITfJAhczh3T81BE9qwHeJaYwf+r0EypKM9TL6pMwfG8Az4gRy1D57wiUaVjl2PWcvbEqrn1hL0b+btkjvAM9I+CcSv+wuOW3/uku17Ws3FhgJLj9sFsQUBAPjDO+758VnwBytCOLBmljLBXyKgNgpmFQ1/DNkqWl0UNzyLK45Zw3yf5NiwhEFbvW0jlOWlfu/ql4hluISUQG573jEoFCBEnQLb2tQoRZj1QYNRCXPf5lbej0vzqbEwvR9h+ZOf255t1MocJkdIe463DTV5U3KZdVT87HMagw=="
    }
}

response — 订单成功

{
    "status": "1",
    "error": "00000000",
    "msg": "",
    "data": {
        "orderId": "M1234567112",
        "orderNo": "3022111517401574",
        "amount": "100000.00",
        "fee": "1003.00",
        "status": 2,
        "payTime": "2024-03-01 23:59:59",
        "sign": "khPtOmGq+cpKX0HFAI/lbP0dx4oVyNAnL5oLsdmhDJdASlQm0yg5I3o+MhImYggEsL6c2bo5fP29t54OZFqSdQDfIuNDvGbAMAr4mRBxc0hoHLkBLyyagfVPBLyQA1JY8XV3ZL4ySzQ3ZQnMCfrh2K39ueUuz6HpZ03Hj0KYijVRCXAZaio/L5jfLBT12QXmvIfAHa8s/k9flhK05ENHPep3zjj/MZGOEaX7jkEJLfjK0duypDCa61BRQjM+oePOdVsgleIl1Yf98UAxMDZ/A3912KFHEb+/jvmdnulNbiJFyuT1fEe+j2teUgw3vFsZAtwNWAgxhC7UO+N0Q5z4EA=="
    }
}

返回data参数说明

参数名类型说明
orderIdString商户订单号(必须保证唯一性)
orderNoString平台订单号
amountString交易金额
feeString手续费
statusInteger订单状态(0未开始, 1放款中 2放款成功（终态） 3放款失败（终态） -1异常待确认)
payTimeString支付成功时间（当status=2时有值）(印尼时间), 格式: yyyy-MM-dd HH:mm:ss
errorMsgString支付失败原因（当status=3时有值）
signString签名

银行代码

银行代码BANK_ACCOUNT（银行卡）

bankCodebankName
567ALLO BANK INDONESIA
116BANK ACEH SYARIAH
947BANK ALADIN SYARIAH
037BANK ARTHA GRAHA INTERNASIONAL
213BANK BTPN
547BANK BTPN SYARIAH
076BANK BUMI ARTA
054BANK CAPITAL INDONESIA
036BANK CHINA CONSTRUCTION
949BANK CTBC
011BANK DANAMON
722BANK DANAMON SYARIAH
111BANK DKI
724BANK DKI SYARIAH
945BANK IBK INDONESIA
164BANK ICBC INDONESIA
513BANK INA PERDANA
555BANK INDEX SELINDO
542BANK JAGO/SYARIAH
472BANK JASA JAKARTA
097BANK MAYAPADA
553BANK MAYORA
506BANK MEGA SYARIAH
147BANK MUAMALAT
548BANK MULTI ARTA SENTOSA
033BANK OF AMERICA NA
069BANK OF CHINA
019BANK PAN INDONESIA
110BANK PEMBANGUNAN DAERAH JAWA BARAT DAN BANTEN
425BANK PEMBANGUNAN DAERAH JAWA BARAT DAN BANTEN SYARIAH
167BANK QNB INDONESIA
494BANK RAYA INDONESIA
047BANK RESONA PERDANIA
451BANK SYARIAH INDONESIA
566BANK VICTORIA INTERNASIONAL
014BCA
501BCA Digital
536BCA SYARIAH
009BNI
129BPD BALI
137BPD BANTEN
133BPD BENGKULU
112BPD DIY
736BPD DIY SYARIAH
115BPD JAMBI/SYARIAH
113BPD JAWA TENGAH
725BPD JAWA TENGAH SYARIAH
114BPD JAWA TIMUR/SYARIAH
123BPD KALIMANTAN BARAT
727BPD KALIMANTAN BARAT SYARIAH
122BPD KALIMANTAN SELATAN
728BPD KALIMANTAN SELATAN SYARIAH
125BPD KALIMANTAN TENGAH
124BPD KALIMANTAN TIMUR DAN KALIMANTAN UTARA
729BPD KALIMANTAN TIMUR DAN KALIMANTAN UTARA SYARIAH
131BPD MALUKU DAN MALUKU UTARA
130BPD NTT
128BPD NUSA TENGGARA BARAT SYARIAH
119BPD RIAU KEPRI
126BPD SULAWESI SELATAN DAN SULAWESI BARAT
735BPD SULAWESI SELATAN DAN SULAWESI BARAT SYARIAH
135BPD SULAWESI TENGGARA
127BPD SULAWESI UTARA DAN GORONTALO
118BPD SUMATERA BARAT/NAGARI SYARIAH
120BPD SUMATERA SELATAN BANGKA BELITUNG/SYARIAH
117BPD SUMATERA UTARA
733BPD SUMATERA UTARA SYARIAH
002BRI
200BTN/SYARIAH
022CIMB NIAGA/SYARIAH
031CITIBANK NA
046DBS
161GANESHA
008MANDIRI
157MASPION
016MAYBANK INDONESIA/SYARIAH
426MEGA
151MESTIKA DHARMA
485MNC BANK
042MUFG BANK
490NEO COMMERCE
503NATIONALNOBU
028OCBC NISP/SYARIAH
013PERMATA/SYARIAH
484PT BANK KEB HANA INDONESIA
564PT BANK MANDIRI TASPEN POS
523PT BANK SAHABAT SAMPOERNA
068PT BANK WOORI SAUDARA INDONESIA 1906
041PT. BANK HSBC INDONESIA
132PT.BANK PEMBANGUNAN DAERAH PAPUA
535SEABANK
153SINARMAS
734SINARMAS SYARIAH
050STANDARD CHARTERED BANK
023UOB INDONESIA

钱包代码EWALLET（电子钱包）

bankCodebankName
DANAdana ewallet
OVOovo ewallet
GOPAYgopay ewallet
LINKAJAlinkaja ewallet
SHOPEEPAYshopeepay ewallet

Theme by cotmier

Copyright © 2019-2025 HaiPay | MIT License