下单接口 支持 https

接入方式: POST表单(application/x-www-form-urlencoded)

接入URL: https://www.xxxxxxxx.com/api/order/placeOrderByServer

参数信息
参数 参数名 必填 签名 说明
merchno 商户号 商户号,由平台分配
orderId 商户订单号 商户订单号,需唯一(只允许数字、字母、中划线、下划线的组合)
payType 支付类型 详见支付类型说明
amount 金额 保留两位小数
requestCurrency 请求货币 详见货币说明
asyncUrl 异步通知地址 异步通知的请求地址
syncUrl 同步通知地址 同步通知的请求地址
requestTime 请求时间 时间格式:yyyyMMddHHmmss
apiVersion 版本号 固定值:2
attach 备注 通知过程中会原样返回 ; 若不为空,需参与签名;
sign 签名 采用MD5签名,小写
支付类型说明
类型名 类型编码 类型名 类型编码 类型名 类型编码
VA 115 qris 116 dana 117
ovo 118 linkaja 119 gopay 120
shopeepay 121
货币说明
  • 印尼盾(idr): 7

响应样例

									

下单异步回调接口

接入方式: POST请求 (application/x-www-form-urlencoded)

接入URL: 下单参数 asyncUrl 值

参数信息
参数 参数名 必填 签名 说明
merchno 商户号 商户号,由商户系统分配
orderId 商户订单号 下单时商户的订单号
amount 金额 保留两位小数
requestCurrency 请求货币 与下单请求货币一致
payType 支付类型 支付类型
apiVersion 版本号 与下单时的版本号一致
status 订单状态 详见订单状态说明
attach 备注 下单中attach值原样返回 ; 若不为空,需参与签名
sign 签名 采用MD5签名,小写
响应协议参数
商户系统收到异步通知后,需返回 success (小写)
若返回结果 非 success ,会重复多次发送支付结果
订单状态
  • 未支付: 0

  • 支付成功: 2

  • 失败: 3

下单查询接口 支持 https

接入方式: POST请求 (application/x-www-form-urlencoded)

接入URL: https://www.xxxxxxxx.com/api/order/queryOrder

参数信息
参数 参数名 必填 签名 说明
merchno 商户号 商户号,由商户系统分配
orderId 商户订单号 商户系统订单号
requestTime 请求时间 请求时间,格式为 yyyyMMddHHmmss
apiVersion 接口版本号 固定值: 2
sign 签名 采用MD5签名, 小写
响应协议参数
参数 参数名 必填 签名 说明
code 状态码 状态码( 0:处理成功; 非0:处理失败
msg 状态描述 状态描述
content 请求时间 主体信息内容
参数 参数名 必填 签名 说明
merchno 商户号 商户号,由商户系统分配
orderId 商户订单号 商户订单号
amount 订单金额 保留2位小数
requestCurrency 请求货币 与下单请求货币一致
payType 支付类型 支付类型
attach 备注信息 下单中attach值原样返回 ; 若不为空,需参与签名
status 订单状态 订单状态
sign 签名 采用MD5签名,小写

响应实例

								
订单状态
  • 未支付: 0

  • 支付成功: 2

  • 失败: 3

余额查询接口 支持 https

接入方式: POST请求(application/x-www-form-urlencoded)

接入URL: https://www.xxxxxxxx.com/api/balance/queryBalance

参数信息
参数 参数名 必填 签名 说明
merchno 商户号 商户号,由商户系统分配
requestCurrency 请求货币 7:印尼盾(idr)
requestTime 请求时间 请求时间,格式为 yyyyMMddHHmmss
apiVersion 接口版本号 固定值: 2
sign 签名 采用MD5签名, 小写
响应协议参数
参数 参数名 必填 签名 说明
code 状态码 状态码( 0:处理成功; 非0:处理失败
msg 状态描述 状态描述
balance 余额 余额
requestCurrency 币种 币种(7:印尼盾[idr])

响应实例

								

MD5签名说明

  • 参数列表中,除去sign外,其他所有非空的参数都要参与签名,值为空的参数不用参与签名。
  • 签名顺序按照参数名的字典顺序排序,若遇到相同的首字母,则看第二个字母,以此类推
  • 将第2步组装成的字符串末尾添加 &secretKey=商家秘钥
  • 组成规则如下:

    参数名1=参数值1 & 参数名2=参数值2 …… 参数名n=参数值n & secretKey=商家秘钥

  • 所有参与签名的参数值均不进行urlencode编码,都是使用原始值进行签名
  • secretKey为商户密钥,可从"商户后台->首页->查看秘钥"自行获取
  • MD5加密后需转换为小写
  • MD5前的字符串a=aa&b=bb&c=cc&secretKey=key
    MD5加密后为3a6001d8ac3c91e75bc44c5c15bdcc3f

代付下单接口 支持 https

接入方式: POST表单(application/x-www-form-urlencoded)

接入URL: https://www.xxxxxxxx.com/api/cash/placeCash

参数信息
参数 参数名 必填 签名 说明
merchno 商户号 商户号,由平台分配
orderId 商户订单号 商户订单号,需唯一(只允许数字、字母、中划线、下划线的组合)
amount 金额 保留两位小数
tradeType 交易类型 1:钱包;2:银行;
account 收款账户名 银行卡持有人名字
cardNo 银行卡号 银行卡号
bankName 银行编码 详见银行编码
depositBank 开户支行 开户支行
asyncUrl 异步通知地址 异步通知地址
timestamp 时间戳 请求时间,格式为 yyyyMMddHHmmss
cashType 下发类型(下发通道) 7:印尼盾(idr)
requestCurrency 请求货币 7:印尼盾(idr)
apiVersion 接口版本号 固定值: 2
attach 备注 通知过程中会原样返回 ; 若不为空,需参与签名;
sign 签名 采用MD5签名
响应协议参数 响应格式为 json
参数 参数名 必填 签名 说明
sign 签名 采用MD5签名
responseContent 主体信息内容 主体信息内容
参数 参数名 必填 签名 说明
code 状态码 详见响应状态码
msg 状态描述 状态描述
timestamp 时间戳 请求格式:yyyyMMddHHmmss
merchno 商户号 商户号,由商户系统分配
orderId 商户订单号 商户订单号
orderNo 平台订单号 平台订单号(下单失败,则为空)
status 订单状态 订单状态
响应样例

									
状态码
编码说明 编码值 编码说明 类型编码 编码说明 编码值
成功 0 系统错误 500 参数不能为空 550
无效参数 551 非法参数 552 不支持的参数 553
不存在的商户 560 商户已禁用 561 尚未初始化公钥 562
ip受限 563 签名错误 564 订单号重复 565
金额小于最低限制 566 金额大于最高限制 567 交易类型不支持 568
通道维护 569 余额不足 570 不存在的订单 580
订单状态
  • 已受理: 0

  • 成功: 1

  • 失败: 2

银行编码
银行编码 银行名称 银行编码 银行名称
BNIBNI BRIBRI
CIMBCIMB MANDIRIMANDIRI
PERMATAPERMATA OVOOVO Wallet
DANADANA Wallet GOPAYGOPAY Wallet
GOPAYDRIVERGOPAY Driver SHOPEEPAYSHOPEEPAY Wallet
LINKAJALINKAJA Wallet KASPROKASPRO Wallet
CHINATRUSTBank CTBC (China Trust) Indonesia BANK_MAYBANKBank Maybank Indocorp
BANK_MERINBank Merincorp BANK_AGRISBank Agris
BANK_YUDHABank Yudha Bhakti DOMPETKUIndosat Dompetku
BPR_KSBPR KS FAMABank Fama Internasional
SUPERSuperbank CENTRATAMACentratama Nasional Bank
INDEX_SELINDOBank Index Selindo MAYORABank Mayora Indonesia
BTPN_SYARIAHBank Purba Danarta ARTOSBank Artos IND
BCA_SYRBank BCA Syariah BANK_ANGLOMASAnglomas Internasional Bank
BANK_LIMANLiman International Bank BANK_AKITABank Akita
OCBCBank OCBC NISP BANK_PERSYBank Persyarikatan Indonesia
PRIMA_MASTERPrima Master Bank BANK_HARFABank Harfa
BANK_INABank Ina Perdana MEGA_SYRBank Syariah Mega
NATIONALNOBUBank Alfindo (Bank National Nobu) ROYALBank Royal Indonesia
AGRONIAGABank BRI Agro BUMIPUTERABank MNC / Bank Bumiputera
BINTANGBank Bintang Manunggal JASA_JAKARTABank Jasa Jakarta
SRI_PARTHABank Sri Partha MANDIRI_SYRBank Syariah Mandiri (BSI)
BUKOPINBank Bukopin MEGABank Mega
BJB_SYRBank BJB Syariah BANK_SWAGUNABank Swaguna
JENIUSJENIUS BANK_HIMBank Himpunan Saudara 1906
BTNBank Tabungan Negara (BTN) BTN_UUSBank Tabungan Negara (BTN) UUS
BTN_SYRBank Tabungan Negara (BTN) Syariah QNB_INDONESIABank QNB Kesawan (Bank QNB Indonesia)
BANK_HARMBank Harmoni International ICBCHalim Indonesia Bank (Bank ICBC Indonesia)
CCBBank Windu Kentjana GANESHABank Ganesha
BANK_HAGAKITABank Hagakita MASPIONBank Maspion Indonesia
SINARMAS_UUSBank Sinarmas UUS SHINHANBank Metro Express (Bank Shinhan Indonesia)
MESTIKA_DHARMABank Mestika Dharma BANK_OF_INDIABank of India Indonesia
BANK_SULTRABank Sultra SULAWESIBank Sulawesi Tengah
PAPUABank Papua MALUKUBank Maluku Malut
BANK_NTTBank NTT BALIBPD Bali
BPD_KALTENGBank Kalteng LAMPUNGBank Lampung
JAMBIBPD Jambi BANK_JATIMBank Jatim
BANK_JATIM_UUSBank Jatim UUS BANK_JATIM_SYRBank Jatim Syariah
BANK_JATENGBank Jateng DAERAH_ISTIMEWABPD DIY
DKIBank DKI DKI_UUSBank DKI UUS
DKI_SYRBank DKI SYR BANK_JABARBank Jabar dan Banten (BJB)
MAYAPADABank Mayapada JTRUSTBank JTRUST
BANK_IFIBank IFI BANK_HAGABank Haga
BANK_ANTARBank Antar Daerah BANK_EKONOMIBank Ekonomi
BUMI_ARTABank Bumi Arta BOCBank OF China
BANK_WOORBank Woori Indonesia DEUTSCHEDeutsche Bank AG.
BANK_ANZBank ANZ Indonesia BANK_DANAMONKorea Exchange Bank Danamon
BANK_KEBDKorea Exchange Bank Danamon BNP_PARIBASBank BNP Paribas Indonesia
CAPITALBank Capital Indonesia BANK_KEPPELBank Keppel Tatlee Buana
BANK_ABNBank ABN Amro STANDARD_CHARTEREDStandard Chartered Bank
MIZUHOBank Mizuho Indonesia RESONABank Resona Perdania
DBSBank DBS Indonesia MITSUIBank Sumitomo Mitsui Indonesia
BANK_TOKYOThe Bank of Tokyo Mitsubishi UFJ LTD HSBCThe Hongkong & Shanghai B.C. (Bank HSBC)
HSBC_UUSThe Hongkong & Shanghai B.C. (HSBC UUS) HSBC_SYRThe Hongkong & Shanghai B.C. (HSBC Syariah)
BANK_COMPThe Bangkok Bank Comp. LTD BANK_C_AGRBank Credit Agricole Indosuez
ARTHABank Artha Graha Internasional BANK_INGING Indonesia Bank
BAMLBank of America, N.A JPMORGANJP. Morgan Chase Bank, N.A
CITIBANKCitibank NISPBank OCBC NISP
BANK_LIPPOBank Lippo BANK_BUANABANK BUANA IND
CIMB_UUSBank CIMB UUS CIMB_SYRBank CIMB Syariah
PANINBank Panin BCABank BCA
DANAMONBank Danamon DANAMON_UUSBank Danamon UUS
DANAMON_SYRBank Danamon SYR EXIMBANKBank Ekspor Indonesia
BNCBank BNC ACEH_SYRBank Aceh Syariah
AMARBank Amar Indonesia COMMBank Commonwealth
IBKIBK Bank Indonesia HANAPT Bank KEB Hana Indonesia
MUAMALATPT Bank Muamalat Indonesia OKEPT Bank Oke Indonesia Tbk
BANTENBank Pembangunan Daerah Banten KALSELBank Pembangunan Daerah Kalsel
NAGARIBank Nagari SUMUTPencapaian Bank Sumut
SULSELBARBANK SULSELBAR ALADIN_SYARIAHBANK ALADIN SYARIAH
SEABANKBANK SEABANK INDONESIA NEO_COMBank Neo Commerce
BENG_KULUPT Bank Bengkulu UOBBANK UOB INDONESIA
RABORABOBANK INTERNASIONAL INDONESIA BPD_KAITIMBPD KALTIM
BPD_NTBBPD NTB BANK_SWADESIBANK SWADESI
BTPNBANK TABUNGAN PENSIUNAN NASIONAL BANK_NOBUBANK NOBU
BANK_EKSEKBANK EKSEKUTIF BNI_SYRBANK BNI SYARIAH
PANIN_SYRBANK PANIN DUBAI SYARIAH BRI_SYRBANK BRI SYARIAH
SUMSEL_DAN_BABELBANK SULUT BPD_SULSELBPD SULSEL
BANK_MITRANBANK MITRANIAGA BANK_FINCONESIABANK FINCONESIA
PERMATA_SYRBANK PERMATA SYARIAH JAMBI_SYRBANK JAMBI SYARIAH
JAMBI_UUSBPD Jambi UUS BPD_ACEHBPD ACEH
BANK_RIAUBank Riau (BPD Riau Kepri) RIAU_SYRBANK RIAU SYARIAH
BANK_KALBARBANK KALBAR BANK_KESAWANBANK KESAWAN
BUKOPIN_SYRBANK SYARIAH BUKOPIN MNCBank MNC Internasional
OCBC_UUSBank OCBC NISP UUS OCBC_SYRBank OCBC NISP Syariah
PERMATA_UUSBank Permata UUS MAYBANK_SYRBank Maybank Syariah Indonesia
ANDARABank Andara MUTIARABank Mutiara / Jtrust
WINDUBank Windu Kentjana Int MITRA_NIAGABank Mitra Niaga
BENGKULUBPD Bengkulu RAYABank Rakyat Indonesia Agroniaga (Bank Raya)
SULSELBAR_UUSBPD Sulselbar UUS SULSELBAR_SYRBPD Sulselbar Syariah
BPD_DIY_SYRBank Pembangunan Daerah (BPD DIY) Syariah RABOBANKBank Rabobank International Indonesia
VICTORIA_SYRBank Victoria Syariah MANTAPBANK MANTAP (Mandiri Taspen)
SUMUT_UUSBPD Sumut UUS SUMUT_SYRBPD Sumut Syariah
ALADINBank Aladin Syariah BIBank Indonesia (KPO)
JAGO_UUSBank Jago UUS JAGO_SYRBank Jago Syariah
EKABPR Eka SINARMAS_SYRSinarmas Syariah
SCOTLANDRoyal Bank Scotland KSEIKustodian Sentral Efek Indonesia
ACEH_UUSBPD Aceh UUS JAWA_BARATBank Jawa Barat dan Banten Tbk
BANK_SYARBank Syariah Indonesia BANK_DIPOBANK DIPO INTERNATIONAL
BANGKOKTHE BANGKOK BANK COMP. LTD BANK_UIBUIB
BANK_ASIABANK CENTRAL ASIA BANK_JAGOBANK JAGO
BANK_NEGARABANK NEGARA INDONESIA BANK_CHIDJABANK OF CHINA (HONG KONG) LIMITED CABANG JAKARTA
JAWA_TIMURBANK PEMBANGUNAN DAERAH JAWA TIMUR NUSA_TENGGARA_TIMURBANK PEMBANGUNAN DAERAH NUSA TENGGARA TIMUR
SINARMASBANK SINARMAS JATIM_UUSBPD JATIM UUS
JAWA_TENGAHBPD JAWA TENGAH SULAWESI_TENGGARABPD SULAWESI TENGGARA
SUMATERA_UTARABPD SUMATERA UTARA SUMATERA_UTARA_UUSBPD SUMATERA UTARA UUS
BANK_MUFGMUFG BANK ALLOPT ALLO BANK INDONESIA
DIY_UUSPT BANK BPD DIY UUS MAYBANK_TBKPT BANK MAYBANK INDONESIA TBK
MAYBANK_TBK_UUSPT BANK MAYBANK INDONESIA TBK UUS NAGARI_UUSBANK NAGARI UUS
NAGARI_SYRBANK NAGARI SYR KALBAR_UUSPT BANK PEMBANGUNAN DAERAH KALBAR UUS
SUMSEL_BABELPT BANK PEMBANGUNAN DAERAH SUMSEL DAN BABEL BANK_ALLOAllo Bank
BANK_AMARAmar Bank BCADBCA Digital
BANK_OKOK! Bank ARTAJASAArtajasa
FINNETFinnet NANO_SYRNanobank Syariah
BANK_SULTENGBank Sulteng BANK_BANTENBank Banten

代付异步通知接口

接入方式: POST表单(application/x-www-form-urlencoded)

接入URL: 下单参数的asyncUrl值

参数信息
参数 参数名 必填 签名 说明
timestamp 时间戳 请求时间,格式为 yyyyMMddHHmmss
orderNo 平台订单号 平台订单号
merchno 商户号 商户号,由商户系统分配
orderId 商户订单号 商户订单号
amount 金额 保留两位小数
tradeType 交易类型 1:钱包;2:银行;
account 收款账户名 银行卡持有人名字
cardNo 银行卡号 银行卡号
bankName 银行编码 详见银行列表
depositBank 开户支行 开户支行
cashType 下发类型(下发通道) 7:印尼盾
requestCurrency 请求货币 7:印尼盾
apiVersion 接口版本号 接口版本号
attach 备注 通知过程中会原样返回 ; 若不为空,需参与签名
sign 签名 采用MD5签名
status 订单状态 订单状态
响应协议参数
商户系统收到异步通知后,需返回 success (小写)
若返回结果 非 success ,会重复多次发送支付结果
订单状态
  • 已受理: 0

  • 成功: 1

  • 失败: 2

代付查询接口 支持 https

接入方式: POST表单(application/x-www-form-urlencoded)

接入URL: https://www.xxxxxxxx.com/api/cash/queryCash

参数信息
参数 参数名 必填 签名 说明
merchno 商户号 商户号,由商户系统分配
orderId 商户订单号 商户系统订单号
timestamp 时间戳 请求时间,格式为 yyyyMMddHHmmss
apiVersion 接口版本号 固定值: 2
sign 签名 采用MD5签名
响应协议参数 响应格式为json
参数 参数名 必填 签名 说明
sign 签名 采用MD5签名
responseContent 主体信息内容 主体信息内容
参数 参数名 必填 签名 说明
code 状态码 详见响应状态码
msg 状态描述 状态描述
timestamp 时间戳 请求格式:yyyyMMddHHmmss
merchno 商户号 商户号,由商户系统分配
orderId 商户订单号 商户订单号
orderNo 平台订单号 平台订单号(下单失败,则为空)
amount 订单金额 保留两位小数
account 收款账户名 银行卡持有人名字
tradeType 交易类型 1:对私;2:对公;(目前只支持对私交易)
cardNo 银行卡号 银行卡号
bankName 银行编码 银行编码
depositBank 开户支行 开户支行
requestCurrency 请求货币 7:印尼盾
attach 备注 下单中attach值原样返回;若不为空,需参与签名
status 订单状态 订单状态
响应样例

									
状态码
编码说明 编码值 编码说明 类型编码 编码说明 编码值
成功 0 系统错误 500 参数不能为空 550
无效参数 551 非法参数 552 不支持的参数 553
不存在的商户 560 商户已禁用 561 尚未初始化公钥 562
ip受限 563 签名错误 564 订单号重复 565
金额小于最低限制 566 金额大于最高限制 567 交易类型不支持 568
通道维护 569 余额不足 570 不存在的订单 580
订单状态
  • 已受理: 0

  • 成功: 1

  • 失败: 2

DEMO下载

下单DEMO: java demo     php demo

代付DEMO: java demo