Pay in

Description

Alchemy Pay only provides local payment methods via API integration mode. Merchants will need to set up the rendering checkout page for each local payment method based on their unique feature.

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

Element

Data Type

Required

Signed

URL encode

Remarks

merchantNo

string

R

Y

merchant unique ID, once a merchant has been on-boarded with Alchemy Pay, the merchant will be provided with the credentials

timeStamp

string

R

Y

GMT time with 13 digit to represent time in milliseconds

language

string

O

N

en

sign

string

R

N

signature with RsaUtil.sign method

merchantOrderNo

string

R

Y

merchant defined transaction ID, must be unique for each request.

payType

string

R

Y

INDONESIA_PAY

payModel

string

R

Y

DIRECT
OVO
DANA
QRIS

orderAmount

string

R

Y

transaction amount,

unit in cents (i.e. 100 = $1

productDetail

string

R

Y

Y

goods name, can't contain special characters

payBankCode

string

C

bank list with CIMB Niaga, BCA, BNC, BRI, Permata Bank, BNI in case payModel=DIRECT,

phone

string

C

Y

end 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

lastName

string

R

Y

Y

dummy name

userIp

string

R

N

user's IP

userAgent

string

O

N

userAgent of explorer: Mozilla/5.0 Macintosh, Intel Mac OS X

callbackUrl

string

R

Y

webhook URL

noticeUrl

string

O

N

redirect URL after payment succeed. for example: https://www.alchemypay.org

customParam

string

O

N

customized data with maximum 500 characters after redirect to noticeUrl, for example: https://www.alchemypay.org?customParam={customParam}

Http response

Element

Data Type

Signed

Remarks

merchantNo

string

Y

merchant unique ID, once a merchant has been on-boarded with Alchemy Pay, the merchant will be provided with the credentials

merchantOrderNo

string

Y

merchant defined transaction ID, must be unique for each request

orderNo

string

Y

Alchemy Pay defined transaction ID

currency

string

Y

IDR

orderAmount

long

Y

transaction amount,
unit in cents (i.e. 100 = $1)

orderFee

string

Y

transaction fee, unit in cents (i.e. 100 = $1)

payModel

string

Y

DIRECT
OVO
DANA
QRIS

orderStatus

string

Y

PENDING
SUCCESS
FAIL
CANCEL

webUrl

string

Y

for 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

page

string

N

NULL

orderTime

long

N

timestamp

finishTime

long

N

0

remark

string

N

error description from payment gateway

sign

string

Y

signature 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":""
      }