Description

For local payment worldwide, Alchemy Pay provide API integration mode only, merchant need to set up the rendering checkout page for each local payment method based on their unique feature. Generally there are three kinds of payment methods:

  • Bank Transfers
  • H5 page
  • QR code

Each method requires a certain set of the fields especially payModel you can find below:

Request URL

https://payment.alchemytech.cc/nh-gateway/card/payment

Http method

  • POST
  • Content-Type: application/x-www-form-urlencoded

Http request

ElementData TypeRequiredSignedURL encodeRemarks
merchantNostringRYmerchant unique ID, once a merchant has been on-boarded with Alchemy Pay, the merchant will be provided with the credentials
timeStampstringRYGMT time with 13 digit to represent time in milliseconds
languagestringONen
signstringRNsignature with RsaUtil.sign method
merchantOrderNostringRYmerchant defined transaction ID, must be unique for each request.
payTypestringRYINDONESIA_PAY
payModelstringRYDIRECT
OVO
DANA
QRIS
orderAmountstringRYtransaction amount,
## unit in cents (i.e. 100 = $1
productDetailstringRYYgoods name, can't contain special characters
payBankCodestringCbank list with CIMB Niaga, BCA, BNC, BRI, Permata Bank, BNI in case payModel=DIRECT,
phonestringCYend user's mobile number in case payModel=OVO, prefix is either with country code +62 e.g +62895**174 or domestic 0 e.g. 0895**174
lastNamestringRYYdummy name
userIpstringRNuser's IP
userAgentstringONuserAgent of explorer: Mozilla/5.0 Macintosh, Intel Mac OS X
callbackUrlstringRYwebhook URL
noticeUrlstringONredirect URL after payment succeed. for example: https://www.alchemypay.org
customParamstringONcustomized data with maximum 500 characters after redirect to noticeUrl, for example: https://www.alchemypay.org?customParam={customParam}

Http response

ElementData TypeSignedRemarks
merchantNostringYmerchant unique ID, once a merchant has been on-boarded with Alchemy Pay, the merchant will be provided with the credentials
merchantOrderNostringYmerchant defined transaction ID, must be unique for each request
orderNostringYAlchemy Pay defined transaction ID
currencystringYIDR
orderAmountlongYtransaction amount,
unit in cents (i.e. 100 = $1)
orderFeestringYtransaction fee, unit in cents (i.e. 100 = $1)
payModelstringYDIRECT
OVO
DANA
QRIS
orderStatusstringYPENDING
SUCCESS
FAIL
CANCEL
webUrlstringYfor DANA, it is a H5 page; for QRIS, please rendering the string to QR code; for OVO, it is a order ID coupled with mobile number; for DIRECT, it is a virtual account with amount set, end user just transfer fund into, in case amount unmatch, transaction will fail
pagestringNNULL
orderTimelongNtimestamp
finishTimelongN0
remarkstringNerror description from payment gateway
signstringYsignature with RsaUtil.sign method

Request sample - payModel: DIRECT

{
 "lastName": "san",
 "productDetail": "shoes",
 "sign": "T/CTpt9X9qKIhPhCqwhQQvDlrdW7fg4Gm/6BOQN7UkhWfdFai40Mvyc0hO/tijp0KDvHWosfQpgsurFu60Oy/2ykgZjhOgcJT3cemRqwt9PfU4L6ec9HK1IHigRScXAebwPSZNGywGRFhnCU2APXCNNr2Fnt0jkwPqzRp7tXn68=",
 "payModel": "DIRECT",
 "payBankCode": "M1",
 "merchantOrderNo": "TEST202208031002",
 "customParam": "orderNo=123",
 "timeStamp": 1659489931182,
 "orderAmount": "10000000",
 "payType": "INDONESIA_PAY",
 "userIp": "120.111.110.101",
 "callbackUrl": " https://test.bitstore/bitstore/index.html#/buyWaiting?orderNo=TEST202208031002",
 "noticeUrl": "https://test.bitstore/bitStore-gateway/trade",
 "merchantNo": "AC20223**83"
}

Response sample - payModel: DIRECT

{
 "meta": {
  "success": true,
  "code": "0000",
  "message": "Request Success"
 },
 "data": {
  "merchantNo": "AC20223**83",
  "merchantOrderNo": "TEST202208031002",
  "orderNo": "R08OC0220803172534191097625434",
  "currency": "IDR",
  "orderAmount": 10000000,
  "orderFee": 200000,
  "payModel": "DIRECT",
  "orderStatus": "PENDING",
  "webUrl": "8801714629036345",
  "page": null,
  "orderTime": 1659489934193,
  "finishTime": 0,
  "sign": "KSc8AScG/E+VUeBw04b3hBqnyluUE/dAN7oi74a2N+GdE4ZZnHvtOi61xEf6uwfqIWIPwspjiWj77GHfmL2X/IaHvVJL9RCWVHHi7D6amn0ak56MauKyNZBXxwAmdmimj7ywCIV0ntnhD5pD6IxOPbhU47imQ98i/vM7b9J8iEEL0lv7ywPmwgB6mDEfYWpTWQBwf3BbT6uvICGN+h87enRR16tb3Oe7fox8ZHL+pteq97KVPhd6MGuZUftJELMb3+HJzV9MGrVdU7KyE7s2iMcLEUsSuhG7e8gk4xxUwzjhMSXMkD1yqL6sKcIQCQWzsCpTmaOIoi7cgCLG1EY31g==",
  "remark": ""
 }
}

Request sample - payModel: OVO

{
 "lastName": "san",
 "productDetail": "shoes",
 "sign": "krLvDfJetCmyJ3SPacl7QOq3F7teh13ob/6IZfqnAWTQmgb7DeCTZKw60sQolzyKx+PfsbQvIb76DFEFbsCuhmz/XNtAnKx8jcm6fNsEaZ3Tqh4aE8+RSWhhuR5UKhi4wLb3CR4tuXMq5W8fNXGmwzhlKHcLUq2MPShaYESRNSY=",
 "payModel": "OVO",
 "merchantOrderNo": "TEST202208031001",
 "customParam": "orderNo=123",
 "timeStamp": 1659489781775,
 "orderAmount": "10000000",
 "payType": "INDONESIA_PAY",
 "phone": "089**29362174",
 "userIp": "120.111.110.101",
 "callbackUrl": " https://test.bitstore/bitstore/index.html#/buyWaiting?orderNo=TEST202208031001",
 "noticeUrl": "https://test.bitstore/bitStore-gateway/trade",
 "merchantNo": "AC20223**83"
}

Response sample - payModel: OVO

{
 "meta": {
  "success": true,
  "code": "0000",
  "message": "Request Success"
 },
 "data": {
  "merchantNo": "AC20223**83",
  "merchantOrderNo": "TEST202208031001",
  "orderNo": "R08OC0220803172304381721447396",
  "currency": "IDR",
  "orderAmount": 10000000,
  "orderFee": 300000,
  "payModel": "OVO",
  "orderStatus": "PENDING",
  "webUrl": "LINKQU000105202208031623081486",
  "page": null,
  "orderTime": 1659489784383,
  "finishTime": 0,
  "sign": "SkyoRMMCuFf6lZ/UYcRZ5aC2oNg/nWn4T7HhadCq03v2EDW7uFF+0qIZDh12NkTf5/jTc9A34f00QAPHs/3+OKZT+Lg0Y5Hq4giM4dJlGckmv8EEyOH+vt0KP2+1vPCWaim6bBPnALmUt8fQKtOaUGvlGhJua3egERQD2++DKUSK/6+fkJpdKwVir80SjjAz4ji0BltRoxyRYXw4FR+S77CjQCmIRStMs8eTnjhZg+S12UyYfn+QN1JWDxJ4pMPXnatEWVVINsoIAPaDJFI7iy4oRP7X0Vkqx5EulC2TvnZq1QO8vyDwuUUVfOfyTjikJchmOvnNkzDPzoJ5pp1KLQ==",
  "remark": ""
 }
}

Request sample - payModel: DANA

{
 "lastName": "SAN",
 "productDetail": "BITS1553545356002856960",
 "sign": "Rx3qCKLVo7+SUk1qeNPfg6qwggGB90rA5zMQALXxL9WyiSRbDFTcM8Yd4i1eRvEWsYncA42AdUBQms55wSVQagAAoMMZn1rUIcarrz1snEr21Yz8AUYYFblt3Cp9S2kJKntKku/k+ORKA9v3hGkBqewyw3RuelMmt5DIKWhKuMw=",
 "payModel": "DANA",
 "userAgent": "e.g. Mozilla/5.0 (Macintosh Intel Mac OS X 10_15_5)",
 "merchantOrderNo": "BITS1553545356002856960",
 "customParam": "BUY1553544788421251072",
 "timeStamp": 1659200251006,
 "orderAmount": "20700000",
 "payType": "INDONESIA_PAY",
 "userIp": "114.10.7.232, 47.91.69.75",
 "callbackUrl": "https://app.bit.store/bitNotify/v1/trade",
 "noticeUrl": "https://web.bitstore/index.html#/buyWaiting?orderNo=BUY1553544788421251072",
 "merchantNo": "AC20225**66"
}

Response sample - payModel: DANA

{
   "meta":{
      "success":true,
      "code":"0000",
      "message":"Request Success"
   },
   "data":{
      "merchantNo":"AC20225**66",
      "merchantOrderNo":"BITS1553545356002856960",
      "orderNo":"R08OC0220731085732901220409556",
      "currency":"IDR",
      "orderAmount":20700000,
      "orderFee":928000,
      "payModel":"DANA",
      "orderStatus":"PENDING",
      "webUrl":"https://openapi.simfy.net/cash/html/DANA.html?type=DANA&orderNum=PRE61553545367595913216",
      "page":null,
      "orderTime":1659200252902,
      "finishTime":0,
      "sign":"oDVPd2MK+//fyCA3VJapegXor+8/+hv9hj0yPk6MkNkSqdcs0hKqCfumNq7nDgShsSPygNkxWZ8znZVJLU6GPx82Hzyn02c9cCIXJ094TM3A5IJ2setE25mB9MvxdOBPzUrGdqMOGZrF8hJSTqEe6+lmFIof2kaGDTCjGh0JSbLQuJGU1j/iVz/BKsq/6p0GRU6DRCpACGJEP//ydDdd2Lxemy0QZTeFze7xs+urBFAax73UzeKLuKG7XMPBYRBvA22y1tmU8jExTk59DsPD5dNnF+aopdNRTxkVi4NNJqGeDwh2CivJh1FoGkpp/rpKTwPUVSIAhLpcJrG4SRB2IV1fQiBF6OHqA7cfMD4tUjHjq5cDk+W0XZZnyA5D3rNIGAVfUyTiUk8kj4anSAB1ySOriwKP2hRpUpJDmtgxu3aHgDfv2ZtngYyo5iy9MQm8Z7nsuwQNH0Qrt1lD/lz4tX4ri7KLlxNNbgK6P6hRVWMDiwBAjx7sX58rUWEcLscN",
      "remark":""
   }
}

Request sample - payModel: QRIS

{
   "callbackUrl":"https://api.alchemypay.org/pay/callback/yyh",
   "customParam":"1004238825424105473",
   "lastName":"Bush",
   "merchantNo":"AC20223**83",
   "merchantOrderNo":"1004238825424105473-1944",
   "noticeUrl":"https://ramp.alchemypay.org/paymentResult",
   "orderAmount":"300000000",
   "payModel":"QRIS",
   "payType":"INDONESIA_PAY",
   "productDetail":"purchaseProduct",
   "timeStamp":1659470796585,
   "userIp":"120.246.11.66",
   
}

Response sample - payModel: QRIS

{
   {
      "meta":{
         "success":true,
         "code":"0000",
         "message":"Request Success"
      },
      "data":{
         "merchantNo":"AC20223**83",
         "merchantOrderNo":"PAY202208038441472647",
         "orderNo":"R08OC0220803120637878997379713",
         "currency":"IDR",
         "orderAmount":300000000,
         "orderFee":9000000,
         "payModel":"QRIS",
         "orderStatus":"PENDING",
         "webUrl":"00020101021226640017ID.CO.DANAMON.WWW0118936000110000105785021010317452530303UBE51440014ID.CO.QRIS.WWW0215ID20210950325990303UBE626901090007690150518QRIS155468011563870709LI524PJTL9917000200010710127795303360540730000006008SIDOARJO520459995906LinkQu5802ID610561253630480DE",
         "page":null,
         "orderTime":1659470797879,
         "finishTime":0,
         "sign":"OdG9dvuXNV5kTobt4vebcYM07ziNNwSwEvJzZ4YlO/r9FbHcN1OJBN9vHZvGjlircyoln9QYJopcbOvzVHjP3SIV84a0dPOcsxFLoGU5Cq8kGRuzqe8Pm5ax0h+LKlrZXuIXEZDe47umMgOhEfu8q4oASmy67hkMh8/MpeX5hXprf2oAfwkC5Se2E99Freg5oGB7dze60VtYpm/8FHsMiT4e6jJU7K5DxCBBAF0r6OcTl7pHBR0lS2tADZA4egg9lY7nVHff9OJPw5ELWM+BSg3LZE0llbdS7/KnM3rcmQ0jlvA6brcGhlQ+ygMlhBRg7bDq6FDI/W8mgKqUlcT9h35rKptiEn5Qiky/LPgyAN1zk39OMRthtlO2z2Lbjk3ocGpdoEufwhEVaSEORm2lmZr2LX2Wo30G2AShmv7msBZYWejXa+OIvqxJXr+g0WJ7ovXmvwdyECN3gU1yPG8idFc5aSJaQImMj5PhV7h0EHnqDvN8GurBe0lHeYhoTqGyUFo+3xX+8jht4gJNAvESTFB90J+02Ni9fPh9qONstrNQ3UOPeQj83yHnaYf6Sjl5pc4YRvJvqvBxWJ92PiRnhRHdMBCywArhbJLzTVLrcOxZyRSYgSsvg+5pK7ZyPwB2Lr1G+bYgkiTRF4fiEmSN/j5tSU3fHcKoE1YVn0thfvE=",
         "remark":""
      }