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":""
}
Updated 3 months ago