Pay in - API mode

Description

In some cases, The merchant might want to render the checkout page with customized requirements, such as adding the merchant's logo or changing style.

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	AES encryption	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			INTERNATIONAL_CARD_PAY
payModel	string	R	Y			either CREDIT_CARD or DEBIT_CARD
currency	string	R	Y			USD, EUR, GBP, JPY
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
cardNo	string	R	Y	Y		bank Card No.
cardType	string	R	Y			VISA, MASTERCARD, UPI, JCB
cardCcv	string	R	Y	Y		cvv
cardExpMonth	string	R	Y			format: mm
cardExpYear	string	R	Y			format: yyyy
firstName	string	R	Y		Y	card holder's first name
lastName	string	R	Y		Y	card holder's last name
phone	string	C	Y
address	string	C	Y
city	string	C	Y		Y
state	string	C	N			for USA and Canada, it is ISO 3166-1 alpha-2, for others countries please use full name, in case there is no state in your country, please use city name instead.
country	string	C	Y			country code with two letters defined in ISO 3166-1
email	string	R	Y
postcode	string	C	N
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 in case 3DS verification is triggered and 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}
expandField	string	O	N			NULL
version	string	O	N			NULL
validPeriod	string	O	N			NULL
merType	string	C	N			either 0 or 1, default value is 0. with value=1, phone, address, city, country, state, postCode is optional, with value=0, phone, address, city, country,state, postCode is necessary.

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	USD, EUR, GBP, JPY
orderAmount	long	Y	transaction amount, unit in cents (i.e. 100 = $1)
orderFee	long	Y	transaction fee, unit in cents (i.e. 100 = $1)
payModel	string	Y	either CREDIT_CARD or DEBIT_CARD
orderStatus	string	Y	transaction status, please refer to error code
webUrl	string	Y	redirect URL
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

{
  "lastName": "Kn**t",
  "cardExpMonth": "02",
  "cardCcv": "/K9Gj00mc/cY9h9sejgvPg==",
  "productDetail": "purchaseProduct",
  "cardType": "MASTERCARD",
  "sign": "DzBoYc2tGHPBCQR1/zSjE3z+s1kFNos8kGj/C5R4h9pd7eW4/YfWKSaKX1Kz9Csd78NMzqTtPzUpT7EIE83qpD0itrZsMvuefAECew9F7Q+4N3rj4NypdtZcviGGfHnrnzkxBSn6a9ShdoJA13VYL6yHKMlLDxK18lqocXcvHTg=",
  "payModel": "CREDIT_CARD",
  "language": "zh",
  "merchantOrderNo": "PAY202207272790784161",
  "cardNo": "XaOPEITl9+f4Vss6u1QPTK+6ks6BMCIdRAacA1iBD/Q=",
  "customParam": "1001799476114063361",
  "timeStamp": 1658889214901,
  "cardExpYear": "2028",
  "firstName": "Eva",
  "orderAmount": "10000",
  "payType": "INTERNATIONAL_CARD_PAY",
  "userIp": "120.246.11.66",
  "currency": "USD",
  "callbackUrl": "https://apiuat.alchemypay.org/pay/callback/yyh",
  "noticeUrl": "https://rampuat.alchemypay.org/paymentResult",
  "merType": "1",
  "email": "li***[email protected]",
  "merchantNo": "AC202237083"
}

Response sample

{
   "meta":{
      "success":true,
      "code":"0000",
      "message":"Request Success"
   },
   "data":{
       "merchantNo":"AC202237083",
       "merchantOrderNo":"PAY202207272790784161",
       "orderNo":"R08OC0220727012238117504288178",
       "currency":"USD",
       "orderAmount":12100,
       "orderFee":221,
       "payModel":"CREDIT_CARD",
       "orderStatus":"WAIT3D",
       "webUrl":"https://api-gw.sparkpsp.com/v1/Company3dRequest?order_no=R08CH02207270122381906777110710144&type=PL&return_url=https://payment.alchemytech.cc/nh-gateway/toPageResult/R08CH022072701223819067771107&notify_url=https://payment.alchemytech.cc/nh-gateway/spark/callBack",
       "page":null,
       "orderTime":1658827358118,
       "finishTime":0,
       "sign":"RssFfOMWFTX1+CH0sDhhjFhdafTPtAK+/NtdKo9M4oE/eazrSb3rWcXBeEI/J7cSk6COc80/yrbKs7zWt4UAFeYc+4/D05VBEGdEqjPdzF0KUTvm6i339zwroopNdMpWwGLia0wnBjzCXnSVspd+yLNVy8P6dV+X3a65HSzkqs2GNiLp2InRJcSbQXn201bJ9RehO21HscrLBgMO+qPr6n8b9rpt5LPJVrcQZbcuiiaV/23Cg64Zy9WBgF5i3sxG8HPw1PvOYjhBVgblli3etaJt3V7bag1kNIzPaH6PmJwTA5UlZpz2OyyabYOY9BbIjUvRdmSwI+LX8QFUodG10C9FQB/KavFRcY1MiYlSjq1/21/JniX9y54c+GGgw9EirdO4Hv2K+XI66JAOUa7t3enUqO9zWB3fKqr0IcFQiwX8yiyc+oJyNbXx26UIJ+kEK3qVMMMHtnTyZewq5NXQiO+SKGFL2OKfRu0xaP2gh48011GOrRc6Jgy8qGtkmBizS2CdZjEdIBcxtwwAmi8aoDz2AGM2bLw27IN5T5TPH/mbZzs5jnbF5t/qFxDn6p8vW6Yofn6wvEAP+fMrl978DN2N5zlqfYzMN0SyJjQArj/Ygva+IIXsOExPMIRhj2sjJpfZuMg2zX6S7ooc4UuO214L/4lVnSe7jfyEZuCIf5I=",
       "remark":""
   }
}