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
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 | |
orderAmount | string | R | Y | transaction amount,
| |
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, |
orderFee | string | Y | transaction fee, unit in cents (i.e. 100 = $1) |
payModel | string | Y | DIRECT |
orderStatus | string | Y | PENDING |
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 about 1 month ago