HaiPay

English

简体中文

English

简体中文

Appearance

Indonesia Payment API

About 1557 wordsAbout 5 min

Warning

Before reading this API documentation, please make sure to check API Description Guide

Limits

Transaction TypeLimit (Unit: IDR)
CollectionSee Payment Methods appendix
DisbursementBank (BANK_ACCOUNT): 10,000 – 40,000,000
Wallet (EWALLET): 10,000 – 20,000,000

Collection API

Collection Apply

Description:

  • Create a collection order

URL：/idr/collect/apply
Note: appId IDR, amount IDR, settlement IDR

URL：/usd/collect/apply
Note: appId USD, amount USD, settlement USD

Parameters:

FieldRequiredTypeDescription
appIdYesLongBusiness ID (retrieved from the backend; must pass the corresponding ID for the currency in the URL)
orderIdYesStringMerchant order ID (must be unique, max length 48)
nameYesStringPayer's name (English or Bahasa Indonesia, spaces allowed, 1–30 characters)
phoneYesStringValid phone number (08xxxxxxxxxx), format reference Phone Format
emailYesStringValid email address
amountYesStringTransaction amount (Unit: IDR)
payTypeYesStringTransaction type: QR, VA, EWALLET
inBankCodeYesStringPayment Method
callBackUrlYesStringRedirect URL after successful payment
callBackFailUrlYesStringRedirect URL after failed payment
notifyUrlNoStringCallback notification URL
currencyNoStringCurrency (default: IDR)
subjectNoStringPayment note (transaction title, product name, payment purpose)
bodyNoStringDetailed note
partnerUserIdYesStringUnique user identifier (e.g., userId); must be valid
signYesStringSignature

request

{
  "appId": 1054,
  "orderId": "M233323000059",
  "amount": "300",
  "phone": "08230219312",
  "email": "23423@qq.com",
  "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=="
  }
}

Response Data Parameters

FieldTypeDescription
orderIdStringMerchant order ID (must be unique)
orderNoStringPlatform order ID
payUrlStringReturned payment address, or instructions/details in other scenarios
bankNoStringCollection account number (VA)
bankCodeStringCollection bank code
qrCodeStringQR code content (can be used to generate a QR code)
signStringSignature

Collection Query

Description:

  • Query collection order

URL：/idr/collect/query

URL：/usd/collect/query

Parameters:

FieldRequiredTypeDescription
appIdYesLongBusiness ID (retrieved from the backend; must pass the corresponding ID for the currency in the URL)
orderIdYesStringMerchant order ID
orderNoNoStringPlatform order ID (faster response)
signYesStringSignature

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=="
  }
}

Response Data Parameters

FieldTypeDescription
orderIdStringMerchant order ID (must be unique)
orderNoStringPlatform order ID
amountStringTransaction amount
actualAmountStringReceived amount
feeStringFee
statusIntegerStatus (0 Not started, 1 Processing, 2 Success (final), 3 Failed (final), -1 Exception pending confirmation)
payTimeStringPayment success time (available when status = 2, 4, 5) (Indonesia Time), format: yyyy-MM-dd HH:mm:ss
errorMsgStringFailure reason (available when status = 3)
signStringSignature

Payment Methods

IDR Orders

payTypeinBankCodeLimitDescription
QRdynamic10000-10000000QRIS
EWALLETDANA10000-20000000Dana Wallet
EWALLETSHOPEEPAY10000-20000000ShopeePay
EWALLETLINKAJA10000-20000000LinkAja
CASHIEROVO10000-20000000OVO Wallet
VA00210000-20000000BRI Bank
VA00910000-20000000BNI Bank
VA01310000-20000000PERMATA Bank
VA02210000-20000000CIMB Bank

USD Orders

payTypeinBankCodeLimitDescription
QRID_QRIS_USD0.99-500QRIS
EWALLETID_DANA_USD0.99-1000Dana Wallet
EWALLETID_SHOPEEPAY_USD0.99-1000ShopeePay
EWALLETID_LINKAJA_USD0.99-1000LinkAja
CASHIERID_OVO_USD0.99-1000OVO Wallet
VAID_BRI_USD0.99-1000BRI Bank
VAID_BNI_USD0.99-1000BNI Bank
VAID_PERMATA_USD0.99-1000PERMATA Bank
VAID_CIMB_USD0.99-1000CIMB Bank

Disbursement API

Disbursement Application

Description:

  • Create a disbursement order

URL：/idr/pay/apply

Parameters:

FieldRequiredTypeDescription
appIdYesLongBusiness ID (retrieved from the backend; must pass the corresponding ID for the currency in the URL)
orderIdYesStringMerchant order ID (must be unique, max length 48)
amountYesStringTransaction amount (unit: IDR)
accountTypeYesStringAccount type: BANK_ACCOUNT, EWALLET
bankCodeYesStringBank Code
accountNoYesStringUser bank account number
nameYesStringRecipient name (format: English or Indonesian letters, case-insensitive, spaces allowed, 1-30 characters, "firstName middleName lastName" (middleName is optional), special characters allowed: '.-))
phoneYesStringValid phone number (format reference: Phone number format)
emailYesStringValid email
notifyUrlNoStringCallback URL
subjectNoStringPayment remark (transaction title, product name, payment reason)
bodyNoStringRemark details
partnerUserIdYesStringUnique user identifier (e.g., userId). Required for risk control system. Must be valid, otherwise transactions may be affected. Format: numbers, letters, or common symbols -~!@#$%&*()_.
signYesStringSignature

request（accountType为BANK_CARD类型时）

{
  "appId": 1054,
  "orderId": "M100000450012",
  "amount": "500",
  "accountType": "BANK_ACCOUNT",
  "bankCode": "014",
  "accountNo": "09876543210",
  "name": "john doe",
  "phone": "08276543210",
  "email": "johndoe@cashfree.com",
  "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=="
  }
}

Response Data Parameters

FieldRequiredTypeDescription
orderIdStringMerchant order ID (must be unique)
orderNoStringPlatform order ID
signStringSignature

Disbursement Query

Description:

  • Query a disbursement order

URL: /idr/pay/query

Parameters:

NameRequiredTypeDescription
appIdYesLongBusiness ID (retrieved from the backend; must pass the corresponding ID for the currency in the URL)
orderIdYesStringMerchant order ID
orderNoNoStringPlatform order ID (faster response)
signYesStringSignature

request

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

response — Order Failed

{
  "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 — Order Successful

{
  "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=="
  }
}

Response Data Parameters

FieldTypeDescription
orderIdStringMerchant order ID (must be unique)
orderNoStringPlatform order ID
amountStringTransaction amount
feeStringTransaction fee
statusIntegerOrder status (0: Not Started, 1: Processing, 2: Disbursement Successful (final), 3: Disbursement Failed (final), -1: Exception Pending Confirmation)
payTimeStringSuccess time (value available when status=2) (Indonesia time), format: yyyy-MM-dd HH:mm:ss
errorMsgStringFailure reason (value available when status=3)
signStringSignature

Bank Codes

Bank Codes for 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

Wallet Codes for EWALLET

bankCodebankName
DANADana eWallet
OVOOVO eWallet
GOPAYGoPay eWallet
LINKAJALinkAja eWallet
SHOPEEPAYShopeePay eWallet

Theme by cotmier

Copyright © 2019-2025 HaiPay | MIT License