/public.rsa

Incoming parameters on payment page

Field NameDescriptionRequired
invoiceIdOrder id in storeYes
backLinkLink to redirect a customer back to the store after a successful transactionYes
failureBackLinkLink to redirect a customer back to the store after an unsuccessful transactionNo
postLinkLink to send authorization status back to the storeYes
failurePostLinkLink to send authorization status back to the store after an unsuccessful transactionNo
languageServer's language information is sent in this field "rus, kaz, eng"No
descriptionInformation about the goods or services that are being paid forYes
accountIdPersonal client id in merchant's systemNo
terminalIdTerminal id for paymentsYes
amountTransaction AmountYes
currencyTransaction currencyYes
cardSaveParameter to determine if the card needs to be saved. True for yes, False for no.Yes
tokenAuthorization TokenYes

Cryptogram structure is sent in a form of JSON.

{
	hpan       string
	expDate    string
	cvc        string
	terminalId string
}

POST URL /payment/cryptopay

Request
{
	"amount":100,
	"currency":"KZT",
	"name":"ALEXANDR PARKHOMCHIK",
	"сryptogram": "UhYXAhYGeFA6srEVJ2V8Jtnnz6NzRwy8QDkCvEmJOcC6KyBP/Ce4SUM0A0My1zS1Iiur6AF0ajJwdi31EvrkRDBvzl2iLVKzvuAyusc5KuGpgxRhc6WXDhKkHV7J5Oew8uPMOfVbmXZ+Ypihos5ynSX7TnqQg1ImAmEISBxT+YU7jY68uxGhlehYMJ0lgS1Req4Z0BwCExBL2lwo05lmSMed69bEdBX552ue13zXjvTKIMrVj70hXIppXnxAE7haJfObuQzx2Ox+wM087kFPXfDX8Udlc6iRP2TxnRj7R1GnCTLvf3xlVU9ELzK+j91SPBQTvyEeyEvGMunjRch8lGXlogQreFSZmC5FUpfdfw6jYhl6lizUZYZzroN6/i5MILtV0US8zPFZTfozrCj8cvqw+J2W7yBywDiFoZG1teLDMIKIqTvkrmRL++Ji0psdHXl0z0ng/d0yTxzcBpPZ5V8VfNOexJJRZQUXBQqygAqqYninku/ls1NuTRMPeveyrgSMjQUVKU2W1izXdSreSdvaOio+1HJHNCZDwNn9yheTzbmuUsl5lhnsUGNT5gzMuYje8VfRYpsvG3Syz6nOijprG1wL3L/p5B/SZGrtaMMg/OdbD3mUWCSmat/V2v9RKHaeo5OHMnaVMTY5Tsqwa5JKBRP4ztRcjkjMRCBvS8c=",
	"invoiceId":"10101112",
	"description":"test",
	"accountId":"uuid000001",
	"email":"parkhomchik@gmail.com",
	"phone":"77472261170",
    "backLink": "https://testmerchant/order/1123",
    "failureBackLink": "https://testmerchant/order/1123/fail",
    "postLink": "https://testmerchant/order/1123",
    "failurePostLink":"https://testmerchant/order/1123/fail",
    "language": "rus",
    "cardSave": "false"
}

Non 3D

Response
Http code 200

Body
{
    "id": "7943816b-58a8-47f6-a11e-67b63c4228c7",
	"amount": 100,
	"currency": "KZT",
	"invoiceID": "938290483290",
	"accountID": "merchant_user",
	"phone": "77777777777",
	"email": "user@test.kz",
	"description":"",
	"reference":"894537489",
	"language":"rus"
}

3D

Response
Http code 200

Body
{
    "id": "7943816b-58a8-47f6-a11e-67b63c4228c7",
    "3D": {
        "PaReq": "eJxVUttu4jAQ/ZUo742DgULQ4CotpdByEwF6eQvOAFEggSRUtE+rfsh+A9pV1Uq7VX/B/aPaKfTyYOucmfHx8YzhaLOYa7cYJ34UVvWcYeoahjzy/HBa1YeD+kFZP2IwmMWINQf5OkYGbUwSd4qa71X1nt3HVeXqPK1PHHpCg1l+dHs84rlyszPVGWRpBrsLmNQ3KJA9lUoxn7lhysDlq+NmhxUKZvGwCGRHYYFxs8acRrd32rctWrQKZl4KfIQhdBfIGt32qSowLm6AZBHg0TpM4zuWt8pA9gTW8ZzN0nRZIQSX7p0RBGMjuAei4kC+rPTWCiVSZ+N7DEm/1LpqrobjktO6HNdaw/GNV+f2ZNCuAlEV4LkpMmrmLOmtpJlWpUArNAcki4O7UAZk3pTP+sCwVFfY3xLfAyC7HMsh7P3vGeBmGYWojgD5xOBhwpn4LV7FP7F9exBbTfzRxLN4kfjx7Zd4kfuDJv6Lrfgr15NKiUfpTp0D8vXak4YaA09lZ+3Lnj09871waEX3tU5wPUKPu5PuxJlTNZysSPnxZWNp3ixlhhQBomTIbu5k91Uk+vGF3gFtmOJF",
        "MD": "80348733-575C255E5C23BD5B",
        "TermURL": "http://10.0.20.25:10080/cgi-bin/cgi_link",
        "Action": "https://cardsecure.kkb.kz/CommerSafeACS/pa?id=XJtFfS2C2kh3VvBVc18INg"
    },
    "accountID": "uuid000001",
    "amount": 2,
    "currency": "KZT",
    "description": "Оплата в интернет магазине",
    "email": "parkhomchik@gmail.com",
    "invoiceID": "1553679706289",
    "language": "RU",
    "phone": "77472261170",
    "reference": ""
}

Payment confirmation

URL POST /payments/cards/confirmPayment

Body
{
    "ID": "7943816b-58a8-47f6-a11e-67b63c4228c7",
    "PaRes": "/ZUo742DgULQ4CotpdByEwF6eQvOAFEggSRUtE+rfsh+A9pV1Uq7VX/B/aPaKfTyYOucmfHx8YzhaLOYa7cYJ34UVvWcYeoahjzy/HBa1YeD+kFZP2IwmMWINQf5OkYGbUwSd4qa71X1nt3HVeXqPK1PHHpCg1l+dHs84rlyszPVGWRpBrsLmNQ3KJA9lUoxn7lhysDlq+NmhxUKZvGwCGRHYYFxs8acRrd32rctWrQKZl4KfIQhdBfIGt32qSowLm6AZBHg0TpM4zuWt8pA9gTW8ZzN0nRZIQSX7p0RBGMjuAei4kC+rPTWCiVSZ+N7DEm/1LpqrobjktO6HNdaw/GNV+f2ZNCuAlEV4LkpMmrmLOmtpJlWpUArNAcki4O7UAZk3pTP+sCwVFfY3xLfAyC7HMsh7P3vGeBmGYWojgD5xOBhwpn4LV7FP7F9exBbTfzRxLN4kfjx7Zd4kfuDJv6Lrfgr15NKiUfpTp0D8vXak4YaA09lZ+3Lnj09871waEX3tU5wPUKPu5PuxJlTNZ",
	"MD": "KHKLKSDJLKSJDLKSJDLKJL",
}

Response

Redirect Http code 200

Success https://epay.homebank.kz/payform/success.html Params amount currency invoiceID accountID description reference language cardid

Error https://epay.homebank.kz/payform/ invoiceID code message

RSA PUBLIC KEY

-----BEGIN RSA PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAqoATnGMtByQojuoYFKEx
vEqszShV2vk6chCJFx0/vmSHBqcCTazhJqBmYU9gyM/TjVWLsjFAbd4nvCxIGpqF
g3J7UJccfODKibyfSUSqGsAJE1MJh3EaJivkd85/FkZkv3zBeT/193NmakNs0+T+
PUMmSdAPSnfUWi2KSIp48mSA38CbMvOwndkKNEeqCoIQn/fApfZ8MWIEFVd3gpfs
Ve0zYhSjvTOHPD0/7TOdcQyArxLZY0yS7m32rUOibuO7EhGNQL/bC73ZbuS5nXhr
a03nNIW3FfSJUTJBjVWDZRoNk9gm4pOimAeb0IiqnmlTPOvkqHYsOEjQ8KJAFlGO
1igelk1+dA5ZiY6r0YExc1KnW7UsnGk6nr7cgOR2po/sa4kctiKLqlGA35ILmUBQ
Yb6iReCQkggXMOvmP6p+4wEt1B7V8UJxzFZcQZ5QSRIk3o3pVrfY0gksidl0Xt5m
ft+E6a77ZQKG4TOQS9Ly1mIJ2qqaWqCWglVMWFiFCx9dXTN0RMli1T0rs1gA2jsP
z2/HiyY8EUp6t4Ufc8VbJYG9vt24UTwYgu+qDEBjggm5YKVCxjCvhJWwh9LaL9Uu
K46Apgr5wgEyMIJZRO7RxkjKkJI29FAP3wEs9y+/3qsjH3chFzdX0/+6lA+9lePK
PX0Z5SPexWRiQp9bND4iZRcCAwEAAQ==
-----END RSA PUBLIC KEY-----